九、准备好上传speexdsp至openharmony仓库。
完成移植后,首先将代码上传到sig仓库中的contest仓库。

上传的内容包括:
- 原生库代码(除了涉及需要修改原生库代码的部分,其他都不能上传,例如编译途中生成的中间文件)
- BUILD.gn
- README.OpenSource
- 库对外导出的所有API接口 export_api.txt
- 测试过的API接口 tested_api.txt
- 功能测试文档:三方库_test_function.md,内容至少包含罗列出库所有的功能,已测试过的功能,原生库测试逻辑的分析
- 原生库分析文档:三方库_analyse.md
- 文档命名不要使用中文,如果涉及到编码问题的话,到时候会出现乱码,一般建议不用中文命名!!!
提供OAT.xml文件进行开源扫描。

工具使用编译构建:
在Linux上安装好Java和Maven后,下载OAT工具源码,执行mvn package完成构建。

编译构建成功后:

在父目录下添加OAT.xml,内容如下:
COPYING
在speexdsp根目录下新建空白的OAT_report.text文件,执行命令:
java -jar ohos_ossaudittool-1.0.jar -s src_dir -r report_file -n selfcheck
ohos_ossaudittool-1.0.jar 工具包名,需要带实际路径
- -s 指定需要检查的代码目录,src_dir 改成要检查的项目路径
- -r 指定报告输出文件的路径,检查完成后可查看此文件中列出的问题,按指导文档修复report_file
- -n 检查任务的名称,任意指定,本地检查使用不上
例如笔者执行的语句为:
sudo java -Dfile.encoding=UTF-8 -jar /home/jiajiahao/Desktop/tools_oat-master/target/ohos_ossaudittool-1.0.jar -s /home/jiajiahao/Desktop/gitee_speexdsp -r /home/jiajiahao/Desktop/gitee_speexdsp/OAT_report.text -n nameOfRepo
扫描结果执行完上述命令后,OAT_report.text生成内容如下:

同时在speexdsp父目录下生成log文件夹。

LicenseFile.txt位于OAT工具运行目录的log目录下,此文件记录扫描目录下所有疑似许可证的文件。
iTop代表IT运营门户。它是一个完整的开源和基于Web的IT服务管理平台,包括一个完全可定制的配置管理数据库(CMDB),一个帮助台系统和一个文档管理工具。它符合ITIL标准,并且由于大量的附加组件和Web服务,可以轻松定制和扩展以与您的IT集成。iTop还提供了批量导入工具,以帮助您更加高效。项目源代码已迁移到https://github.com/Combodo/iTop
提供README.OpenSource文件,README.OpenSource的格式如下:
[
{
"Name": "", ## 库名
"License": "", ## 开源协议
"License File": "", ## 开源文件,一般开源项目都会自带该文件
"Version Number": "", ## 库的版本
"Owner": "", ## 作者
"Upstream URL": "", ## 开源库的地址
"Description": "" ## 库的描述
}
]speexdsp的README.OpenSource文件如下:
[
{
"Name": "speexdsp",
"License": "BSD-3-Clause",
"License File": "COPYING",
"Version Number": "1.2.1",
"Owner": "2692032597@qq.com",
"Upstream URL": "https://speex.org/",
"Description": "Speexdsp is a speech processing library that goes along with the Speex codec"
}
]提供库的分析文档,三方库分析文档如下:
一、确定库实现方式 例如:C/C++/JS/JAVA 二.依赖分析 例如:当前库依赖其他三方库,如下 1)库名1,库仓库地址 2)库名2,库仓库地址 三、license以及版权 例如:一般在license文件或者COPYING中,Apache License V2.0 四、最新一次版本xx年xx月xx日,版本号xxx 五、功能点分析(罗列出该库所支持的功能) 六、代码规模(统计库代码总行数,包括.h/.hpp/.c/.cpp/.cc 等代码相关文件)
提供功能测试文档,文档中需罗列出:
- 库所有的功能
- 已测试过的功能
- 原生库测试逻辑的分析
提供导出的API接口列表:
- 导出库对外暴露的所有API接口的列表
- 导出库对外暴露的已测试API接口的列表
十、上传speexdsp至OpenHarmony仓库
配置个人信息,打开git bash,依次输入以下命令:
git config --global user.name "xxxx" (配置用户名,xxxx为账号用户名,即个人空间地址) git config --global user.email "xxxxxx@xxx" (gitee 账号邮箱与签署DCO 的邮箱保持一致即可) git config --list (查看配置情况) git config --global credential.helper store (解决每次git pull都要输入账号信息的问题)
克隆仓库内容到本地,到个人账号点击并进入contest仓库,fork该仓库:

进入到clone界面,复制clone的链接地址。

执行如下语句:
git clone https://gitee.com/xxxxx/contest.git --depth=1
--depth=1意思是只clone当前仓库最新版本,省去一些历史log,避免仓库历史记录过于庞大花费太多clone时间。clone完毕之后,即可在本地目录下看到这个clone的仓库。本地目录所在位置是根据git bash的位置决定的,比如在桌面启动git bash,则clone的仓库会出现在桌面。
利用git lfs机制添加特殊文件,提交三方库时候,文档中有PDF文件时就需要使用利用git lfs机制。
git lfs track xxx/xxx.pdf // 声明该特殊文件到git lfs机制
git add .gitattributes // 添加配置文件
git add xxx/xxx.pdf // 添加具体特殊文件到暂存区中
git lfs ls-files // 确认相关test_lfs.a 文件是否已经添加到lfs 机制中。
git add * //将变更文件加入到暂存区
git commit -s -m "add xxxxxxxx" //将暂存区内容签名并提交到本地
-s是签名表明这次提交者签名(signoff),-m是对此次提交行为进行备注。
git commit --amend
推送本地修改到账号仓库,现在需要将本地仓库的修改内容推送到gitee上fork后的个人仓库,使用git push命令来完成这个动作。
git push origin master
origin指的是自己的仓库对应的原始远程服务器地址;master标识的是想要提交的分支。可以使用 git remote -v查看配置的远程服务器;git branch -a查看所有的分支。
写在最后,如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
- 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力;
- 关注小编,同时可以期待后续文章ing?,不定期分享原创知识;
- 想要获取更多完整鸿蒙最新学习知识点,可关注B站:码牛课堂鸿蒙开发;









