本文來源電子發(fā)燒友社區(qū)，作者：離北況歸， 帖子地址：https://bbs.elecfans.com/jishu_2308800_1_1.html


由于想要分享的內(nèi)容較多，為避免讀者姥爺們失去看下去的耐心，分享將以連載的方式進行。

本期為移植speexdsp到OpenHarmony標準系統(tǒng)的第⑥期，主要內(nèi)容如下：

speexdsp移植后已提交至openhamrony sig倉庫：https://gitee.com/openharmony-sig/contest/tree/master/2022_OpenHarmony_thirdparty/speexdsp

九、準備好上傳speexdsp至OpenHarmony倉庫。

移植完成后，先將代碼上傳至sig倉中的contest倉

sig倉庫是TPC倉庫的孵化倉。代碼先上sig倉，到時會直接平移到tpc倉。

上傳的內(nèi)容包括：

• 原生庫代碼
  • （除了涉及需要修改原生庫代碼的部分，其他都不能上傳，例如編譯途中生成的中間文件）
• BUILD.gn
• README.Opensource
• 庫對外導出的所有api接口export_api.txt
• 測試過的api接口tested_api.txt
• 功能測試文檔: 三方庫_test_function.md
  • 內(nèi)容至少包含羅列出庫所有的功能，已測試過的功能，原生庫測試邏輯的分析
• 原生庫分析文檔: 三方庫_analyse.md

文檔命名不要用中文，如果涉及到編碼問題的話，到時候會出現(xiàn)亂碼，一般建議不用中文命名！?。?/p>

提供OAT.xml文件

OAT開源掃描

• OAT（OSS Audit Tool）是OpenHarmony社區(qū)的自動化開源審視工具，用于幫助開發(fā)人員基于自定義的規(guī)則自動掃描開源倉代碼，識別不符合預定規(guī)則的代碼并輸出掃描報告。
• OAT下載地址：https://gitee.com/openharmony-sig/tools_oat

工具使用

編譯構建：

• 在linux上安裝好java和Maven后，下載OAT工具源碼，執(zhí)行mvn package完成構建。

• 編譯構建成功

在父目錄下添加OAT.xml，內(nèi)容如下:

<configuration>
    <oatconfig>
        <licensefile>COPYINGlicensefile>
        <policylist>
            <policy name="projectPolicy" desc="">
                
                <policyitem type="license" name="*" path=".*" rule="may" group="defaultGroup" filefilter="defaultPolicyFilter" desc=""/>
            policy>
        policylist>
        <filefilterlist>
            <filefilter name="defaultFilter" desc="Files not to check">
                <filteritem type="filepath" name=".*" desc="原生庫文件"/>
            filefilter>
            <filefilter name="defaultPolicyFilter" desc="Filters for compatibility，license header policies">
                
                
                
                <filteritem type="filepath" name=".*" desc="原生庫代碼"/>
            filefilter>
            <filefilter name="copyrightPolicyFilter" desc="Filters for copyright header policies">
                
                
                
                <filteritem type="filepath" name=".*" desc="原生庫代碼"/>
            filefilter>
            <filefilter name="licenseFileNamePolicyFilter" desc="Filters for LICENSE file policies">
                
                
                
            filefilter>
            <filefilter name="readmeFileNamePolicyFilter" desc="Filters for README file policies">
                
                
                
                
            filefilter>
            <filefilter name="readmeOpenSourcefileNamePolicyFilter" desc="Filters for README.OpenSource file policies">
                
                
                
            filefilter>
            <filefilter name="binaryFileTypePolicyFilter" desc="Filters for binary file policies">
                
                
                
            filefilter>

        filefilterlist>
        <licensematcherlist>
            
        licensematcherlist>
    oatconfig>
configuration>

在speexdsp根目錄下新建空白的OAT_report.text文件，執(zhí)行命令：

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 檢查任務的名稱，任意指定，本地檢查使用不上。

例如筆者執(zhí)行的語句為：

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

掃描結果

執(zhí)行完上述命令后，OAT_report.text生成內(nèi)容如下：

同時在speexdsp父目錄下生成log文件夾

• LicenseFile.txt位于OAT工具運行目錄的log目錄下，此文件記錄掃描目錄下所有疑似許可證的文件

原生庫通過make或者cmake時生成的一些配置文件。如比較通用的config.h配置文件，config.h文件為原生庫生成文件，原則上也不做修改，為了避免文件上倉進行代碼掃碼，可以將文件文件修改后綴名(config.h.in)。相關文檔中需要將配置文件使用方法說明。

提供README.OpenSource文件

README.Opensource的格式如下:

[
    {
      "Name": "",				## 庫名
      "License": "",			## 開源協(xié)議
      "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"
    }
]

提供庫的分析文檔

三方庫分析文檔如下：

一、確定庫實現(xiàn)方式
例如：C/C++/JS/JAVA

二.依賴分析
例如：當前庫依賴其他三方庫，如下

1）庫名1，庫倉庫地址

2）庫名2，庫倉庫地址

三、license以及版權
例如：一般在license文件或者COPYING中，Apache License V2.0

四、最新一次版本
xx年xx月xx日，版本號xxx

五、功能點分析
（羅列出該庫所支持的功能）

六、代碼規(guī)模
（統(tǒng)計庫代碼總行數(shù)，包括.h/.hpp/.c/.cpp/.cc 等代碼相關文件）

提供功能測試文檔

文檔中需羅列出

• 庫所有的功能
• 已測試過的功能
• 原生庫測試邏輯的分析

提供導出的api接口列表

1、 導出庫對外暴露的所有api接口的列表

2、導出庫對外暴露的已測試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都要輸入賬號信息的問題)

克隆倉庫內(nèi)容到本地

到個人賬號點擊并進入contest倉庫， fork該倉庫：

進入到clone界面，復制clone的鏈接地址。

執(zhí)行如下語句：

git clone https://gitee.com/xxxxx/contest.git --depth=1

• --depth=1意思是只clone當前倉庫最新版本，省去一些歷史log，避免倉庫歷史記錄過于龐大花費太多clone時間。
• clone完畢之后，即可在本地目錄下看到這個clone的倉庫。本地目錄所在位置是根據(jù)git bash的位置決定的，比如在桌面啟動git bash，則clone的倉庫會出現(xiàn)在桌面。

利用git lfs機制添加特殊文件

提交三方庫時候，文檔中有PDF文件時就需要使用利用git lfs機制

git lfs track xxx/xxx.pdf  // 聲明該特殊文件到git lfs機制

git add .gitattributes // 添加配置文件

git add xxx/xxx.pdf // 添加具體特殊文件到暫存區(qū)中

git lfs ls-files  // 確認相關test_lfs.a 文件是否已經(jīng)添加到lfs 機制中。

git  add *   //將變更文件加入到暫存區(qū)

git commit -s -m  "add xxxxxxxx"  //將暫存區(qū)內(nèi)容簽名并提交到本地

• -s是簽名表明這次提交者簽名(signoff)
• -m是對此次提交行為進行備注.

推送本地修改到賬號倉庫

現(xiàn)在需要將本地倉庫的修改內(nèi)容推送到gitee上fork后的個人倉庫，使用git push命令來完成這個動作。

git push origin master

• origin指的是自己的倉庫對應的原始遠程服務器地址；
• master標識的是想要提交的分支。
• 可以使用 git remote -v查看配置的遠程服務器；
• git branch -a查看所有的分支。

進入自己的賬號下面，查看這個倉庫，發(fā)現(xiàn)已經(jīng)發(fā)生了變化。從個人賬號倉庫下向官方倉庫下提交PR。

進入個人賬號的該倉庫下，點擊增加PR即可開始提交PR。

提交pr時，push的文件超過100個文件，在pr頁面只顯示100個。