天天看點

一文看懂鴻蒙HarmonyOS應用如何上架

IT之家 3 月 2 日消息,據華為鴻蒙釋出,大家一直以來都很關心如何上架 HarmonyOS 應用,現在來了,華為官方人員為大家梳理了 HarmonyOS 應用從建立、調試到上架的流程和注意事項,希望能為你的上架之旅帶來幫助!

一、建立 / 添加應用

HarmonyOS 應用開發好後,不管是調試還是上架應用,首先都需要在 AppGallery Connect(後文簡稱:AGC)建立 / 在項目下添加 HarmonyOS 應用。而目前建立應用的方式是根據開發者帳号态和受邀名單進行管控的,詳情如下表所示:

一文看懂鴻蒙HarmonyOS應用如何上架

我們從表中可以發現,如果要直接建立應用和上架應用,則必須滿足“已實名 + 已在受邀名單”,如果隻是在項目下添加應用和調試應用,則對賬号狀态和受邀名單與否無要求。是以要上架應用的小夥伴先确認自己是否滿足前提條件(如何實名和加入受邀名單在上架應用章節會介紹)。

1. 直接建立應用

用已實名且在受邀名單的開發者帳号登入 AGC 網頁,在頁面“我的應用”(圖 1)。

AGC 網頁:

https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/

一文看懂鴻蒙HarmonyOS應用如何上架

圖 1 AGC 網頁

點選“我的應用”進入後會出現“HarmonyOS 應用”頁簽(圖 2)。選中“HarmonyOS 應用”,即可建立 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 應用,具體參見在項目下添加應用。

一文看懂鴻蒙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

一文看懂鴻蒙HarmonyOS應用如何上架

圖 4 調試簽名流程圖

1) 本地調試一定要使用調試證書和調試 Profile 檔案,并且調試證書和 Profile 檔案要比對。如果使用釋出證書和釋出 Profile 檔案用于調試場景将會導緻應用無法安裝。

2) 目前 AGC 調試證書最多僅支援 2 個,如已達到上限,需要在“使用者與通路> 證書管理”頁面中“廢除”多餘的調試證書檔案。

3) 申請調試 Profile 檔案的應用一定要和本地調試的應用比對。

三、上架應用

本地調試完畢後,就可以打包 HarmonyOS 應用,在 AGC 送出上架。如圖 5 所示,和調試類似,開發者需要先在 IDE 中生成秘鑰和證書請求檔案,然後拿着在 IDE 中生成的這兩個檔案去 AGC 申請應用釋出證書和釋出 profile 檔案(注意是釋出證書,不再是調試證書了),然後再回到 IDE 中配置簽名和編譯建構 APP,上述工作完成後才進入應用的上架。

一文看懂鴻蒙HarmonyOS應用如何上架

圖 5 上架應用流程圖

以上就是建立應用、調試應用和上架應用的介紹啦,最後我們再通過下面這張上架全流程圖(圖 6)幫助大家把以上内容串起來~

一文看懂鴻蒙HarmonyOS應用如何上架

圖 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 建立項目:

步驟 6 在項目下添加 HarmonyOS 應用:

步驟 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) 上傳素材或軟體包需要純公網環境,使用代理等需要斷開連接配接。

四、結語

以上就是為大家梳理的流程和注意點,感謝大家一如既往的支援,如有更多問題,歡迎點選連結,前往論壇留言,華為将根據大家回報的問題,持續改進和優化!

繼續閱讀