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

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

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

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

調試簽名文件需要指定設備，即指定哪幾個設備可以安裝此簽名的安裝包。

正式的簽名文件不需要指定設備，但使用正式簽名打出的安裝包是不能直接安裝到真機上的，這個會在后面的安裝步驟介紹。而安裝包也并不能在設備上直接點擊安裝。

下面可以看一下如何將 HarmonyOS 應用打包并安裝到真機上。

配置簽名

配置簽名需要 3 個文件：

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

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

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

配置的代碼如下：

debug {

storeFile file（‘xxxx.p12’）

storePassword ‘***’

keyAlias = ‘debugKey’

keyPassword ‘****’

signAlg = ‘SHA256withECDSA’

profile file（‘xxxx.p7b’）

certpath file（‘xxxx.cer’）

}

①通過 DevEco 自動配置簽名

使用此種配置方式只能配置調試簽名文件，且前提是要有一臺 HarmonyOS 系統(tǒng)的設備連接到電腦。需要設備連接是因為調試簽名文件需要指定設備。

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

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

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

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

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

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

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

創(chuàng)建 HarmonyOS 時選擇項目左側菜單的 HarmonyOS 應用進行創(chuàng)建

c.自動填充簽名信息

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

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

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

②手動配置簽名

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

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

流程主要為以下 4 步：

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

申請證書文件（.cer 文件）

申請 HAP Provision Profile 文件（.p7b 文件）

手動配置簽名信息

打包

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

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

①使用 gralde 命令打包：

。/gradlew entry:assembleRelease

②使用 gradle 面板打包

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

安裝

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

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

Failure［INSTALL_FAILED_APP_SOURCE_NOT_TRUSTED］

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

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

使用 hdc 安裝 hap 的命令為：

hdc install -p xxx.hap

總結

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

生成簽名文件：

簽名文件必須經過華為認證

使用調試簽名文件簽名的安裝包只能安裝到指定的設備

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

簽名文件不能共用，每個應用都需要配置一個簽名文件

安裝：

安裝包不能手動點擊安裝，只能通過 bm install 進行安裝

編輯：jq