提交 1b81beb3 编写于 作者: 李少辉-开发者's avatar 李少辉-开发者 🎧

add update readme.md

Signed-off-by: 李少辉-开发者's avatarlish <lish@csdn.net>
上级 a6946927
......@@ -2,7 +2,8 @@
### 更新记录:
**0.1.2(2021-04-13)**
支持托管项目到组织下。
支持托管项目到组织下;
支持免密导入 code 平台项目,完善插件的项目协作能力。
**0.1.1(2021-04-13)**
修复部分托管异常的 bug。
......@@ -14,7 +15,7 @@
#### 版本要求:
HBuilder 版本需大于 3.1.10
HBuilder 版本需大于 3.1.17
#### 安装:
......@@ -29,17 +30,40 @@ codechina-workflow
插件开发者:
csdn codechina 研发团队
插件用途:
HBuilder 创建的项目支持直接托管到 Code China(*后面 Code China 简称为 code。*),项目完成托管以后,可以直接在 code 完成项目的版本发布、合并请求、问题反馈等管理
**插件用途:**
HBuilder 创建的项目支持直接托管到 Code China(*后面 Code China 简称为 code。*),HBuilder 编辑器 + codechina-workflow 插件 + code 平台一起相结合完成用户的项目协作开发
使用方法:
3.1.14 及以上版本已经默认接入了 codechina-workflow 插件,在新建项目时可以选择勾选 **上传到Git代码托管平台**,此操作会在编辑器创建好项目之后,将项目同步到 code 平台;
**实现项目托管:**
将项目托管到 code 有两种方式,一种是在新建项目时可以选择勾选 **上传到Git代码托管平台**,此操作会在编辑器创建好项目之后,将项目同步到 code 平台;
![项目创建](https://codechina.csdn.net/codechina_dev/codechina-hbuilder-plugin/uploads/060964941974d15ba9e2acdba5bc7d5c/project_create.png)
除创建项目可以启用托管功能外,您还可以在编辑器菜单栏内,右键点击项目名称,选择 **托管当前项目**功能,托管已经存在的项目。
另一种是可以在编辑器菜单栏,右键点击项目名称,选择 **托管当前项目**功能,托管已经存在的项目。
![右键托管](https://codechina.csdn.net/codechina_dev/codechina-hbuilder-plugin/uploads/027dae7f583d5f1992838cfdedebc678/create.png)
![右键托管](https://codechina.csdn.net/codechina_dev/codechina-hbuilder-plugin/uploads/027dae7f583d5f1992838cfdedebc678/create.png)
进入项目托管流程中,您需要根据弹窗的提示填写项目在 code 平台托管上的基本信息,您既可以选择将想托管到个人名下生成个人项目,又可以托管到您具有创建项目权限的组织下生成组织项目,其中组织项目多用于团队协作,当您需要新增一个组织来实现托管时,您可以直接点击弹窗中的创建链接,直接新增一个组织。
![组织项目](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/d5a3a55d-8667-43d7-8ba6-0df6db5e6a04.png)
点击弹窗中的创建按钮后,您输入的项目信息和本地的代码仓库将由本插件一并推送到 code 平台,在项目新增成功后,编辑器将返回创建结果和项目在 code 平台的页面地址以及为项目添加协作成员的快捷入口。
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/a548d114-bddc-49f2-9d14-5686a9ca9992.png)
如该项目有团队协作的需求时,您可以在该项目的项目成员设置页面为项目添加协作者,为避免不同平台用户在项目协作中产生的账户一致性问题,我们推荐采用邀请链接的方式邀请协作用户。
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/b3545aab-9c4f-45c3-9597-40b9fc854ac3.png)
**导入 code 平台项目:**
codechina-workflow 插件针对项目导入场景与 Hbuilder 编辑器官方进行了深入合作并做到了账户互通,支持了 http 方式免密直接导入功能(ssh 方式走单独的 ssh 协议,需配合配置用户密钥使用),当您在导入项目时填写的是 code 平台项目的 http clone 地址时,将自动选择使用本插件完成用户项目权限校验。
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/459d6f4d-3ef9-4268-9fb9-ca62c68b9ce4.png)
点击导入后,您可根据弹窗提示配置导入过程中的信息,如分支、LFS 等。
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/801f0b47-af01-463f-881e-f61fb59247cc.png)
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/69b7feae-8e16-401c-b880-02644a8c8215.png)
#### 常见问题:
......@@ -55,11 +79,17 @@ HBuilder 创建的项目支持直接托管到 Code China(*后面 Code China 简
4、如何多平台托管:
如果项目未在其他平台托管,则默认将项目仓库 remote 命名为 origin,如果 origin 已经被占用,插件将采用 codechina 命名仓库 remote url。
5、项目协作中,通过 git 方式导入项目时,提示没有权限是怎么回事?
出现该问题有两种可能:第一是项目管理者未邀请用户成为项目协作者或邀请时赋予协作者的权限较低;第二时编辑器中登陆用户与 code 平台中项目协作者的用户不一致。
其中第一种情况需要项目管理者根据实际项目协作需求确认是否正确赋予用户协作权限,如需修改用户权限,可直接在 code 平台对应项目的项目成员设置页面直接对协作者用户权限进行编辑;第二种情况需要用户自行确认加入项目协作时的登陆账号是否为 hbuilder 第三方登陆,并且该账号与编辑器中的登陆账号是否一致。
其他问题,您可在插件官方托管地址进行反馈: [反馈地址](https://codechina.csdn.net/codechina_dev/codechina-hbuilder-plugin/-/issues)
#### 注意事项:
我们在 code 自动为用户创建了 access_token,并根据 access_token 采用 oauth2 的方式设置了项目仓库的 remote,为了保证您能够正常推送和获取代码,请勿删除个人设置中的 hbuilder 访问令牌。
1、CSDN 用户中心已支持 HBuilder 的第三方登陆,为避免不同平台账户在使用过程中产生的账号不一致问题,要求用户在使用 code 平台时采用 HBuilder 三方登陆的形式完成账号校验;
2、Code 平台自动为用户创建了访问令牌,并根据访问令牌 + oauth2 的方式设置了项目仓库的 remote,为了保证您能够正常推送和获取代码,请勿删除个人设置中的 hbuilder 访问令牌。
### 隐私、权限声明:
......
#### 版本要求:
HBuilder 版本需大于 3.1.10
HBuilder 版本需大于 3.1.16
#### 安装:
1、使用编辑器创建项目时,如果勾选了“项目托管”,编辑器将自动安装插件;
1、使用编辑器创建项目时,如果勾选了“项目托管”,编辑器将自动安装插件;
2、您可以在插件市场直接搜索“codechina-workflow”下载,并解压缩到 plugins 目录下完成手动安装。
#### 介绍:
......@@ -15,17 +15,40 @@ codechina-workflow
插件开发者:
csdn codechina 研发团队
插件用途:
HBuilder 创建的项目支持直接托管到 Code China(*后面 Code China 简称为 code。*),项目完成托管以后,可以直接在 code 完成项目的版本发布、合并请求、问题反馈等管理
**插件用途:**
HBuilder 创建的项目支持直接托管到 Code China(*后面 Code China 简称为 code。*),HBuilder 编辑器 + codechina-workflow 插件 + code 平台一起相结合完成用户的项目协作开发
使用方法:
3.1.14 及以上版本已经默认接入了 codechina-workflow 插件,在新建项目时可以选择勾选 **上传到Git代码托管平台**,此操作会在编辑器创建好项目之后,将项目同步到 code 平台;
**实现项目托管:**
将项目托管到 code 有两种方式,一种是在新建项目时可以选择勾选 **上传到Git代码托管平台**,此操作会在编辑器创建好项目之后,将项目同步到 code 平台;
![项目创建](https://img-cdn-tc.dcloud.net.cn/uploads/questions/20210429/14bdcd7e2912ac71e44546f7d7f58a55.png)
![项目创建](https://codechina.csdn.net/codechina_dev/codechina-hbuilder-plugin/uploads/060964941974d15ba9e2acdba5bc7d5c/project_create.png)
除创建项目可以启用托管功能外,您还可以在编辑器菜单栏内,右键点击项目名称,选择 **托管当前项目**功能,托管已经存在的项目。
另一种是可以在编辑器菜单栏,右键点击项目名称,选择 **托管当前项目**功能,托管已经存在的项目。
![右键托管](https://img-cdn-tc.dcloud.net.cn/uploads/questions/20210429/058ee94eeb4f50275399a54fb9c10ef9.png)
![右键托管](https://codechina.csdn.net/codechina_dev/codechina-hbuilder-plugin/uploads/027dae7f583d5f1992838cfdedebc678/create.png)
进入项目托管流程中,您需要根据弹窗的提示填写项目在 code 平台托管上的基本信息,您既可以选择将想托管到个人名下生成个人项目,又可以托管到您具有创建项目权限的组织下生成组织项目,其中组织项目多用于团队协作,当您需要新增一个组织来实现托管时,您可以直接点击弹窗中的创建链接,直接新增一个组织。
![组织项目](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/d5a3a55d-8667-43d7-8ba6-0df6db5e6a04.png)
点击弹窗中的创建按钮后,您输入的项目信息和本地的代码仓库将由本插件一并推送到 code 平台,在项目新增成功后,编辑器将返回创建结果和项目在 code 平台的页面地址以及为项目添加协作成员的快捷入口。
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/a548d114-bddc-49f2-9d14-5686a9ca9992.png)
如该项目有团队协作的需求时,您可以在该项目的项目成员设置页面为项目添加协作者,为避免不同平台用户在项目协作中产生的账户一致性问题,我们推荐采用邀请链接的方式邀请协作用户。
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/b3545aab-9c4f-45c3-9597-40b9fc854ac3.png)
**导入 code 平台项目:**
codechina-workflow 插件针对项目导入场景与 Hbuilder 编辑器官方进行了深入合作并做到了账户互通,支持了 http 方式免密直接导入功能(ssh 方式走单独的 ssh 协议,需配合配置用户密钥使用),当您在导入项目时填写的是 code 平台项目的 http clone 地址时,将自动选择使用本插件完成用户项目权限校验。
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/459d6f4d-3ef9-4268-9fb9-ca62c68b9ce4.png)
点击导入后,您可根据弹窗提示配置导入过程中的信息,如分支、LFS 等。
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/801f0b47-af01-463f-881e-f61fb59247cc.png)
![组织项目成功](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-0c538644-5496-44b8-8dbe-45ffaf51ab70/69b7feae-8e16-401c-b880-02644a8c8215.png)
#### 常见问题:
......@@ -41,8 +64,14 @@ HBuilder 创建的项目支持直接托管到 Code China(*后面 Code China 简
4、如何多平台托管:
如果项目未在其他平台托管,则默认将项目仓库 remote 命名为 origin,如果 origin 已经被占用,插件将采用 codechina 命名仓库 remote url。
5、项目协作中,通过 git 方式导入项目时,提示没有权限是怎么回事?
出现该问题有两种可能:第一是项目管理者未邀请用户成为项目协作者或邀请时赋予协作者的权限较低;第二时编辑器中登陆用户与 code 平台中项目协作者的用户不一致。
其中第一种情况需要项目管理者根据实际项目协作需求确认是否正确赋予用户协作权限,如需修改用户权限,可直接在 code 平台对应项目的项目成员设置页面直接对协作者用户权限进行编辑;第二种情况需要用户自行确认加入项目协作时的登陆账号是否为 hbuilder 第三方登陆,并且该账号与编辑器中的登陆账号是否一致。
其他问题,您可在插件官方托管地址进行反馈: [反馈地址](https://codechina.csdn.net/codechina_dev/codechina-hbuilder-plugin/-/issues)
#### 注意事项:
我们在 code 自动为用户创建了 access_token,并根据 access_token 采用 oauth2 的方式设置了项目仓库的 remote,为了保证您能够正常推送和获取代码,请勿删除个人设置中的 hbuilder 访问令牌。
\ No newline at end of file
1、CSDN 用户中心已支持 HBuilder 的第三方登陆,为避免不同平台账户在使用过程中产生的账号不一致问题,要求用户在使用 code 平台时采用 HBuilder 三方登陆的形式完成账号校验;
2、Code 平台自动为用户创建了访问令牌,并根据访问令牌 + oauth2 的方式设置了项目仓库的 remote,为了保证您能够正常推送和获取代码,请勿删除个人设置中的 hbuilder 访问令牌。
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册