一、內(nèi)部測試概述
HarmonyOS 應(yīng)用內(nèi)部測試是面向企業(yè)開發(fā)者的功能，允許在不提交華為應(yīng)用市場審核的情況下，將應(yīng)用分發(fā)到最多 100 臺授權(quán)設(shè)備進(jìn)行測試。通過設(shè)備 UDID 授權(quán)機(jī)制，僅允許已注冊設(shè)備安裝使用，適用于開發(fā)團(tuán)隊內(nèi)共享應(yīng)用、提前測試功能及優(yōu)化版本體驗。當(dāng)前僅支持 Stage 模型開發(fā)的 HarmonyOS 應(yīng)用，暫不支持元服務(wù)。
二、準(zhǔn)備工作
開發(fā)者資質(zhì)：需注冊華為開發(fā)者賬號并完成企業(yè)開發(fā)者實名認(rèn)證。
三、內(nèi)部測試核心流程
申請發(fā)布證書
作用：由 AGC 頒發(fā)的數(shù)字證書，保障代碼完整性和發(fā)布者身份真實性，格式為.cer。
限制：每個賬號最多申請 3 個，有效期 3 年，到期后更新版本需更換證書。
流程：在 AGC“證書、APP ID 和 Profile> 證書” 頁面，上傳 DevEco Studio 生成的 CSR 文件申請，下載后保存至本地。
注冊測試設(shè)備
限制：每年最多注冊 100 臺設(shè)備，注冊后一年內(nèi)不可刪除，刪除后仍占用名額。
操作：通過設(shè)備 UDID（64 位字符串）在 AGC “設(shè)備” 頁面注冊，支持單個添加或批量導(dǎo)入（模板下載后填寫設(shè)備信息）。
申請內(nèi)部測試 Profile
作用：格式為.p7b，包含包名、證書、權(quán)限列表及授權(quán)設(shè)備信息，每個應(yīng)用包必須包含。
權(quán)限申請：
HarmonyOS API9 及以上：申請受限 ACL 權(quán)限（如輸入監(jiān)聽、剪貼板讀取等），需描述使用場景，審批通過后添加到 Profile。
API9 以下：僅支持申請讀取 / 寫入聯(lián)系人權(quán)限。
設(shè)備關(guān)聯(lián)：從已注冊設(shè)備中選擇最多 100 臺，后續(xù)可通過 “編輯設(shè)備” 修改。
配置簽名信息
在 DevEco Studio 中，使用私鑰（.p12）、發(fā)布證書（.cer）和 Profile（.p7b）配置工程簽名，取消 “自動生成簽名” 并填寫密鑰庫密碼、別名等信息。
編譯打包應(yīng)用
HAP 包：主模塊編譯后在 “build/default/outputs/default” 目錄獲取。
HSP 包：共享包模塊通過 “Make Module” 生成，用于應(yīng)用內(nèi)共享資源。
上傳應(yīng)用包與生成描述文件
服務(wù)器要求：支持 HTTPS 協(xié)議，配置分片下載（返回碼 206）和正確響應(yīng)頭（如 Content-Type: application/hap）。
描述文件：JSON 格式，包含 bundleName、versionCode、modules 等信息，需計算包的 SHA256 值并簽名，上傳后獲取下載 URL。
構(gòu)造 DeepLink 拉起安裝
格式：store://enterprise/manifest?url=https://xxx.xxx/xxx.json5，需使用華為瀏覽器點擊觸發(fā)，URL 需編碼特殊字符。
示例：通過 HTML 按鈕調(diào)用window.open()方法觸發(fā) DeepLink。
四、錯誤碼與解決方案
下載錯誤碼
10000：DeepLink 格式錯誤，需確保 URL 以.json5 結(jié)尾且域名與 deployDomain 一致。
10019：描述文件驗簽失敗，檢查簽名密鑰與安裝包簽名是否一致。
10021：證書校驗失敗，確認(rèn)設(shè)備 UDID 在 Profile 授權(quán)列表內(nèi)。
安裝錯誤碼
參考 OpenHarmony 官方文檔，常見問題如包完整性校驗失敗（10020）、證書不匹配等。
五、FAQ
應(yīng)用已過期
內(nèi)部測試版本有效期 90 天，需更新版本號后重新編譯打包。
無法打開應(yīng)用
安裝設(shè)備超過 100 臺限制，需刪除未使用設(shè)備或創(chuàng)建新 Profile。
六、關(guān)鍵限制與最佳實踐
設(shè)備管理：定期清理無效設(shè)備，超過一年刪除的設(shè)備自動釋放名額。
權(quán)限申請：優(yōu)先使用系統(tǒng)控件（如 Picker）替代受限權(quán)限，避免上架審核駁回。
版本管理：每次更新 Profile 后需重新下載并配置簽名，確保設(shè)備列表及時更新。
##HarmonyOS應(yīng)用測試##商務(wù)##
