天天看點

鴻蒙應用上架全攻略(含常見問題)

使用鴻蒙開發工具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建立應用填寫的包名必須全網唯一,鴻蒙應用包名也不能和安卓應用包名重複,如果提示包名被占用,需要更換包名。

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送出上架。

為了確定HarmonyOS應用的完整性,HarmonyOS通過數字證書和Profile檔案來對應用進行管控。上架到華為應用市場的HarmonyOS應用也必須通過簽名才允許上架。是以需要使用釋出證書和Profile檔案對應用進行簽名後才能釋出。具體操作參考申請應用釋出證書和申請釋出Profile。

1.目前AGC最多可申請1個釋出證書;最多可申請100個Profile檔案。

2.釋出應用一定要使用釋出證書和釋出Profile檔案,并且釋出證書和Profile檔案要比對。如果使用調試證書和調試Profile檔案用于釋出場景将無法上傳軟體包。

3.申請釋出Profile檔案的應用一定要和釋出應用比對。

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

1.上傳的應用圖示,截圖,視訊等需要滿足應用市場要求,否則上傳失敗。

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

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

4.更新應用時僅允許增加裝置類型,不支援删除原有裝置類型。如在架版本選擇支援手機和大屏,更新應用必須保留手機和大屏裝置,但可以新增支援手表裝置。

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應用軟體包上傳後,提示“非法軟體包,請重新上傳”,如何處理?

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

檢查點:檢查編譯環境,是否使用了簽名檔案。或者是否有拆包再手動打包簽名操作,未正确簽名。

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