如何在github上向HaaS和AliOS Things贡献代码

1、github上项目地址

      AliOS Things的项目地址：

      https://github.com/alibaba/AliOS-Things

     HaaS在AliOS Things上的分支：dev_3.1.0_haas

     https://github.com/alibaba/AliOS-Things/tree/dev_3.1.0_haas

    

 

2、创建 Fork下载代码

2.1 Fork到个人仓库

登录github账号后，在github 上的AliOS-Things仓库里单击 “fork” 按钮，将AliOS Things的仓库fork一份到开发者自己的名下 

 

2.2、复制下载地址

进入开发者fork出来的AliOS Things仓库，注意，该仓库地址已经从alibaba/AliOS-Things变成/AliOS-Things，如下图所示。然后根据图中提示的步骤复制仓库地址。

 

2.3、下载代码

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

# 注意YOUR_NAME替换成开发者Github账号的名称
$ git clone https://github.com//AliOS-Things.git  

 

3、本地开发并提交

本文以更新dev_3.1.0_haas分支的代码为例子，提供完整开发命令供参考

# 1、Checkout and switch to your new branch
$ cd AliOS-Things
$ git checkout dev_3.1.0_haas

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

在github网页按下图操作，点击“commits”按钮，如果出现你的提交记录，说明push成功

 

4、创建pull request

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

在开发者github的AliOS Things仓库页面上，选择开发分支，如dev_3.1.0_haas，然后单击“ Pull request ”按钮发起“New pull request”. 如下图网页操作，创建一个pull request

 

点击完上图中“New pull request”后，会出现如下所示，请选择源仓库分支和目标仓库分之，点击“Create pull request”，生成pr（Pull Request）

 

填写申请pr的原因，点击“Create pull request”发起pr请求

 

在主项目alibaba/AliOS-Things页面，查看“Pull requests”，如果出现刚刚的提交，说明申请Pull  request成功

 

5、同步代码

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

$ git remote add upstream https://github.com/alibaba/AliOS-Things.git 
$ git remote -v                                                 #此时本地有两个远程地址，origin和upstream，origin对应fork仓库，upstream对应alibaba仓库
$ git fetch upstream                                        #将alibaba仓库代码更新到本地                                  
$ git checkout dev_3.1.0_haas                   #切换到dev_3.1.0_haas分支                
$ git merge upstream/dev_3.1.0_haas       #合并alibaba/AliOS-Things的更新至本地     

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

 

6、关注我们

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

 

7、点赞我们

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

 

8、开发者技术支持

如需更多技术支持，可加入钉钉开发者群，或者关注微信公众号

更多技术与解决方案介绍，请访问阿里云AIoT首页https://iot.aliyun.com/