一文帶你看懂HarmonyOS應用上架


原文:https://mp.weixin.qq.com/s/DJ6HZvUN2siP74FqAEQf6A,點擊鏈接查看更多技術內容。

 

大家一直以來都很關心如何上架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 

 

注意點:

  • AGC創建應用填寫的包名必須全網唯一,HarmonyOS應用包名也不能和安卓應用包名重復,如果提示包名被占用,則需要更換包名。
  • 直接創建HarmonyOS應用不需要填寫包名,通過上傳的軟件包自動解析。在項目下添加HarmonyOS應用必須填寫包名
  • 在項目下可以添加已有的應用,選擇應用后不要修改應用名稱,否則會認為是新建應用。 


二、調試應用


HarmonyOS應用開發完成后,且已經在AGC完成了應用的創建並添加到項目中,就可以開始進行調試了。如果僅僅在模擬器中調試,可以不配置簽名信息;但如果需要在真機中調試,則必須配置簽名信息。華為提供了兩種應用調試(簽名)方法:自動化簽名方式和手動簽名方式,上架則必須為手動簽名。 

 

1. 自動簽名


直接在開發工具HUAWEI DevEco Studio(后文簡稱:IDE)中完成自動化簽名並調試,具體參見使用模擬器進行調試。

 

使用模擬器進行調試:

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404#section837891802519

 

注意點:

  • 如果IDE沒有自動簽名選項,建議升級IDE至最新版本。自動簽名特性僅在DevEco Studio V2.1 Release及更高版本中支持。
  • 自動化簽名的調試方式會自動在AGC中創建用於調試的數字證書和Profile文件,但當前AGC調試證書最多僅支持2個,即最多同時只支持為兩個應用進行自動化調試
  • 如已達到上限,需要在“用戶與訪問 > 證書管理”頁面中“廢除”多余的調試證書文件。
  • 調試設備最多支持100個。
  • HarmonyOS應用的config.json文件中的“bundleName”取值必須和AGC應用包名保持一致,如包名沖突,可以修改bundleName進行規避。
  • 如果報錯連接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 調試簽名流程圖

 

注意點:

  • 本地調試一定要使用調試證書和調試Profile文件,並且調試證書和Profile文件要匹配。如果使用發布證書和發布Profile文件用於調試場景將會導致應用無法安裝。
  • 當前AGC調試證書最多僅支持2個,如已達到上限,需要在“用戶與訪問 > 證書管理”頁面中“廢除”多余的調試證書文件。
  • 申請調試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 

 

注意點:

  • 當前AGC最多可申請1個發布證書;最多可申請100個Profile文件。
  • 發布應用一定要使用發布證書和發布Profile文件,並且發布證書和Profile文件要匹配。如果使用調試證書和調試Profile文件用於發布場景將無法上傳軟件包。
  • 申請發布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 

 

注意點:

  • 最終編譯構建的HarmonyOS應用軟件包應為.app格式,且不能超過2GB。否則,軟件包將無法上傳。
  • 除了.app包外,AGC還會解析檢測.app包中的.hap包大小:運動手表/路由器類型的hap包大小不能超過20MB,手機/智能手表/大屏類型的hap包大小不能超過2GB。
  • 免安裝的.hap包不能超過10MB。
  • 編譯.app包所用的發布證書一定要使用AGC下載的證書,否則會導致上傳軟件包失敗。 

 

步驟11 上架HarmonyOS應用

https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068#section7950113411714 

 

注意點:

  • 上傳的應用圖標,截圖,視頻等需要滿足應用市場要求,否則上傳失敗。
  • 如果需要提前小范圍測試應用,可以選擇開放式測試版本發布。
  • 上傳素材或軟件包需要純公網環境,使用代理等需要斷開連接。 


四、結語


以上就是我們為大家梳理的流程和注意點,感謝大家一如既往的支持,如有更多問題,請前往HarmonyOS官方論壇留言,我們將根據大家反饋的問題,持續改進和優化! 

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM