鴻蒙 HarmonyOS App 如何內(nèi)測分發(fā)

隨著鴻蒙系統(tǒng)（HarmonyOS）生態(tài)的快速發(fā)展，越來越多的開發(fā)者開始構建純血鴻蒙應用（HarmonyOS Native）。為支持開發(fā)者高效完成內(nèi)測流程，蒲公英內(nèi)測分發(fā)平臺現(xiàn)已全面支持鴻蒙 App（.hap 文件）的上傳、驗證與分發(fā)，幫助測試人員便捷下載安裝體驗。

一、鴻蒙 HarmonyOS App 簡介

HarmonyOS 是華為推出的新一代多設備操作系統(tǒng)，支持手機、平板、可穿戴等多種終端。開發(fā)者通過 ArkTS 編程語言構建的原生鴻蒙應用，以 .hap 為打包格式，并采用鴻蒙官方提供的證書機制進行簽名和驗證。

.hap 是鴻蒙系統(tǒng)的可安裝應用包（類似 Android 的 .apk）；
每個 .hap 必須經(jīng)過簽名，才能在 HarmonyOS 設備上安裝；
簽名使用的證書為 .p12 格式，需來自華為開發(fā)者賬號。

簽名分為三部分：

對 hap 本體簽名（用戶在本地完成，蒲公英不參與）；
對 p7b 文件簽名（即 Profile 文件） (用戶在本地或華為 AppGallery Connect 完成，蒲公英不參與)
對 manifest.json5 文件簽名（用戶需將 p12 文件上傳到蒲公英平臺后，蒲公英平臺完成此步驟）；

注意：以上三部分簽名需要完全一致才可正確安裝 App

二、在蒲公英平臺分發(fā)鴻蒙 App 的操作流程

第一步：上傳已簽名的 `.hap` 文件

用戶需在本地使用開發(fā)者證書完成 .hap 文件的簽名。上傳至蒲公英的平臺版本必須為已簽名版本。

上傳前請確保：

.hap 文件已使用簽名工具簽名，如華為官方開發(fā)工具 DevEco-Studio，具體方法請見華為官方文檔：編譯打包應用，正確簽名后，工具一般會生成名稱為 XXXX-signed.hap 的文件；
對 .hap 簽名所用的 .p12 證書與即將上傳至蒲公英平臺的 .p12 文件完全一致；
目前支持鴻蒙的 .hap 文件。

準備上傳

第二步：填寫 App 信息（可選）

便于測試人員識別應用，可選擇填寫以下信息：

應用名稱、版本號（蒲公英會自動解析并顯示）
更新日志
應用截圖
內(nèi)測說明

這些信息將在分發(fā)頁面中顯示，提升專業(yè)度與可讀性。

填寫App信息

第三步：上傳 `.p12` 文件并設置其密碼（用于 manifest.json5 簽名）

在鴻蒙內(nèi)測流程中，蒲公英平臺會自動生成內(nèi)測分發(fā)所需的manifest.json5文件，且需對 manifest.json5 文件進行簽名，以生成有效的安裝元數(shù)據(jù)。因此，開發(fā)者（您）需向蒲公英平臺提供與 .hap 同源的 .p12 證書及其密碼：

.p12 證書您可以在華為開發(fā)者平臺的 AppGallery Connect 中的 “證書、APP ID和Profile” 中進行下載；
此證書必須與您在第一步中上傳的 .hap 文件本身簽名使用的證書一致，否則會導致安裝失?。?/li>
蒲公英不會對 .hap 本體進行簽名，僅用于 manifest.json5 文件簽名。

上傳p12證書

為什么需要 `.p12`？

這是華為規(guī)定的驗證機制之一。用戶側的 HarmonyOS 設備會校驗 manifest.json5 文件簽名，確保來源可信。詳見：華為官方文檔

第四步：獲取分發(fā)鏈接，下載安裝

完成上傳后，蒲公英會自動生成一個可供下載的鏈接和二維碼：

可通過鏈接或掃碼進行下載；
支持分享到微信、郵件、釘釘?shù)确绞剑?/li>
僅支持在 純血 HarmonyOS NEXT 系統(tǒng)設備中通過瀏覽器下載安裝。

目前 .hap 文件的安裝行為受到系統(tǒng)安全策略限制，推薦使用華為自帶瀏覽器打開下載頁面。

三、常見問題答疑

Q1：上傳 `.hap` 后安裝失敗，提示無法安裝“XXXXXX”？

出現(xiàn)此問題，通常與簽名或配置不當有關。請逐項檢查以下內(nèi)容：

簽名相關檢查

.hap 必須為已簽名的包，不能為未簽名的包。例如，對于 entry 模塊 DevEco Studio 會在 /entry/build/default/outputs/default 目錄下生成 xxx-signed.hap 和 xxx-unsigned.hap 的包，此時您應該使用 xxx-signed.hap 這個包；
簽名 .hap 文件時使用的 .p12 文件，必須和您在前述步驟中上傳到蒲公英平臺的 .p12 文件為同一個；
在蒲公英平臺上傳 .p12 文件后，是否輸入了正確的密碼。目前，如果您輸入了不正確的密碼，蒲公英平臺會進行提示；
.p12 必須為 發(fā)布證書，不能使用調(diào)試證書。查看如何申請發(fā)布證書

Profile (.p7b) 檢查

簽名 .hap 文件時所用的 Profile 類型必須為 內(nèi)部調(diào)試 類型。目前，如果您上傳了安裝包后，如果安裝包中的 Profile 文件類型如果不是 內(nèi)部調(diào)試 類型時，蒲公英平臺的控制臺中會顯示 Profile 錯誤。具體請查看文檔申請內(nèi)部調(diào)試類型 Profile
Profile 必須包含當前測試設備的 UDID。點擊查看 UDID 獲取方法

進一步排查

如果以上均無誤，建議根據(jù)安裝失敗時出現(xiàn)的 錯誤碼，前往華為錯誤碼目錄進行查詢，以獲得更具體的排查建議。

Q2：一個鏈接支持多人下載安裝嗎？

支持。下載鏈接可分享給多個測試用戶，平臺支持安裝統(tǒng)計、設備識別等功能。

Q3：平臺是否對 `.hap` 文件做修改？

不會。蒲公英平臺不會修改 .hap 文件本體，僅用于對 manifest 文件進行簽名處理，確保安裝成功。

Q4：是否支持 API 上傳？

支持。蒲公英提供了 API 用于上傳 App 文件，另外，對于鴻蒙 App 來說，首個 App 上傳完成后，還需調(diào)用 API 上傳 p12 文件。具體可見 API 文檔

Q5：是否支持上傳 hsp 文件？

支持。您需要先上傳 hap 文件，之后在 應用管理 中可以找到上傳 hsp 文件的入口。

四、更多參考

如需了解鴻蒙官方對內(nèi)測分發(fā)的完整說明，請參考：華為官方文檔：HarmonyOS 應用內(nèi)測分發(fā)指南

如在操作過程中有任何疑問，歡迎隨時聯(lián)系蒲公英平臺客服或技術支持團隊。

Doc index

Problems encountered, contact us →

免费AV高清无码一本大道_超碰CAO草棚GAO进入_暴力强奷日本护士90分钟_国产的乱人伦视频免费观看_亚洲成人精品三区_蜜桃黄色网站在线观看_欧美国产一区在线_日韩精品亚洲午夜_黄色软件观看_2020久久精品永久

鴻蒙 HarmonyOS App 如何內(nèi)測分發(fā)

一、鴻蒙 HarmonyOS App 簡介

二、在蒲公英平臺分發(fā)鴻蒙 App 的操作流程

第一步：上傳已簽名的 .hap 文件

第二步：填寫 App 信息（可選）

第三步：上傳 .p12 文件并設置其密碼（用于 manifest.json5 簽名）

為什么需要 .p12？

第四步：獲取分發(fā)鏈接，下載安裝

三、常見問題答疑

Q1：上傳 .hap 后安裝失敗，提示無法安裝“XXXXXX”？

Q2：一個鏈接支持多人下載安裝嗎？

Q3：平臺是否對 .hap 文件做修改？