一、記一次uni-app Android原生插件開(kāi)發(fā)之旅

一、項(xiàng)目背景與啟動(dòng)

項(xiàng)目需求中，我們遇到了一個(gè)特別的挑戰(zhàn)——開(kāi)發(fā)一個(gè)用于RFID射頻手持設(shè)備（PDA）讀取羊只耳標(biāo)的uni-app原生插件。為了滿足這一需求，我們決定采用uni-app框架，并選用uni-plugin作為開(kāi)發(fā)工具以兼容Android原生環(huán)境。整個(gè)開(kāi)發(fā)過(guò)程大致可以分為以下幾個(gè)階段。

二、下載與工具導(dǎo)入

我們從官方網(wǎng)站獲取了uni-plugin的離線SDK及配套demo，然后使用Android Studio進(jìn)行導(dǎo)入。這一步是搭建開(kāi)發(fā)環(huán)境的基礎(chǔ)，確保后續(xù)的開(kāi)發(fā)工作能夠順利進(jìn)行。

三、構(gòu)建插件模塊

接下來(lái)，我們創(chuàng)建了一個(gè)名為“uhfg”的模塊，并導(dǎo)入相關(guān)的uhf庫(kù)。為了適配項(xiàng)目需求，我們對(duì)build.gradle文件進(jìn)行了調(diào)整。這個(gè)過(guò)程需要深入理解Android原生開(kāi)發(fā)的知識(shí)，以確保插件的穩(wěn)定性和兼容性。

四、核心功能的實(shí)現(xiàn)

在核心功能的實(shí)現(xiàn)階段，我們編寫(xiě)了UHFGUtil類和UHFGUtilListenner類，前者用于處理設(shè)備通信，后者實(shí)現(xiàn)監(jiān)聽(tīng)。根據(jù)項(xiàng)目需求，我們還設(shè)計(jì)了相應(yīng)的模型類來(lái)存儲(chǔ)和處理數(shù)據(jù)。

五、插件打包與集成

使用Android Studio中的gradle工具，我們采用assembleRelease模式進(jìn)行插件編譯，生成了適用于uni-app的aar文件。我們將這個(gè)文件與必要的libs文件組合成完整的原生插件。在項(xiàng)目集成階段，我們創(chuàng)建了本地插件目錄，將插件包放置其中，并在manifest文件中配置本地插件。我們打包為自定義基座，以實(shí)現(xiàn)插件的調(diào)用。

六、云端發(fā)布與調(diào)試

開(kāi)發(fā)完成后，我們將插件發(fā)布至云市場(chǎng)，通過(guò)云端方式供其他項(xiàng)目調(diào)用。我們進(jìn)行了全面的調(diào)試與優(yōu)化，解決了類名重復(fù)、第三方庫(kù)引入不當(dāng)?shù)葘?dǎo)致的編譯錯(cuò)誤，確保插件的兼容性和穩(wěn)定性。

二、uniapp原生插件開(kāi)發(fā)問(wèn)題解析

在uniapp原生插件的開(kāi)發(fā)與使用過(guò)程中，可能會(huì)遇到一些問(wèn)題。例如，導(dǎo)入U(xiǎn)niPlugin-Hello-AS工程項(xiàng)目后，虛擬器報(bào)告設(shè)備支持x86但apk僅支持armeabi-v7a的問(wèn)題。為了解決這類問(wèn)題，我們需要檢查項(xiàng)目的配置，確保其與目標(biāo)設(shè)備的架構(gòu)相匹配。

在打包uni-app插件時(shí)，可能會(huì)遇到雙擊運(yùn)行assembleRelease時(shí)失敗的情況。這通常是由于gradle配置不當(dāng)所致。正確的做法是，除了對(duì)sdk的arr包引入不用改為implementation，其他地方的compileOnly都需改為implementation。這樣調(diào)整配置后，可以成功生成module的aar文件。

雖然uni-app原生插件開(kāi)發(fā)需要一定的Android知識(shí)，但借助uni-plugin等工具，可以簡(jiǎn)化開(kāi)發(fā)流程。對(duì)開(kāi)發(fā)者而言，理解并熟悉這些工具的使用方式，是解決問(wèn)題的關(guān)鍵。希望這次的開(kāi)發(fā)經(jīng)歷能為其他開(kāi)發(fā)者提供一些有價(jià)值的參考和啟示。成功之路：獲取插件module的aar文件與iOS端uniAPP原生插件打包流程

一、成功獲取插件module的aar文件

在開(kāi)發(fā)過(guò)程中，我們成功獲取了插件module的aar文件，這是開(kāi)發(fā)過(guò)程中的重要一步。值得注意的是，在官網(wǎng)原生插件開(kāi)發(fā)文檔中，添加依賴庫(kù)時(shí)全部使用了compileOnly。但在運(yùn)行assembleRelease時(shí)報(bào)錯(cuò)，經(jīng)過(guò)嘗試，將compileOnly改為implementation后，問(wèn)題得以解決。這一經(jīng)驗(yàn)對(duì)于避免類似問(wèn)題的開(kāi)發(fā)者來(lái)說(shuō)，具有重要的參考價(jià)值。

二、靜態(tài)庫(kù)的設(shè)置

在進(jìn)行uni原生插件開(kāi)發(fā)時(shí)，靜態(tài)庫(kù)的設(shè)置是不可或缺的一環(huán)。我們需要熟悉項(xiàng)目結(jié)構(gòu)，并參考官網(wǎng)提供的Demo。HBuilder-uniPlugin工程實(shí)際上是云端編譯環(huán)境的集合，包含大量依賴項(xiàng)，以減少本地開(kāi)發(fā)者上傳庫(kù)的負(fù)擔(dān)。

在開(kāi)發(fā)過(guò)程中，首先要檢查云端是否已有支持的第三方庫(kù)，避免重復(fù)導(dǎo)入導(dǎo)致的編譯符號(hào)沖突。例如，若插件需要B站的IJKMediaFramework庫(kù)，應(yīng)先查看云端是否已存在此庫(kù)，若存在，則無(wú)需本地提交。相關(guān)學(xué)習(xí)資料及免費(fèi)資源可以通過(guò)點(diǎn)擊鏈接獲取。

制作靜態(tài)庫(kù)時(shí)，需要在Build Settings中設(shè)置靜態(tài)庫(kù)架構(gòu)支持。在Architectures下進(jìn)行設(shè)置，并確保在編譯時(shí)選擇Any iOS Device。遇到需要第三方庫(kù)的情況，如AFNetworking，如果uni遠(yuǎn)程未提供相應(yīng)的靜態(tài)庫(kù)，需要將其本地上傳。自制靜態(tài)庫(kù)依賴第三方庫(kù)時(shí)，需將第三方庫(kù)的.a文件添加至HBuilder-uniPlugin主工程，并在DCTestUniPlugin靜態(tài)庫(kù)工程下的Heard Search Paths中加入頭文件引入。

三、配置iOS原生插件的package.json

完成功能開(kāi)發(fā)后，下一步是本地插件包配置。具體的打包步驟可以參考鏈接。最終的文件目錄結(jié)構(gòu)如下：

1. WSLUniPlugin為整體文件，包含android和ios部分（官網(wǎng)上未明確標(biāo)注iOS）。

2. ios文件包含所有需要的第三方庫(kù)及自制靜態(tài)庫(kù)。

3. package.json包含相關(guān)配置，指示遠(yuǎn)程編譯加載哪些庫(kù)及庫(kù)的位置。其中還包括動(dòng)態(tài)庫(kù)的簽名配置（雖然可以自制動(dòng)態(tài)庫(kù)，但需進(jìn)行簽名）。這是iOS開(kāi)發(fā)中的重要環(huán)節(jié)，正確的配置能夠保證插件的正常運(yùn)行和安裝。

四、package.json目錄詳解

對(duì)于package.json目錄的詳解，更多內(nèi)容請(qǐng)參閱原文鏈接。這是理解插件配置和打包流程的關(guān)鍵部分，對(duì)于開(kāi)發(fā)者來(lái)說(shuō)，深入了解package.json的配置和使用方法，能夠更好地進(jìn)行插件的開(kāi)發(fā)和調(diào)試。

以上內(nèi)容，詳細(xì)闡述了成功獲取插件module的aar文件以及iOS端uniAPP原生插件的打包流程，包括靜態(tài)庫(kù)的設(shè)置和package.json的配置等關(guān)鍵環(huán)節(jié)。希望對(duì)于開(kāi)發(fā)者來(lái)說(shuō)，能夠提供幫助和參考，更好地推進(jìn)項(xiàng)目開(kāi)發(fā)進(jìn)程。