贡献代码说明

更正文档

项目地址:https://gitee.com/alios-things-admin/AliOS-Things

AliOS Things为开发者在Gitee平台上提供了贡献代码的入口,开发者可以在AliOS Things项目下找到想到修改的仓库进行代码提交,具体步骤如下。

查找目标仓库

AliOS Things 3.3版本在Gitee平台上,每个功能模块分配一个独立的仓库。 若开发者想对某个组件或案例仓库贡献代码,可以在AliOS Things概览页面点击选项栏中的“仓库”切换到“仓库”页,在搜索栏中输入目标组件或案例的名称,确认后即可显示搜索结果。以目标仓库为netmgr为例,搜索方式如下图:

切换分支

打开目标组件或案例的仓库,切换代码分支为rel_3.3.0,即可查看到该组件或案例3.3版本对应的源代码。以目标仓库为netmgr为例,切换分支方法如下图。

创建 Fork下载代码

1、在Gitee 上的目标仓库里单击 “fork” 按钮,将目标仓库fork一份到开发者自己的名下。以目标仓库为amp为例,Fork代码的方法如下图:

2、进入开发者fork出来的目标仓库,注意,该仓库地址已经从AliOS Things/ 变成<YOUR_NAME>/,如下图所示。然后根据图中提示的步骤复制仓库地址。

3、下载代码 注意:gitee提供多种下载方式,本文使用https,下载代码时会要求输入密码,密码是开发者的gitee登录密码。

# 注意YOUR_NAME替换成开发者Gitee账号的名称;TARGET替换为Gitee仓库名称
$ git clone https://gitee.com/<YOUR_NAME>/<TARGET>.git

本地开发并提交

本文以提交amp仓库下的代码为例子,提供完整开发命令供参考:

# 1、Checkout and switch to your new branch
# 注意TARGET替换为Gitee仓库名称
$ cd <TARGET>
$ git checkout rel_3.3.0

# Commit and push your code
git add -A                                #-A表示将本地所有修改文件提交,若只需要提交若干文件,请将-A替换成文件名
git commit -s                        #填写log日志,说明变更的内容,影响功能点等
git push                                        #将本地代码push到github

在gitee网页按下图操作,如果出现你的提交记录,说明push成功

创建pull request

当功能开发完成后,可以发起 Pull Request,申请合入代码到AliOS Things/。

在开发者gitee的AliOS-Things仓库页面上,然后单击“ Pull requests ”按钮发起“+新建 pull request”. 如下图网页操作,创建一个pull request

在AliOS Things/ 页面,看到自己的pull request请求,即说明创建成功,等待审核

同步代码

在发起 Pull Request 之前,有可能原来的仓库AliOS Things/有代码更新,那么请按照以下步骤,拉取AliOS Things/最新的代码至本地。

# 注意TARGET替换为Gitee仓库名称
$ git remote add upstream https://gitee.com/alios-things/<TARGET>.git
$ git remote -v                                                                #此时本地有两个远程地址,origin和upstream,origin对应fork仓库,upstream对应<TARGET>仓库
$ git fetch upstream                                                #将alibaba仓库代码更新到本地
$ git checkout rel_3.3.0                                    #切换到master分支
$ git merge upstream/rel_3.3.0                        #合并AliOS Things/<TARGET>的更新至本地

如果merge过程中,代码有冲突,需要解决所有代码冲突以后,才能提交。

关注我们

如果你想实时了解Alios-Things的动态,请记得点击watch持续关注。

点赞我们

如果你喜欢这个项目,就请给我们一个小星星吧