鴻蒙手機版JNI實戰(JNI開發、SO庫生成、SO庫使用)

齊行超發表於2021-04-27

鴻蒙JNI開發現狀

現階段,不僅鴻蒙JNI相關的開發資料較少,而且Phone相關的JNI開發資料幾乎沒有,這對於新入行的鴻蒙開發者們來說,非常不友好。

也可能會給Android工程(使用了SO庫的工程)在遷移至鴻蒙系統時造成了阻礙。

案例演示

廢話不多說了,接下來,我們來演示鴻蒙手機版工程是如何做JNI開發的。

案例1:Native專案

如果開發者們只是想做簡單的Native開發,並非為第三方提供SO庫,這就非常簡單了,詳細如下:

1、建立Native C++工程

目前,通過DevEco-Studio建立建立Native C++模板型別的工程時,只有Car支援這種模板(Phone預設不包含Native C++模板)。
不必擔心,我們就先建立Car型別的工程,然後選擇Native C++模板,如下圖:

然後,輸入工程名稱等資訊,如下圖:

接下來,選擇C++標準庫,預設就可以了,如下圖:

點選【Finish】,工程就建立好了。

2、修改DeviceType配置

當前工程預設是Car型別的,想要支援手機,我們只需要修改DeviceType即可。

首先,找到config.json檔案,如下圖:

將“car”改為“phone”,即可支援執行在手機設定上了(是不是超級簡單呢),如下圖:

3、測試

我這邊使用的是鴻蒙手機進行測試的(鴻蒙手機是:由安卓P40升級的Harmony OS)。
另外,在真機上除錯、執行工程,需要申請證照(我這邊已申請,沒有的同學,可以去華為官網申請)。

測試前,我們先看下預設的模板工程結構:

整體的呼叫流程也很簡單:

開發者執行工程 --> build工程 --> 執行build.gradle 
  --> 執行裡面的externalNativeBuild --> 生成so庫檔案 --> app啟動 
  --> 頁面載入 --> 呼叫MainAbilitySlice類 --> 查詢並載入so庫 
  --> 在onStart生命週期方法中呼叫native方法 --> 執行so中的native實現方法
  --> 返回結果 --> 繫結給text控制元件(最終將結果顯示在頁面上)

手機上的執行結果(直接橫屏顯示......這是因為我們的工程本身是Car型別的模板工程,UI樣式預設設定的是橫屏的。如果不喜歡,開發者們也可以自行修改UI樣式):

so庫建立的預設位置:

案例2:Native專案

如果開發者們不僅要做native開發,還希望將so檔案提供給第三方使用,這樣我們就需要以module的形式來開發了,同樣也不怎麼複雜。

1、問題分析

現在有一個問題:建立module時,連native c++模板都沒有了,如下圖:

這不是要讓廣大開發者們生氣、抓狂、準備畫圈圈了麼。

解決方案:

其實,我們還有其他的方式(原因:JNI開發也就涉及到native方法定義、native原始碼、Cmake配置檔案、Gradle配置等內容):我們可以新建一個Car型別的Native C++工程和一個Harmony os Library Module,然後將模板工程entry中的JNI程式碼遷移到Harmony os Library Module中。

2、建立Car型別的Native C++模板工程

比較簡單,大家可以參考案例1的工程建立流程(此處就不再重複截圖了)

3、建立Harmony os Library Module

大家直接下一步就好(此處就不再截圖了)。

4、修改entry deviceType型別(改成phone)

5、拷貝檔案

將entry下的.cxx目錄和cpp目錄拖拽到 libnative module中的相同位置:

將entry下的build.gradle中 native 編譯指令碼拷貝至 libnative module中相同位置:

6、新建類定義native方法

為了加深大家理解,此處不再使用預設的hello.cpp了,我們們實現一個簡單的JNI開發:
新建TestNative類,定義native方法,如下圖:

通過DevEco-Studio的命令工具Terminal,進入java目錄,建立標頭檔案:

執行命令:
進入module目錄: cd libnative/src/main/java/
根據native方法生成標頭檔案:javah -jni xxxx(包名).類名

將標頭檔案拷貝到cpp目錄下,然後,右鍵cpp目錄,建立標頭檔案對應的實現類:

7、修改CmakeList.txt
# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(TestNative)

add_library(native SHARED testnative.cpp)
target_link_libraries(native)
8、生成so庫

此時,我們libnative module庫的功能已經實現了,可以生成so庫給其他工程使用了。

我們需要先讓libnative被entry依賴,這樣執行app時,才會自動載入libnative,從而執行其build.gradle中的native build配置,生成so庫。

entry依賴libnative,我們可以在entry的build.gradle中進行配置:

執行app後,檢視libnative module下,生成了so庫:

9、生成的so庫,怎麼提供給其他工程使用呢?

也很簡單,JNI主要包含了兩部分內容:定義的native方法的Java類(Java程式碼中呼叫so庫的入口)、native方法的實現類,我們只需要將這兩部分提供給他們就可以了:

1、定義的native方法的Java類:提供libnative的har包即可(給第三方時,一般不提供原始碼)
2、native方法的實現類:提供so庫檔案即可

測試:
我們簡單點,直接把so庫、har提供給我們工程的entry進行測試即可,不再新建工程了(因為,我比較懶,哈哈):
首先,我們先取消entry build.gradle中依賴libnative的配置(防止重複依賴,因為:har已包含了libnative的Java程式碼):

我們將libnative中的so庫、har拷貝到entry的libs目錄下:

在頁面中編寫呼叫har中native方法的程式碼:

執行app(執行前最好clean下工程、同步下gradle,確保依賴的是改har,而非工程中的libnative module):

總結

鴻蒙進行JNI開發其實不難,與安卓基本上一致,只是參考資料少一些而已。
如果大家對JNI不熟悉,可以參考我之前寫的JNI基礎的相關文章:
https://www.cnblogs.com/qixingchao/p/11911764.html
https://www.cnblogs.com/qixingchao/p/11911787.html

如果有問題,歡迎留言交流。
祝大家生活愉快、工作愉快,每天順心、開心!!!

相關文章