IT之家 3 月 2 日消息，據(jù)華為鴻蒙發(fā)布，大家一直以來(lái)都很關(guān)心如何上架 HarmonyOS 應(yīng)用，現(xiàn)在來(lái)了，華為官方人員為大家梳理了 HarmonyOS 應(yīng)用從創(chuàng)建、調(diào)試到上架的流程和注意事項(xiàng)，希望能為你的上架之旅帶來(lái)幫助！
一、創(chuàng)建 / 添加應(yīng)用
HarmonyOS 應(yīng)用開(kāi)發(fā)好后，不管是調(diào)試還是上架應(yīng)用，首先都需要在 AppGallery Connect（后文簡(jiǎn)稱(chēng)：AGC）創(chuàng)建 / 在項(xiàng)目下添加 HarmonyOS 應(yīng)用。而當(dāng)前創(chuàng)建應(yīng)用的方式是根據(jù)開(kāi)發(fā)者帳號(hào)態(tài)和受邀名單進(jìn)行管控的，詳情如下表所示：
我們從表中可以發(fā)現(xiàn)，如果要直接創(chuàng)建應(yīng)用和上架應(yīng)用，則必須滿足“已實(shí)名 + 已在受邀名單”，如果只是在項(xiàng)目下添加應(yīng)用和調(diào)試應(yīng)用，則對(duì)賬號(hào)狀態(tài)和受邀名單與否無(wú)要求。所以要上架應(yīng)用的小伙伴先確認(rèn)自己是否滿足前提條件（如何實(shí)名和加入受邀名單在上架應(yīng)用章節(jié)會(huì)介紹）。
1. 直接創(chuàng)建應(yīng)用
用已實(shí)名且在受邀名單的開(kāi)發(fā)者帳號(hào)登錄 AGC 網(wǎng)頁(yè)，在頁(yè)面“我的應(yīng)用”（圖 1）。
AGC 網(wǎng)頁(yè)：
https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/
圖 1 AGC 網(wǎng)頁(yè)
點(diǎn)擊“我的應(yīng)用”進(jìn)入后會(huì)出現(xiàn)“HarmonyOS 應(yīng)用”頁(yè)簽（圖 2）。選中“HarmonyOS 應(yīng)用”，即可創(chuàng)建 HarmonyOS 應(yīng)用，具體參見(jiàn)直接創(chuàng)建應(yīng)用。
圖 2“HarmonyOS 應(yīng)用”頁(yè)簽
直接創(chuàng)建應(yīng)用：
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createapp-0000001146718717#section115641920131620
2. 項(xiàng)目下添加應(yīng)用
在項(xiàng)目下添加應(yīng)用之前，如果還未在 AGC 創(chuàng)建項(xiàng)目，則需要大家先創(chuàng)建項(xiàng)目，這樣就可以將一個(gè)應(yīng)用的不同平臺(tái)版本添加到同一個(gè)項(xiàng)目中（比如一個(gè)應(yīng)用有 Android 版本和 HarmonyOS 版本，則可以都將它們都添加到同一個(gè) AGC 項(xiàng)目中），具體參見(jiàn)創(chuàng)建項(xiàng)目。
創(chuàng)建項(xiàng)目：
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createproject-0000001100334664
有了 AGC 項(xiàng)目后，就可以登錄 AGC 頁(yè)面，進(jìn)入“我的項(xiàng)目”中（圖 3），然后添加創(chuàng)建 HarmonyOS 應(yīng)用，具體參見(jiàn)在項(xiàng)目下添加應(yīng)用。
圖 3 我的項(xiàng)目
在項(xiàng)目下添加應(yīng)用：
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createapp-0000001146718717#section1112105771619
注意點(diǎn)：
1) AGC 創(chuàng)建應(yīng)用填寫(xiě)的包名必須全網(wǎng)唯一，HarmonyOS 應(yīng)用包名也不能和安卓應(yīng)用包名重復(fù)，如果提示包名被占用，則需要更換包名。
2) 直接創(chuàng)建 HarmonyOS 應(yīng)用不需要填寫(xiě)包名，通過(guò)上傳的軟件包自動(dòng)解析。在項(xiàng)目下添加 HarmonyOS 應(yīng)用必須填寫(xiě)包名
3) 在項(xiàng)目下可以添加已有的應(yīng)用，選擇應(yīng)用后不要修改應(yīng)用名稱(chēng)，否則會(huì)認(rèn)為是新建應(yīng)用。
二、調(diào)試應(yīng)用
HarmonyOS 應(yīng)用開(kāi)發(fā)完成后，且已經(jīng)在 AGC 完成了應(yīng)用的創(chuàng)建并添加到項(xiàng)目中，就可以開(kāi)始進(jìn)行調(diào)試了。如果僅僅在模擬器中調(diào)試，可以不配置簽名信息；但如果需要在真機(jī)中調(diào)試，則必須配置簽名信息。華為提供了兩種應(yīng)用調(diào)試（簽名）方法：自動(dòng)化簽名方式和手動(dòng)簽名方式，上架則必須為手動(dòng)簽名。
1. 自動(dòng)簽名
直接在開(kāi)發(fā)工具 HUAWEI DevEco Studio（后文簡(jiǎn)稱(chēng)：IDE）中完成自動(dòng)化簽名并調(diào)試，具體參見(jiàn)使用模擬器進(jìn)行調(diào)試。
使用模擬器進(jìn)行調(diào)試：
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404#section837891802519
注意點(diǎn)：
1) 如果 IDE 沒(méi)有自動(dòng)簽名選項(xiàng)，建議升級(jí) IDE 至最新版本。自動(dòng)簽名特性?xún)H在 DevEco Studio V2.1 Release 及更高版本中支持。
2) 自動(dòng)化簽名的調(diào)試方式會(huì)自動(dòng)在 AGC 中創(chuàng)建用于調(diào)試的數(shù)字證書(shū)和 Profile 文件，但當(dāng)前 AGC 調(diào)試證書(shū)最多僅支持 2 個(gè)，即最多同時(shí)只支持為兩個(gè)應(yīng)用進(jìn)行自動(dòng)化調(diào)試，如已達(dá)到上限，需要在“用戶(hù)與訪問(wèn)> 證書(shū)管理”頁(yè)面中“廢除”多余的調(diào)試證書(shū)文件。3) 調(diào)試設(shè)備最多支持 100 個(gè)。
4) HarmonyOS 應(yīng)用的 config.json 文件中的“bundleName”取值必須和 AGC 應(yīng)用包名保持一致，如包名沖突，可以修改 bundleName 進(jìn)行規(guī)避。
5) 如果報(bào)錯(cuò)連接 AGC 網(wǎng)站失敗，請(qǐng)檢查是否使用代理等，可以斷開(kāi)代理重試。
2. 手動(dòng)簽名
相關(guān)流程如圖 4 所示，首先在 IDE 中生成秘鑰和證書(shū)請(qǐng)求文件，然后拿著在 IDE 生成的這兩個(gè)文件再去 AGC 申請(qǐng)應(yīng)用調(diào)試證書(shū)和調(diào)試 profile 文件，最后回到 IDE 中配置簽名，編譯構(gòu)建 APP，然后就可以進(jìn)行調(diào)試了。詳細(xì)流程請(qǐng)參考手動(dòng)調(diào)試 HarmonyOS 應(yīng)用。
手動(dòng)調(diào)試 HarmonyOS 應(yīng)用：
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-debugapp-manual-0000001177608893
圖 4 調(diào)試簽名流程圖
注意點(diǎn)：
1) 本地調(diào)試一定要使用調(diào)試證書(shū)和調(diào)試 Profile 文件，并且調(diào)試證書(shū)和 Profile 文件要匹配。如果使用發(fā)布證書(shū)和發(fā)布 Profile 文件用于調(diào)試場(chǎng)景將會(huì)導(dǎo)致應(yīng)用無(wú)法安裝。
2) 當(dāng)前 AGC 調(diào)試證書(shū)最多僅支持 2 個(gè)，如已達(dá)到上限，需要在“用戶(hù)與訪問(wèn)> 證書(shū)管理”頁(yè)面中“廢除”多余的調(diào)試證書(shū)文件。
3) 申請(qǐng)調(diào)試 Profile 文件的應(yīng)用一定要和本地調(diào)試的應(yīng)用匹配。
三、上架應(yīng)用
本地調(diào)試完畢后，就可以打包 HarmonyOS 應(yīng)用，在 AGC 提交上架。如圖 5 所示，和調(diào)試類(lèi)似，開(kāi)發(fā)者需要先在 IDE 中生成秘鑰和證書(shū)請(qǐng)求文件，然后拿著在 IDE 中生成的這兩個(gè)文件去 AGC 申請(qǐng)應(yīng)用發(fā)布證書(shū)和發(fā)布 profile 文件（注意是發(fā)布證書(shū)，不再是調(diào)試證書(shū)了），然后再回到 IDE 中配置簽名和編譯構(gòu)建 APP，上述工作完成后才進(jìn)入應(yīng)用的上架。
圖 5 上架應(yīng)用流程圖
以上就是創(chuàng)建應(yīng)用、調(diào)試應(yīng)用和上架應(yīng)用的介紹啦，最后我們?cè)偻ㄟ^(guò)下面這張上架全流程圖（圖 6）幫助大家把以上內(nèi)容串起來(lái)~
圖 6 上架全流程
因篇幅有限，此處不再贅述流程圖中步驟的詳細(xì)操作，詳情請(qǐng)點(diǎn)擊對(duì)應(yīng)鏈接查看：
步驟 1 開(kāi)發(fā)者賬號(hào)實(shí)名：
https://developer.huawei.com/consumer/cn/doc/start/itrna-0000001076878172
步驟 2 發(fā)郵件申請(qǐng)加入受邀名單：
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068
步驟 3 和 4 生成秘鑰和證書(shū)請(qǐng)求文件：
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section9752152162813
步驟 5 在 AGC 創(chuàng)建項(xiàng)目：
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createproject-0000001100334664
步驟 6 在項(xiàng)目下添加 HarmonyOS 應(yīng)用：
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-createapp-0000001146718717#section1112105771619
步驟 7 申請(qǐng)應(yīng)用發(fā)布證書(shū)
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068#section77704814290
步驟 8 申請(qǐng)發(fā)布 Profile 文件
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068#section154181517295
注意點(diǎn)：
1) 當(dāng)前 AGC 最多可申請(qǐng) 1 個(gè)發(fā)布證書(shū)；最多可申請(qǐng) 100 個(gè) Profile 文件。
2) 發(fā)布應(yīng)用一定要使用發(fā)布證書(shū)和發(fā)布 Profile 文件，并且發(fā)布證書(shū)和 Profile 文件要匹配。如果使用調(diào)試證書(shū)和調(diào)試 Profile 文件用于發(fā)布場(chǎng)景將無(wú)法上傳軟件包。
3) 申請(qǐng)發(fā)布 Profile 文件的應(yīng)用一定要和發(fā)布應(yīng)用匹配。
步驟 9 配置簽名信息：
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section280162182818
步驟 10 編譯構(gòu)建 APP：
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section1992513343374
注意點(diǎn)：
1) 最終編譯構(gòu)建的 HarmonyOS 應(yīng)用軟件包應(yīng)為.app 格式，且不能超過(guò) 2GB。否則，軟件包將無(wú)法上傳。
2) 除了.app 包外，AGC 還會(huì)解析檢測(cè).app 包中的.hap 包大?。哼\(yùn)動(dòng)手表 / 路由器類(lèi)型的 hap 包大小不能超過(guò) 20MB，手機(jī) / 智能手表 / 大屏類(lèi)型的 hap 包大小不能超過(guò) 2GB。
3) 免安裝的.hap 包不能超過(guò) 10MB。
4) 編譯.app 包所用的發(fā)布證書(shū)一定要使用 AGC 下載的證書(shū)，否則會(huì)導(dǎo)致上傳軟件包失敗。
步驟 11 上架 HarmonyOS 應(yīng)用
https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-releaseapp-0000001126380068#section7950113411714
注意點(diǎn)：
1) 上傳的應(yīng)用圖標(biāo)，截圖，視頻等需要滿足應(yīng)用市場(chǎng)要求，否則上傳失敗。
2) 如果需要提前小范圍測(cè)試應(yīng)用，可以選擇開(kāi)放式測(cè)試版本發(fā)布。
3) 上傳素材或軟件包需要純公網(wǎng)環(huán)境，使用代理等需要斷開(kāi)連接。
四、結(jié)語(yǔ)
以上就是為大家梳理的流程和注意點(diǎn)，感謝大家一如既往的支持，如有更多問(wèn)題，歡迎點(diǎn)擊鏈接，前往論壇留言，華為將根據(jù)大家反饋的問(wèn)題，持續(xù)改進(jìn)和優(yōu)化！
廣告聲明：文內(nèi)含有的對(duì)外跳轉(zhuǎn)鏈接（包括不限于超鏈接、二維碼、口令等形式），用于傳遞更多信息，節(jié)省甄選時(shí)間，結(jié)果僅供參考，IT之家所有文章均包含本聲明。