鴻蒙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
視頻講解:
https://edu.csdn.net/course/detail/27043
https://edu.csdn.net/course/detail/27092
如果有問題,歡迎留言交流。
祝大家生活愉快、工作愉快,每天順心、開心!!!