鴻蒙應用上架全攻略（含常見問題）

• 2021 年 12 月 7 日
• 筆記

開發應用

使用鴻蒙開發工具HUAWEI DevEco Studio完成鴻蒙應用的開發。詳細的開發過程可以參考HarmonyOS開發文檔。

這部分由開發者自行完成。

創建應用

鴻蒙應用開發好後，不管是調試還是發布應用，首先都需要在AGC創建鴻蒙應用。當前鴻蒙應用創建是受邀名單管控。

根據開發者帳號狀態，創建應用方式不同。

如果想申請申請鴻蒙應用受邀名單，可參考下文開發者已實名章節。

開發者未實名

1.登錄AGC會提示如下頁面，點擊「去體驗」後跳轉到「項目設置 > HarmonyOS應用 > 管理HAP Provision Profile」頁面：

2.點擊「HarmonyOS應用」，在「添加應用」窗口中進行HarmonyOS應用創建。

開發者已實名

1.如果已經申請鴻蒙應用受邀名單，AGC頁面「我的應用」下會出現「HarmonyOS應用」頁簽。

選中「HarmonyOS應用」，即可創建鴻蒙應用，具體參見直接創建應用。也可以在「我的項目」下添加創建鴻蒙應用，具體參見在項目下添加應用。

2.如果未申請鴻蒙應用受邀名單，則只能在「我的項目」下添加創建鴻蒙應用。也只能進行應用的調試，無法發布應用。

如您需加入受邀名單，請將開發者名稱、申請背景、支援設備類型及Developer ID發送至[email protected]，華為運營人員將在1-3個工作日內為您安排對接人員。Developer ID查詢方法請參見查詢開發者帳號ID及項目ID。

• 注意點：

1.AGC創建應用填寫的包名必須全網唯一，鴻蒙應用包名也不能和Android應用包名重複，如果提示包名被佔用，需要更換包名。

2.直接創建鴻蒙應用不需要填寫包名，通過上傳的軟體包自動解析。在項目下添加鴻蒙應用必須填寫包名。

3.在項目下可以添加已有的應用，選擇應用後不要修改應用名稱，否則會認為是新建應用。

調測應用

鴻蒙應用開發完成後，且已經在AGC完成應用的創建，就可以開始進行調試了。如果僅僅在模擬器中調試，可以不配置簽名資訊；但如果需要在真機中調試，必須配置簽名資訊。華為提供了兩種應用調試（簽名）方法：自動化簽名方式和手動簽名方式。

自動簽名

直接在開發工具HUAWEI DevEco Studio中完成自動化簽名並調試，具體參見自動化簽名。

注意點：

1.如果IDE沒有自動簽名選項，建議升級IDE至最新版本。自動簽名特性僅在DevEco Studio V2.1 Release及更高版本中支援。

2.自動化簽名的調試方式會自動在AGC中創建用於調試的數字證書和Profile文件，但當前AGC調試證書最多僅支援2個，即最多同時只支援為兩個應用進行自動化調試，如已達到上限，需要在「用戶與訪問 > 證書管理」頁面中「廢除」多餘的調試證書文件。

3.調試設備最多支援100個。

4.鴻蒙應用的config.json文件中的「bundleName」取值必須和AGC應用包名保持一致，如包名衝突，可以修改bundleName進行規避。

5.如果報錯連接AGC網站失敗，請檢查是否使用代理等，可以斷開代理重試。

手動簽名

通過登錄AGC網站申請調試證書和調試Profile文件，下載到本地後再在IDE中進行簽名，具體參見手動簽名。

相關流程如下：

注意點：

1.本地調試一定要使用調試證書和調試Profile文件，並且調試證書和Profile文件要匹配。如果使用發布證書和發布Profile文件用於調試場景將會導致應用無法安裝。

2.當前AGC調試證書最多僅支援2個，如已達到上限，需要在「用戶與訪問 > 證書管理」頁面中「廢除」多餘的調試證書文件。

3.申請調試Profile文件的應用一定要和本地調試的應用匹配。

發布應用

本地調試完畢後，可以打包HarmonyOS應用，在AGC提交上架。

申請發布證書和發布Profile文件

為了確保HarmonyOS應用的完整性，HarmonyOS通過數字證書和Profile文件來對應用進行管控。上架到華為應用市場的HarmonyOS應用也必須通過簽名才允許上架。因此需要使用發布證書和Profile文件對應用進行簽名後才能發布。具體操作參考申請應用發布證書和申請發布Profile。

注意點：

1.當前AGC最多可申請1個發布證書；最多可申請100個Profile文件。

2.發布應用一定要使用發布證書和發布Profile文件，並且發布證書和Profile文件要匹配。如果使用調試證書和調試Profile文件用於發布場景將無法上傳軟體包。

3.申請發布Profile文件的應用一定要和發布應用匹配。

打包HarmonyOS應用

打包HarmonyOS應用主要是在HUAWEI DevEco Studio中配置好在AGC下載好的發布證書和發布Profile，然後編譯生成軟體包。具體參考配置簽名資訊和編譯構建APP。

注意點：

1.上傳的應用圖標，截圖，影片等需要滿足應用市場要求，否則上傳失敗。

2.如果需要提前小範圍測試應用，可以選擇開放式測試版本發布。

3.上傳素材或軟體包需要純公網環境，使用代理等需要斷開連接。

4.升級應用時僅允許增加設備類型，不支援刪除原有設備類型。如在架版本選擇支援手機和大屏，升級應用必須保留手機和大屏設備，但可以新增支援手錶設備。

上傳軟體包失敗FAQ

1.HarmonyOS應用軟體包上傳後，提示「您上傳的軟體包使用的HarmonyAppProvision和證書不匹配，要求修改後再重新上傳」，如何處理？

原因：HarmonyOS應用軟體包中的發布證書與發布Profile文件中的發布證書不匹配。

排查點：確認IDE打包時使用的發布證書是否與您申請發布Profile所使用的發布證書一致。

2.HarmonyOS應用軟體包上傳後，提示「HarmonyOS hapAppProvision文件非法，請重新上傳」，如何處理？

原因：HarmonyOS應用軟體包中的發布Profile文件和當前上傳軟體包的應用不匹配。

排查點：確保軟體包中使用的Profile文件是在當前應用下下載的。

常見錯誤場景是軟體包中的Profile文件使用的是在A應用下下載的，但是卻在B應用下上傳軟體包。如下：

3.HarmonyOS應用軟體包上傳後，提示「HarmonyOS軟體包內不同文件包名不一致，請重新上傳」，如何處理？

原因：HarmonyOS應用軟體包內有.hap包的包名與發布Profile中的包名不一致。

排查點：確保HarmonyOS應用軟體包內所有.hap包的包名一樣，且與發布Profile中的包名一致。

hap包名為config.json文件中的bundleame欄位值：

4.HarmonyOS應用軟體包上傳後，提示「軟體包解析失敗，請重新上傳」，如何處理？

原因：可能是IDE編譯出來的軟體包有問題。

檢查點：查看.app包里的.hap包數量和pack.info中設備數量是否一致。如果數量不一致，可以在HUAWEI DevEco Studio中Clean Project後重新編譯打包。

5.HarmonyOS應用軟體包上傳後，提示「您上傳的HarmonyOS應用軟體包使用的HarmonyAppProvision類型錯誤，請修改為發布類型後重新上傳」，如何處理？

原因：軟體包中使用的是調試證書和調試Profile。

檢查點：查看軟體包使用的證書類型，正式上架應用市場請使用發布證書和發布Profile。

6.HarmonyOS應用軟體包上傳後，提示「非法軟體包，請重新上傳」，如何處理？

原因：可能是軟體包未簽名。

檢查點：檢查編譯環境，是否使用了簽名文件。或者是否有拆包再手動打包簽名操作，未正確簽名。

更多精彩內容，請見華為開發者官方論壇→//developer.huawei.com/consumer/cn/forum/home?ha_source=sanfang