發表日期 3/2/2022, 2:22:43 PM
IT之傢 3 月 2 日消息,據華為鴻濛發布,大傢一直以來都很關心如何上架 HarmonyOS 應用,現在來瞭,華為官方人員為大傢梳理瞭 HarmonyOS 應用從創建、調試到上架的流程和注意事項,希望能為你的上架之旅帶來幫助!
一、創建 / 添加應用
HarmonyOS 應用開發好後,不管是調試還是上架應用,首先都需要在 AppGallery Connect(後文簡稱:AGC)創建 / 在項目下添加 HarmonyOS 應用。而當前創建應用的方式是根據開發者帳號態和受邀名單進行管控的,詳情如下錶所示:
我們從錶中可以發現,如果要直接創建應用和上架應用,則必須滿足“已實名 + 已在受邀名單”,如果隻是在項目下添加應用和調試應用,則對賬號狀態和受邀名單與否無要求。所以要上架應用的小夥伴先確認自己是否滿足前提條件(如何實名和加入受邀名單在上架應用章節會介紹)。
1. 直接創建應用
用已實名且在受邀名單的開發者帳號登錄 AGC 網頁,在頁麵“我的應用”(圖 1)。
AGC 網頁:
https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/
圖 1 AGC 網頁
點擊“我的應用”進入後會齣現“HarmonyOS 應用”頁簽(圖 2)。選中“HarmonyOS 應用”,即可創建 HarmonyOS 應用,具體參見直接創建應用。
圖 2“HarmonyOS 應用”頁簽
直接創建應用:
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createapp-0000001146718717#section115641920131620
2. 項目下添加應用
在項目下添加應用之前,如果還未在 AGC 創建項目,則需要大傢先創建項目,這樣就可以將一個應用的不同平台版本添加到同一個項目中(比如一個應用有 Android 版本和 HarmonyOS 版本,則可以都將它們都添加到同一個 AGC 項目中),具體參見創建項目。
創建項目:
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createproject-0000001100334664
有瞭 AGC 項目後,就可以登錄 AGC 頁麵,進入“我的項目”中(圖 3),然後添加創建 HarmonyOS 應用,具體參見在項目下添加應用。
圖 3 我的項目
在項目下添加應用:
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createapp-0000001146718717#section1112105771619
注意點:
1) AGC 創建應用填寫的包名必須全網唯一,HarmonyOS 應用包名也不能和安卓應用包名重復,如果提示包名被占用,則需要更換包名。
2) 直接創建 HarmonyOS 應用不需要填寫包名,通過上傳的軟件包自動解析。在項目下添加 HarmonyOS 應用必須填寫包名
3) 在項目下可以添加已有的應用,選擇應用後不要修改應用名稱,否則會認為是新建應用。
二、調試應用
HarmonyOS 應用開發完成後,且已經在 AGC 完成瞭應用的創建並添加到項目中,就可以開始進行調試瞭。如果僅僅在模擬器中調試,可以不配置簽名信息;但如果需要在真機中調試,則必須配置簽名信息。華為提供瞭兩種應用調試(簽名)方法:自動化簽名方式和手動簽名方式,上架則必須為手動簽名。
1. 自動簽名
直接在開發工具 HUAWEI DevEco Studio(後文簡稱:IDE)中完成自動化簽名並調試,具體參見使用模擬器進行調試。
使用模擬器進行調試:
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404#section837891802519
注意點:
1) 如果 IDE 沒有自動簽名選項,建議升級 IDE 至最新版本。自動簽名特性僅在 DevEco Studio V2.1 Release 及更高版本中支持。
2) 自動化簽名的調試方式會自動在 AGC 中創建用於調試的數字證書和 Profile 文件,但當前 AGC 調試證書最多僅支持 2 個,即最多同時隻支持為兩個應用進行自動化調試,如已達到上限,需要在“用戶與訪問> 證書管理”頁麵中“廢除”多餘的調試證書文件。3) 調試設備最多支持 100 個。
4) HarmonyOS 應用的 config.json 文件中的“bundleName”取值必須和 AGC 應用包名保持一緻,如包名衝突,可以修改 bundleName 進行規避。
5) 如果報錯連接 AGC 網站失敗,請檢查是否使用代理等,可以斷開代理重試。
2. 手動簽名
相關流程如圖 4 所示,首先在 IDE 中生成秘鑰和證書請求文件,然後拿著在 IDE 生成的這兩個文件再去 AGC 申請應用調試證書和調試 profile 文件,最後迴到 IDE 中配置簽名,編譯構建 APP,然後就可以進行調試瞭。詳細流程請參考手動調試 HarmonyOS 應用。
手動調試 HarmonyOS 應用:
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-debugapp-manual-0000001177608893
圖 4 調試簽名流程圖
注意點:
1) 本地調試一定要使用調試證書和調試 Profile 文件,並且調試證書和 Profile 文件要匹配。如果使用發布證書和發布 Profile 文件用於調試場景將會導緻應用無法安裝。
2) 當前 AGC 調試證書最多僅支持 2 個,如已達到上限,需要在“用戶與訪問> 證書管理”頁麵中“廢除”多餘的調試證書文件。
3) 申請調試 Profile 文件的應用一定要和本地調試的應用匹配。
三、上架應用
本地調試完畢後,就可以打包 HarmonyOS 應用,在 AGC 提交上架。如圖 5 所示,和調試類似,開發者需要先在 IDE 中生成秘鑰和證書請求文件,然後拿著在 IDE 中生成的這兩個文件去 AGC 申請應用發布證書和發布 profile 文件(注意是發布證書,不再是調試證書瞭),然後再迴到 IDE 中配置簽名和編譯構建 APP,上述工作完成後纔進入應用的上架。
圖 5 上架應用流程圖
以上就是創建應用、調試應用和上架應用的介紹啦,最後我們再通過下麵這張上架全流程圖(圖 6)幫助大傢把以上內容串起來~
圖 6 上架全流程
因篇幅有限,此處不再贅述流程圖中步驟的詳細操作,詳情請點擊對應鏈接查看:
步驟 1 開發者賬號實名:
https://developer.huawei.com/consumer/cn/doc/start/itrna-0000001076878172
步驟 2 發郵件申請加入受邀名單:
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068
步驟 3 和 4 生成秘鑰和證書請求文件:
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section9752152162813
步驟 5 在 AGC 創建項目:
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createproject-0000001100334664
步驟 6 在項目下添加 HarmonyOS 應用:
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createapp-0000001146718717#section1112105771619
步驟 7 申請應用發布證書
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068#section77704814290
步驟 8 申請發布 Profile 文件
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068#section154181517295
注意點:
1) 當前 AGC 最多可申請 1 個發布證書;最多可申請 100 個 Profile 文件。
2) 發布應用一定要使用發布證書和發布 Profile 文件,並且發布證書和 Profile 文件要匹配。如果使用調試證書和調試 Profile 文件用於發布場景將無法上傳軟件包。
3) 申請發布 Profile 文件的應用一定要和發布應用匹配。
步驟 9 配置簽名信息:
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section280162182818
步驟 10 編譯構建 APP:
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section1992513343374
注意點:
1) 最終編譯構建的 HarmonyOS 應用軟件包應為.app 格式,且不能超過 2GB。否則,軟件包將無法上傳。
2) 除瞭.app 包外,AGC 還會解析檢測.app 包中的.hap 包大小:運動手錶 / 路由器類型的 hap 包大小不能超過 20MB,手機 / 智能手錶 / 大屏類型的 hap 包大小不能超過 2GB。
3) 免安裝的.hap 包不能超過 10MB。
4) 編譯.app 包所用的發布證書一定要使用 AGC 下載的證書,否則會導緻上傳軟件包失敗。
步驟 11 上架 HarmonyOS 應用
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068#section7950113411714
注意點:
1) 上傳的應用圖標,截圖,視頻等需要滿足應用市場要求,否則上傳失敗。
2) 如果需要提前小範圍測試應用,可以選擇開放式測試版本發布。
3) 上傳素材或軟件包需要純公網環境,使用代理等需要斷開連接。
四、結語
以上就是為大傢梳理的流程和注意點,感謝大傢一如既往的支持,如有更多問題,歡迎點擊鏈接,前往論壇留言,華為將根據大傢反饋的問題,持續改進和優化!