OpenHarmony三方库gitee提交PR指导

一 提交前的准备

1.账号准备

用户提交Pull Request(下面简称PR)之前需要注册一个gitee账号，并设置好主邮箱。

注册地址：https://gitee.com/signup

邮箱设置界面：https://gitee.com/profile/emails

2.在DCO签署账号

账号注册完毕之后为了保证PR能合入，还需要签署DCO，签署网址：

https://dco.openharmony.io/sign/Z2l0ZWUlMkZvcGVuX2hhcm1vbnk=

签署完成之后需要查看gitee账号的签署状态，保证其状态为已签署。

3.仓库准备

提交PR之前需要进行以下两个操作：

3.1 代码准备

准备已经开发好的代码，关于如何在gitee创建library并提交代码请参考gitee使用教程，创建项目仓库并上传代码

3.2 fork仓库

fork需要提交到的仓openharmony-tpc/tpc_resource到自己的目标空间，具体步骤为：

点击tpc_resource仓库右上角的fork按钮，fork本库到自己的账号。
选择目标空间
fork仓库完毕之后点击tpc_resource项目(本人fork的项目，非OpenHarmony-TPC / tpc_resource)右侧的同步按钮拉取源库的代码，保证两个仓的代码一致。

4.更新代码到私人仓库

fork完毕之后，在本人的tpc_resource项目里点击README.md或者README.en.md文档，选择右上方的"编辑"按钮，点击之后进入编辑模式。

选择编辑按钮
进入编辑模式

更新内容

确认代码准备 里的自己的library归属的类型，在相关位置增加一行。需要用到library的名称、url、简介，如下所示：
编辑页面的下方添加提交者的信息。 提交信息：填写本次的更新内容。 扩展信息：添加自己的姓名和邮箱。格式：Signed-off-by: 姓名<邮箱> 注意：提交信息和扩展信息必须填写否则在合入PR的时候无法通过校验 邮箱和姓名需要和gitee账号里面的保持一致，获取方式点击这里获取提交信息和扩展信息
完成效果

4.1 获取提交信息和扩展信息

提交信息和扩展信息必须和第一步账号准备里面的信息对应。获取方式如下图所示：

在gitee网站进入设置界面
进入个人资料获取---姓名
进入邮箱管理获取---邮箱

二 代码PR

私人tpc_resource仓库里面README更新完信息之后，点击项目结构预览上面的第三个按钮Pull Request，创建一个PR将代码合入到源库openharmony-tpc/tpc_resource。

1.创建PR

创建PR
填入相关信息并提交，请先确认分支以及填写本次PR的标题和内容
提交完成界面

2.触发检查

PR创建完成之后还需要在PR的评论里面评论 start build

输入评论
完成效果

等待CI流水线启动，对提交的代码进行DCO签署检测，代码质量检测，代码合规问题检测。

等待几分钟，刷新openharmony-tpc/tpc_resource,并点击Pull Request按钮确认CI结果
点击刚刚提交的PR标题可以查看详情

3.修复问题

如果CI检测出现了问题，请按照提示修改，直至修改完所有的问题之后，等待commiter检查代码之后合入该PR。以下列举两种很常见的问题：

3.1 CI未启动

未关联issue，CI未启动
解决办法：
点击上图里面的标注1处的issues按钮，新创建一个issue，拿到issue号之后，再回到PR里面点击标注1处关联自己新增的issue，然后再次评论"start build"即可

3.2 dco检查失败

未签署DCO或者提交的时候没有添加身份信息
解决办法：
1.根据提示信息，先确认自己的账号是否签署DCO，具体操作查看在DCO签署账号 2.如果账号已经签署了，确认提交的时候是否添加了身份信息，具体操作查看更新代码到私人仓库 3.先关闭本次的PR，补全信息之后重新提交一次

三 更多PR提交方式

本指导文档适用于一些简单的文档、代码修改，不方便进行复杂的操作，如需更详细更专业的操作指导，请参考贡献流程