一文帶你看懂HarmonyOS應用上架
大家一直以來都很關心如何上架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應用”頁籤
直接建立應用：
2. 專案下新增應用
在專案下新增應用之前，如果還未在AGC建立專案，則需要大家先建立專案，這樣就可以將一個應用的不同平臺版本新增到同一個專案中（比如一個應用有Android版本和HarmonyOS版本，則可以都將它們都新增到同一個AGC專案中），具體參見建立專案。
建立專案：
有了AGC專案後，就可以登入AGC頁面，進入“我的專案”中（圖3），然後新增建立HarmonyOS應用，具體參見在專案下新增應用。
圖3 我的專案
在專案下新增應用：
注意點：
- AGC建立應用填寫的包名必須全網唯一，HarmonyOS應用包名也不能和安卓應用包名重複，如果提示包名被佔用，則需要更換包名。
- 直接建立HarmonyOS應用不需要填寫包名，通過上傳的軟體包自動解析。在專案下新增HarmonyOS應用必須填寫包名
- 在專案下可以新增已有的應用，選擇應用後不要修改應用名稱，否則會認為是新建應用。
二、除錯應用
HarmonyOS應用開發完成後，且已經在AGC完成了應用的建立並新增到專案中，就可以開始進行除錯了。如果僅僅在模擬器中除錯，可以不配置簽名信息；但如果需要在真機中除錯，則必須配置簽名信息。華為提供了兩種應用除錯（簽名）方法：自動化簽名方式和手動簽名方式，上架則必須為手動簽名。
1. 自動簽名
直接在開發工具HUAWEI DevEco Studio（後文簡稱：IDE）中完成自動化簽名並除錯，具體參見使用模擬器進行除錯。
使用模擬器進行除錯：
注意點：
- 如果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應用：
圖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 發郵件申請加入受邀名單：
步驟3和4 生成祕鑰和證書請求檔案：
步驟5 在AGC建立專案：
步驟6 在專案下新增HarmonyOS應用：
步驟7 申請應用釋出證書
步驟8 申請釋出Profile檔案
注意點：
- 當前AGC最多可申請1個釋出證書；最多可申請100個Profile檔案。
- 釋出應用一定要使用釋出證書和釋出Profile檔案，並且釋出證書和Profile檔案要匹配。如果使用除錯證書和除錯Profile檔案用於釋出場景將無法上傳軟體包。
- 申請釋出Profile檔案的應用一定要和釋出應用匹配。
步驟9 配置簽名信息：
步驟10 編譯構建APP：
注意點：
- 最終編譯構建的HarmonyOS應用軟體包應為.app格式，且不能超過2GB。否則，軟體包將無法上傳。
- 除了.app包外，AGC還會解析檢測.app包中的.hap包大小：運動手錶/路由器型別的hap包大小不能超過20MB，手機/智慧手錶/大屏型別的hap包大小不能超過2GB。
- 免安裝的.hap包不能超過10MB。
- 編譯.app包所用的釋出證書一定要使用AGC下載的證書，否則會導致上傳軟體包失敗。
步驟11 上架HarmonyOS應用
注意點：
- 上傳的應用圖示，截圖，視訊等需要滿足應用市場要求，否則上傳失敗。
- 如果需要提前小範圍測試應用，可以選擇開放式測試版本釋出。
- 上傳素材或軟體包需要純公網環境，使用代理等需要斷開連線。
四、結語
以上就是我們為大家梳理的流程和注意點，感謝大家一如既往的支援，如有更多問題，請前往HarmonyOS官方論壇留言，我們將根據大家反饋的問題，持續改進和優化！
掃碼新增開發者小助手微信
獲取更多HarmonyOS開發資源和開發者活動資訊