??想了解更多關于開源的內容，請訪問：??

??51CTO 開源基礎軟件社區??

??https://ost.51cto.com??

獲取三方庫

使用之前要做好代碼溯源，確認可用的版本，開源許可和發布方式等。
通過正確的路徑獲取源碼，可以是官網，或者指定托管的github或者gitee倉。
官網：https://libmodbus.org/github：https://github.com/stephane/libmodbus

移植三方庫

三方庫移植主要需要以下四步。

linux編譯

編譯三方庫：

1、如果原三方庫根目錄存在CMakeLists.txt文件，新建build目錄，通過cmake生成makeflie然后make。
2、如果根目錄存在autogen.sh或configure.ac文件，使用Makefile.am構建，先執行./autogen.sh，再執行./configure命令生成Makefile，最后make和make install。

分析編譯過程：

提取編譯動態鏈接庫和測試用的可執行文件所需要的源文件和頭文件、編譯添加的cflag和其他編譯器參數，以及編譯需要的鏈接庫。
根據三方庫的編譯有兩種情況：
1、在cmake生成makefile的過程中，分析build.make（生成目標的源文件）、depend.make（需要依賴的其他C源文件）、flags.make（cflags相關標記）、link.txt（鏈接庫相關信息）等得出三方庫對應的依賴關系。

2、使用Makefile.am構建的三方庫，分析make.am內容，分析編譯動態鏈接庫和測試用的可執行文件需要的源文件，添加的編譯器參數。鏈接庫則通過分析makefile文件提取。

OpenHarmony適配

三方庫一般放置在third_party目錄下。

編譯之前要增加模塊配置，可以參考以下鏈接：
https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-build-module.md#新增并編譯模塊

部件名：modbus_part_name = “libmodbus”
子系統名：modbus_subsystem_name = “modbus”

新增子系統和部件名的方式：

1、在模塊目錄下配置BUILD.gn，根據模板類型選擇對應的gn模板

third_party/libmodbus/BUILD.gn

2、在新建的子系統目錄下每個部件對應的文件夾下創建bundle.json文件，定義部件信息。

third_party/libmodbus/bundle.json

3、修改build目錄下的subsystem_config.json文件。

build\subsystem_config.json

4、在vendor/{product_company}/{product-name}目錄下的產品配置如product-name是hispark_taurus_standard時，在config.json中添加對應的部件，直接添加到原有部件后即可。

productdefine\common\inherit\rich.json

這幾步適配都需要根據三方庫的引用方式來確定，并不需要每步都配置。如果當前模塊是需要添加到已經有的部件或子系統，就只需要配置1和2步即可。

增量編譯

編譯動態鏈接庫和可執行文件：
./build.sh --product-name rk3568 --ccache --build-target三方庫名稱 --target-cpu arm64
注：ohos到3.2版本之后，默認編譯的都是32位系統，若要支持64位系統，在編譯命令中添加–target-cpu arm64

例如：./build.sh --product-name rk3568 --ccache -T libmodbus
編譯過程可能出現報錯，根據報錯信息調整gn。消除編譯警告，例如：-Wimplicit-function-declaration改為-Wno-implicit-function-declaration加到gn的cflags信息里面。

編譯成功生成的動態鏈接庫和測試用的可執行文件在out目錄下。

例如：out/ rk3568/modbus/libmodbus/libmodbus.z.so

驗證接口

將編譯好的動態庫和測試用例的可執行文件推送到開發板上。然后驗證是否成功，保證測試用例都能在開發板上運行通過。
API接口是提供給北向調用的，實現指定的功能，使用者不需要了解其內部具體實現。
按照業務需要提供native和js接口。

引用方式

靜態庫

在部件中需要使用的gn中配置deps項，然后在代碼中直接引用接口。

“//third_party/libmodbus:modbus”,

例如：

動態庫

先編譯動態庫，然后放在板子指定路徑，然后通過dlopen導入動態庫，最后在代碼中通過句柄調引用接口。例如：

if(handle == nullptr){ 
MMI_HILOGE("Open failed, so name:%{public}s, msg:%{public}s", pluginPath.data(), dlerror()); 
return false; 
}

??想了解更多關于開源的內容，請訪問：??

??51CTO 開源基礎軟件社區??

??https://ost.51cto.com??