寫了一個(gè) HarmonyOS 應(yīng)用后最大的心愿就是把它安裝到真機(jī)上，或發(fā)送給其他的小伙伴安裝到真機(jī)上運(yùn)行。

想要在真機(jī)上運(yùn)行，真的沒有 Android 那么簡(jiǎn)單。難點(diǎn)主要體現(xiàn)在配置簽名及安裝上。

配置簽名需要簽名文件，而簽名文件必須經(jīng)過華為官網(wǎng)才能生成。

簽名區(qū)分調(diào)試簽名與正式簽名：

調(diào)試簽名文件需要指定設(shè)備，即指定哪幾個(gè)設(shè)備可以安裝此簽名的安裝包。

正式的簽名文件不需要指定設(shè)備，但使用正式簽名打出的安裝包是不能直接安裝到真機(jī)上的，這個(gè)會(huì)在后面的安裝步驟介紹。而安裝包也并不能在設(shè)備上直接點(diǎn)擊安裝。

下面可以看一下如何將 HarmonyOS 應(yīng)用打包并安裝到真機(jī)上。

配置簽名

配置簽名需要 3 個(gè)文件：

xxxx.p12：密鑰文件，可本地生成

xxxx.p7b：HAP Provision Profile文件，需要從華為應(yīng)用網(wǎng)站創(chuàng)建并下載

xxxx.cer：數(shù)字證書，需要從華為應(yīng)用網(wǎng)站創(chuàng)建并下載

配置的代碼如下：

debug {

storeFile file（‘xxxx.p12’）

storePassword ‘***’

keyAlias = ‘debugKey’

keyPassword ‘****’

signAlg = ‘SHA256withECDSA’

profile file（‘xxxx.p7b’）

certpath file（‘xxxx.cer’）

}

①通過 DevEco 自動(dòng)配置簽名

使用此種配置方式只能配置調(diào)試簽名文件，且前提是要有一臺(tái) HarmonyOS 系統(tǒng)的設(shè)備連接到電腦。需要設(shè)備連接是因?yàn)檎{(diào)試簽名文件需要指定設(shè)備。

a.在 AppGallery Connect 網(wǎng)站建項(xiàng)目

AppGallery Connect 網(wǎng)站連接為：

https://developer.huawei.com/consumer/cn/service/josp/agc/index.html

不用點(diǎn)擊或復(fù)制鏈接進(jìn)入網(wǎng)站，可根據(jù)使用真機(jī)調(diào)試文檔的指引進(jìn)入：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404#section793484619307

這里需要特別注意，不能直接從“我的應(yīng)用”圖標(biāo)進(jìn)入，直接創(chuàng)建應(yīng)用。從“我的應(yīng)用”進(jìn)入創(chuàng)建不了 HarmonyOS 應(yīng)用。只能從“我的項(xiàng)目”進(jìn)入，創(chuàng)建項(xiàng)目后再創(chuàng)建 HarmonyOS 應(yīng)用。

b.在新建項(xiàng)目里創(chuàng)建 HarmonyOS 應(yīng)用

創(chuàng)建 HarmonyOS 時(shí)選擇項(xiàng)目左側(cè)菜單的 HarmonyOS 應(yīng)用進(jìn)行創(chuàng)建

c.自動(dòng)填充簽名信息

完成以上兩步可以再根據(jù)使用真機(jī)調(diào)試文檔里的介紹進(jìn)行處理即可：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404#section793484619307

需要注意的是一定要在此界面勾選自動(dòng)填充，即下圖的“Automatically generate singing”選項(xiàng)，在網(wǎng)站創(chuàng)建應(yīng)用后，回到此彈窗，點(diǎn)擊下方的重試按鈕或重新進(jìn)入此頁(yè)面，都會(huì)自動(dòng)填充簽名信息的。

②手動(dòng)配置簽名

手動(dòng)配置主要有以下 3 步，具體的可參考應(yīng)用發(fā)布文檔：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section793484619307

流程主要為以下 4 步：

創(chuàng)建密鑰文件（.p12 文件）和證書請(qǐng)求文件（.csr 文件）

申請(qǐng)證書文件（.cer 文件）

申請(qǐng) HAP Provision Profile 文件（.p7b 文件）

手動(dòng)配置簽名信息

打包

使用 gradle 命令或直接在 gradle 面板執(zhí)行打包任務(wù)即可。生成的 hap 文件位于 build/outputs/hap/release/ 目錄下。

注意，這里示意的為打 release 包，若打發(fā) debug 包，把 release 換成 debug 即可。

①使用 gralde 命令打包：

。/gradlew entry:assembleRelease

②使用 gradle 面板打包

打開 DevEco Studio 右上方的 gradle 面板，選擇 assembleRelease，雙擊運(yùn)行即可。

安裝

目前測(cè)試發(fā)現(xiàn)只能安裝 Debug 包，且只能通過 hdc 命令進(jìn)行安裝。

使用發(fā)布證書打包出來(lái)的 release 安裝包，安裝時(shí)會(huì)提示以下錯(cuò)誤信息，也就是設(shè)備不信任你的安裝包，即使你的證書上在華為官網(wǎng)申請(qǐng)的也不行，可能是必須得上架到應(yīng)用市場(chǎng)才可以吧。

Failure［INSTALL_FAILED_APP_SOURCE_NOT_TRUSTED］

將 hap 復(fù)制到手機(jī)上手，不能像 Android 程序一樣，點(diǎn)擊安裝包進(jìn)行安裝，系統(tǒng)不識(shí)別這種文件格式，會(huì)彈窗提示讓選擇打開的程序。

如果選擇“應(yīng)用”，則提示“解析安裝包失敗”，這個(gè)提示很像是 Android 系統(tǒng)彈出的，而且選擇打開的程序彈窗也像是 Android 系統(tǒng)的彈窗。

使用 hdc 安裝 hap 的命令為：

hdc install -p xxx.hap

總結(jié)

打包 hap 及安裝到手機(jī)的流程與 Android 沒有太大區(qū)別，而異同點(diǎn)主要體現(xiàn)在流程中的生成簽名文件和安裝上。

生成簽名文件：

簽名文件必須經(jīng)過華為認(rèn)證

使用調(diào)試簽名文件簽名的安裝包只能安裝到指定的設(shè)備

使用正式簽名文件簽名的安裝包不能直接安裝到真機(jī)，需要發(fā)布到應(yīng)用市場(chǎng)才行

簽名文件不能共用，每個(gè)應(yīng)用都需要配置一個(gè)簽名文件

安裝：

安裝包不能手動(dòng)點(diǎn)擊安裝，只能通過 bm install 進(jìn)行安裝

編輯：jq