鴻蒙混合打包，在現(xiàn)有安卓應(yīng)用的基礎(chǔ)上擴(kuò)展鴻蒙的特性，以最快的速度布局鴻蒙生態(tài)！

本項(xiàng)目只是《京東 APP 鴻蒙版上架實(shí)踐》這篇文章的一個(gè)驗(yàn)證，讓更多的兄弟們可以少走彎路。

我盡可能把每一步的改動(dòng)作為一個(gè) commit，這樣方便大家看代碼。

開(kāi)發(fā)步驟

①準(zhǔn)備 Android 工程

本示例中，我用 AS 建了一個(gè) Hello World 工程。

②Android 工程改造

這一步，有兩點(diǎn)要注意的：

abilityshell_ide_java.jar 在這里，自行 copy 到安卓工程中。

注意 apk 文件名必須是 xxx-entry.apk 這種格式。

③準(zhǔn)備鴻蒙工程

本示例中，我用 DevEco Studio 建了一個(gè) Hello World 工程。

④配置鴻蒙工程

這一步，有三點(diǎn)要注意的：

簽名就不要轉(zhuǎn)了，直接重新創(chuàng)建，只要秘鑰和別名和 Android 的保持不變。（如果在模擬器上運(yùn)行，不配置簽名也能跑起來(lái)）

鴻蒙的 version 和 apk 的 version 要一致。

config.json 的 app 節(jié)點(diǎn)下，增加 relatedBundleName 而不是 originalName。

config.json 里都支持哪些字段，沒(méi)必要看文檔，只要按住 ctrl 點(diǎn)擊相應(yīng)的字段，就可以看到，比如點(diǎn)擊 app 字段。

⑤卡片

本示例中，我用 DevEco Studio 建了一個(gè)名為 mycard 的 module，并且勾選“show in service center”，這樣這個(gè)卡片就可以顯示在“服務(wù)中心”了。

有幾點(diǎn)需要說(shuō)明：

必須簽名（我的驗(yàn)證結(jié)果是這樣的），所以要有真機(jī)。我提交的簽名文件是綁定我的機(jī)器，所以你要更新自己的簽名文件。

卡片的 config.json 的 app 字段要和 entry 的 app 字段完全一致（relatedBundleName 字段只在 entry 里有就可以，卡片里不寫(xiě)也行）。

多 module 的工程，運(yùn)行的時(shí)候要勾選 Deploy Multi Hap Packages。

為什么把卡片放在獨(dú)立的 module 里？因?yàn)榛旌洗虬拢琫ntry 只是一個(gè)殼，我們可以把 entry 當(dāng)作 apk 的占位，所以 entry 里的內(nèi)容都不會(huì)打到 appj 里，鴻蒙相關(guān)的功能代碼我們只能放在獨(dú)立的 module 中。（當(dāng)然，這也是我的驗(yàn)證結(jié)果，最終要等華為官方更明確的文檔解釋?zhuān)?/p>

⑥鴻蒙打開(kāi) apk 中的 activity

請(qǐng)參考京東 APP 鴻蒙版上架實(shí)踐：

⑦鴻蒙打開(kāi) apk 中的 activity，并傳遞參數(shù)

鴻蒙 IntentParams 對(duì)應(yīng)安卓 Bundle，相應(yīng)的 api：

//ohos put：

IntentParams params = new IntentParams（）;

params.setParam（“androidFile1”，“androidFile1----”）;

intent.setParams（params）;

//android put：

Intent intent = new Intent（）;

intent.putExtra（“androidFile1”，“androidFile1----”）;

//get：

intent.getStringExtra（“androidFile1”）;

鴻蒙 Uri 對(duì)應(yīng)安卓 Uri，鴻蒙 Entity 對(duì)應(yīng)安卓 Category，相應(yīng)的 api：

//ohos put:Set《String》 entities = new HashSet《》（）;

entities.add（“entity.user.c1”）;

Operation operation = new Intent.OperationBuilder（）

.withUri（Uri.parse（“https://www.baidu.com”））

.withEntities（entities）

.build（）;

//android put：

Intent intent = new Intent（）;

intent.setData（Uri.parse（“https://www.baidu.com”））;

intent.addCategory（“entity.user.c1”）;

//get：

intent.getData（）;

intent.getCategories（）;

常見(jiàn)問(wèn)題（歡迎評(píng)論區(qū)補(bǔ)充）

Failure［INSTALL_FAILED_INCONSISTENT_BUNDLE_VERSION］

混合打合時(shí)要和 apk 的 version 一致。

Failure［INSTALL_FAILED_RESTRICTED_PERMISSIONS_NOT_GRANTED］

沒(méi)有繼承 HarmonyApplication 或者沒(méi)有配置到 AndroidManifest.xml 中。

Failure［INSTALL_FAILED_INTERNAL_ERROR］

確認(rèn)一下：

在AndroidManifest.xml中，向根節(jié)點(diǎn)下增加。

《uses-feature android:name=“zidane.software.ability” android:required=“false” /》

向application節(jié)點(diǎn)下新增子節(jié)點(diǎn)。

《meta-data android:name=“permZA” android:value=“true” /》

《meta-data android:name=“multiFrameworkBundle” android:value=“true” /》

編輯：jq