7 Star 30 Fork 8

Gitee Community / OpenHarmony组件开发大赛-有奖征文

 / 详情

OpenHarmony实践经验-如何给OpenHarmony贡献代码

意向
需求
创建于  
2021-09-26 13:59

开源扫盲--如何给OpenHarmony贡献代码

OpenHarmony是由开放原子开源基金会(OpenAtom Foundation)孵化及运营的开源项目,目标是面向全场景、全连接、全智能时代,搭建一个智能终端设备操作系统的框架和平台,促进万物互联产业的繁荣发展。目前代码仓托管在gitee上,官方地址https://gitee.com/openharmony,快去点击关注吧。

下面主要来讲讲如何对OpenHarmony贡献代码。

1、fork OpenHarmony中的仓库

截止目前为止,OpenHarmony共有276个仓库,如下图

输入图片说明

在”仓库“tab页面,根据自己擅长的技术方向和爱好选择需要贡献源代码的仓库,这里支持搜索,比如我选择app_samples这个仓库,如下图

输入图片说明

进入到选择的仓库中,然后点击fork,如下图

输入图片说明

点击fork之后,会有如下提示窗口弹出,选中自己的头像之后,即可点击确认按钮

输入图片说明

fork完成之后,就会自动跳转到自己的gitee仓库页面,里面会创建一个与你刚fork的仓库同名的仓库,如下图

输入图片说明

2、克隆fork出来的仓库到自己的主机上

在我们fork出来的仓库主页复制https clone的地址,如下图

输入图片说明

在本地的PC上运行如下命令将fork出来的代码库拷贝到本机的文件夹中

git clone 'https clone 的地址' 

比如我这里使用如下命令

git clone https://gitee.com/xdw1019/app_samples.git

执行结果如下图,耐心等待下载完成即可

输入图片说明

3、配置本地仓与官方原始仓的关联

这里先备注几个名词解释:

官方原始仓:你想要贡献的项目的官方仓库地址
远程仓:你fork完成之后,在你的gitee 页面上那个与官方仓同名的仓库地址
本地仓:git clone 远程仓之后下载到你本地的代码仓

进入我们的项目文件夹

cd 

添加与官方原始仓的关联,命名为upstream

git remote add upstream ’官方原始仓的clone地址‘ 

关联好之后,可以使用下面命令查看关联信息

git remote -v

执行结果如下图

输入图片说明

待关联好了官方原始仓之后,就可以使用下面命令拉取最新的更新了

git fetch upstream  

4、新建开发分支进行开发

执行下面命令即可新建开发分支

# 新建分支,fixDoc为分支名称,名称自定义即可
git checkout -b fixDoc

执行成果之后的截图如下

输入图片说明

4、开发分支上修改代码并push到远程仓

基本操作步骤命令如下

# 查看修改了那些文件
git status

# add提交到暂存区
git add .

# commit提交到本地仓,-m后简要描述本次提交的内容
git commit -m "xxxxx"

# push到远程仓
git push origin fixDoc

我的操作截图如下

输入图片说明

5、向官方原始仓提交Pull Request

打开自己fork的仓库主页,选择Pull Request标签,然后点击新建Pull Request按钮,如下图

输入图片说明

点击新建之后,会跳转到官方原始仓的Pull Request页面下,按照下图填写好相关的Pull Request信息即可

输入图片说明

输入图片说明

6、DCO签署与验证

提交的pull request首先要经过dco检查,因此需要签署原子基金会的DCO协议。

打开sign (openharmony.io)进行签署即可。

输入图片说明

注意:这里签署的名字和邮箱要和git config中配置的用户名和邮箱保持一致

比如我本地使用git config配置如下

git config --global user.name "夏德旺"
git config --global user.email "263201361@qq.com"

然后将之前的commit的命令修改为

git commit -m "xxxxxx" -s

此时可以通过git log看到提交日志如下图,带有 Signed-off-by:信息

输入图片说明

配置好这些之后再来提交pull request的话就可以通过dco检查了。

输入图片说明

剩下的就等社区审核人员审核通过即可。

评论 (0)

xiadewang 创建了需求
展开全部操作日志

登录 后才可以发表评论

状态
负责人
项目
里程碑
Pull Requests
关联的 Pull Requests 被合并后可能会关闭此 issue
分支
开始日期   -   截止日期
-
置顶选项
优先级
预计工期 (小时)
参与者(1)
789395 xdw1019 1630665757
其他
1
https://gitee.com/gitee-community/OHZW210809.git
git@gitee.com:gitee-community/OHZW210809.git
gitee-community
OHZW210809
OpenHarmony组件开发大赛-有奖征文

搜索帮助