如何上架HarmonyOS應(yīng)用

作者：songxixi AGC應(yīng)用分發(fā)技術(shù)專家

大家一直以來都很關(guān)心如何上架HarmonyOS應(yīng)用，現(xiàn)在它來了!它終于來了!我們?yōu)榇蠹沂崂砹?a target="_blank">HarmonyOS應(yīng)用從創(chuàng)建、調(diào)試到上架的流程和注意事項(xiàng)，希望能為你的上架之旅帶來幫助!

一、創(chuàng)建/添加應(yīng)用

HarmonyOS應(yīng)用開發(fā)好后，不管是調(diào)試還是上架應(yīng)用，首先都需要在AppGallery Connect(后文簡(jiǎn)稱：AGC)創(chuàng)建/在項(xiàng)目下添加HarmonyOS應(yīng)用。而當(dāng)前創(chuàng)建應(yīng)用的方式是根據(jù)開發(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í)名且在受邀名單的開發(fā)者帳號(hào)登錄AGC網(wǎng)頁(yè)，在頁(yè)面“我的應(yīng)用”(圖1)。

圖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)用，具體參見直接創(chuàng)建應(yīng)用。

圖2 “HarmonyOS應(yīng)用”頁(yè)簽

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)目中)，具體參見創(chuàng)建項(xiàng)目。

有了AGC項(xiàng)目后，就可以登錄AGC頁(yè)面，進(jìn)入“我的項(xiàng)目”中(圖3)，然后添加創(chuàng)建HarmonyOS應(yīng)用，具體參見在項(xiàng)目下添加應(yīng)用。

圖3 我的項(xiàng)目

注意點(diǎn)：

1)AGC創(chuàng)建應(yīng)用填寫的包名必須全網(wǎng)唯一，HarmonyOS應(yīng)用包名也不能和安卓應(yīng)用包名重復(fù)，如果提示包名被占用，則需要更換包名。

2)直接創(chuàng)建HarmonyOS應(yīng)用不需要填寫包名，通過上傳的軟件包自動(dòng)解析。在項(xiàng)目下添加HarmonyOS應(yīng)用必須填寫包名

3)在項(xiàng)目下可以添加已有的應(yīng)用，選擇應(yīng)用后不要修改應(yīng)用名稱，否則會(huì)認(rèn)為是新建應(yīng)用。

二、調(diào)試應(yīng)用

HarmonyOS應(yīng)用開發(fā)完成后，且已經(jīng)在AGC完成了應(yīng)用的創(chuàng)建并添加到項(xiàng)目中，就可以開始進(jìn)行調(diào)試了。如果僅僅在模擬器中調(diào)試，可以不配置簽名信息;但如果需要在真機(jī)中調(diào)試，則必須配置簽名信息。華為提供了兩種應(yīng)用調(diào)試(簽名)方法：自動(dòng)化簽名方式和手動(dòng)簽名方式，上架則必須為手動(dòng)簽名。

1. 自動(dòng)簽名

直接在開發(fā)工具HUAWEI DevEco Studio(后文簡(jiǎn)稱：IDE)中完成自動(dòng)化簽名并調(diào)試，具體參見使用模擬器進(jìn)行調(diào)試。

使用模擬器進(jìn)行調(diào)試

注意點(diǎn)：

1)如果IDE沒有自動(dòng)簽名選項(xiàng)，建議升級(jí)IDE至最新版本。自動(dòng)簽名特性僅在DevEco Studio V2.1 Release及更高版本中支持。

2)自動(dòng)化簽名的調(diào)試方式會(huì)自動(dòng)在AGC中創(chuàng)建用于調(diào)試的數(shù)字證書和Profile文件，但當(dāng)前AGC調(diào)試證書最多僅支持2個(gè)，即最多同時(shí)只支持為兩個(gè)應(yīng)用進(jìn)行自動(dòng)化調(diào)試，如已達(dá)到上限，需要在“用戶與訪問 > 證書管理”頁(yè)面中“廢除”多余的調(diào)試證書文件。

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)檢查是否使用代理等，可以斷開代理重試。

2. 手動(dòng)簽名

相關(guān)流程如圖4所示，首先在IDE中生成秘鑰和證書請(qǐng)求文件，然后拿著在IDE生成的這兩個(gè)文件再去AGC申請(qǐng)應(yīng)用調(diào)試證書和調(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)用

圖4 調(diào)試簽名流程圖

注意點(diǎn)：

1)本地調(diào)試一定要使用調(diào)試證書和調(diào)試Profile文件，并且調(diào)試證書和Profile文件要匹配。如果使用發(fā)布證書和發(fā)布Profile文件用于調(diào)試場(chǎng)景將會(huì)導(dǎo)致應(yīng)用無(wú)法安裝。2)當(dāng)前AGC調(diào)試證書最多僅支持2個(gè)，如已達(dá)到上限，需要在“用戶與訪問 > 證書管理”頁(yè)面中“廢除”多余的調(diào)試證書文件。3)申請(qǐng)調(diào)試Profile文件的應(yīng)用一定要和本地調(diào)試的應(yīng)用匹配。

三、上架應(yīng)用

本地調(diào)試完畢后，就可以打包HarmonyOS應(yīng)用，在AGC提交上架。如圖5所示，和調(diào)試類似，開發(fā)者需要先在IDE中生成秘鑰和證書請(qǐng)求文件，然后拿著在IDE中生成的這兩個(gè)文件去AGC申請(qǐng)應(yīng)用發(fā)布證書和發(fā)布profile文件(注意是發(fā)布證書，不再是調(diào)試證書了)，然后再回到IDE中配置簽名和編譯構(gòu)建APP，上述工作完成后才進(jìn)入應(yīng)用的上架。

圖5 上架應(yīng)用流程圖

以上就是創(chuàng)建應(yīng)用、調(diào)試應(yīng)用和上架應(yīng)用的介紹啦，最后我們?cè)偻ㄟ^下面這張上架全流程圖(圖6)幫助大家把以上內(nèi)容串起來~

圖6 上架全流程

因篇幅有限，此處不再贅述流程圖中步驟的詳細(xì)操作，詳情請(qǐng)點(diǎn)擊對(duì)應(yīng)鏈接查看：

步驟1 開發(fā)者賬號(hào)實(shí)名

步驟2 發(fā)郵件申請(qǐng)加入受邀名單

步驟3和4 生成秘鑰和證書請(qǐng)求文件

步驟5 在AGC創(chuàng)建項(xiàng)目

步驟6 在項(xiàng)目下添加HarmonyOS應(yīng)用

步驟7 申請(qǐng)應(yīng)用發(fā)布證書

步驟8 申請(qǐng)發(fā)布Profile文件

注意點(diǎn)：

1)當(dāng)前AGC最多可申請(qǐng)1個(gè)發(fā)布證書;最多可申請(qǐng)100個(gè)Profile文件。

2)發(fā)布應(yīng)用一定要使用發(fā)布證書和發(fā)布Profile文件，并且發(fā)布證書和Profile文件要匹配。如果使用調(diào)試證書和調(diào)試Profile文件用于發(fā)布場(chǎng)景將無(wú)法上傳軟件包。

3)申請(qǐng)發(fā)布Profile文件的應(yīng)用一定要和發(fā)布應(yīng)用匹配。

步驟9 配置簽名信息

步驟10 編譯構(gòu)建APP

注意點(diǎn)：

1)最終編譯構(gòu)建的HarmonyOS應(yīng)用軟件包應(yīng)為.app格式，且不能超過2GB。否則，軟件包將無(wú)法上傳。

2)除了.app包外，AGC還會(huì)解析檢測(cè).app包中的.hap包大?。哼\(yùn)動(dòng)手表/路由器類型的hap包大小不能超過20MB，手機(jī)/智能手表/大屏類型的hap包大小不能超過2GB。

3)免安裝的.hap包不能超過10MB。

4)編譯.app包所用的發(fā)布證書一定要使用AGC下載的證書，否則會(huì)導(dǎo)致上傳軟件包失敗。

步驟11 上架HarmonyOS應(yīng)用

注意點(diǎn)：

1)上傳的應(yīng)用圖標(biāo)，截圖，視頻等需要滿足應(yīng)用市場(chǎng)要求，否則上傳失敗。

2)如果需要提前小范圍測(cè)試應(yīng)用，可以選擇開放式測(cè)試版本發(fā)布。

3)上傳素材或軟件包需要純公網(wǎng)環(huán)境，使用代理等需要斷開連接。

四、結(jié)語(yǔ)

以上就是我們?yōu)榇蠹沂崂淼牧鞒毯妥⒁恻c(diǎn)，感謝大家一如既往的支持，如有更多問題，歡迎點(diǎn)擊下方閱讀原文，前往論壇留言，我們將根據(jù)大家反饋的問題，持續(xù)改進(jìn)和優(yōu)化!

原文標(biāo)題：一文帶你看懂HarmonyOS應(yīng)用上架

文章出處：【微信公眾號(hào)：HarmonyOS開發(fā)者】歡迎添加關(guān)注!文章轉(zhuǎn)載請(qǐng)注明出處。

審核編輯：湯梓紅