開發應用
使用鴻蒙開發工具HUAWEI DevEco Studio完成鴻蒙應用的開發。詳細的開發過程可以參考HarmonyOS開發文檔。
這部分由開發者自行完成。
創建應用
鴻蒙應用開發好后,不管是調試還是發布應用,首先都需要在AGC創建鴻蒙應用。當前鴻蒙應用創建是受邀名單管控。
根據開發者賬號狀態,創建應用方式不同。
如果想申請申請鴻蒙應用受邀名單,可參考下文開發者已實名章節。
開發者未實名
1.登錄AGC會提示如下頁面,點擊“去體驗”后跳轉到“項目設置 > HarmonyOS應用 > 管理HAP Provision Profile”頁面:
2.點擊“HarmonyOS應用”,在“添加應用”窗口中進行HarmonyOS應用創建。
開發者已實名
1.如果已經申請鴻蒙應用受邀名單,AGC頁面“我的應用”下會出現“HarmonyOS應用”頁簽。
選中“HarmonyOS應用”,即可創建鴻蒙應用,具體參見直接創建應用。也可以在“我的項目”下添加創建鴻蒙應用,具體參見在項目下添加應用。
2.如果未申請鴻蒙應用受邀名單,則只能在“我的項目”下添加創建鴻蒙應用。也只能進行應用的調試,無法發布應用。
如您需加入受邀名單,請將開發者名稱、申請背景、支持設備類型及Developer ID發送至agconnect@huawei.com,華為運營人員將在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提交上架。
申請發布證書和發布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應用軟件包上傳后,提示“非法軟件包,請重新上傳”,如何處理?
原因:可能是軟件包未簽名。
檢查點:檢查編譯環境,是否使用了簽名文件。或者是否有拆包再手動打包簽名操作,未正確簽名。
更多精彩內容,請見華為開發者官方論壇→https://developer.huawei.com/consumer/cn/forum/home?ha_source=sanfang