1. 項目打包上架?

調試完畢後，您便可以打包HarmonyOS應用，在AGC提交上架。

HarmonyOS通過數字證書（.cer文件）和Profile文件（.p7b文件）等簽名信息來保證應用的完整性，應用如需上架到華為應用市場必須通過簽名校驗。因此，您需要使用發佈證書和Profile文件對應用進行簽名後才能發佈。

上架成功後，用户即可在華為應用市場搜索獲取您的HarmonyOS應用。

1.1. 操作流程

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_開發者

編輯

1.2. 生成密鑰和證書請求文件

在申請數字證書和Profile文件前，首先需要通過DevEco Studio來生成密鑰和證書請求文件。

  • 密鑰：包含非對稱加密中使用的公鑰和私鑰，存儲在密鑰庫文件中，格式為.p12，公鑰和私鑰對用於數字簽名和驗證。
  • 證書請求文件：格式為.csr，全稱為Certificate Signing Request，包含密鑰對中的公鑰和公共名稱、組織名稱、組織單位等信息，用於向AGC申請數字證書。
  1. 在頂部菜單欄選擇“Build > Generate Key and CSR”。

説明

如果本地已有對應的密鑰，無需新生成密鑰，可在“Generate Key and CSR”界面點擊下方的“Skip”跳過密鑰生成過程，直接使用已有密鑰生成證書請求文件。

  1. 點擊“Choose Existing”，選擇已有的密鑰庫文件（存儲有密鑰的.p12文件），跳轉至步驟4繼續配置；如果沒有密鑰庫文件，點擊“New”，跳轉至步驟3進行創建。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_鴻蒙_02

編輯

  1. 在“Create Key Store”界面，填寫密鑰庫信息後，點擊“OK”。
  • Key store file：設置密鑰庫文件存儲路徑，並填寫p12文件名。
  • Password：設置密鑰庫密碼，必須由大寫字母、小寫字母、數字和特殊符號中的兩種以上字符的組合，長度至少為8位。請記住該密碼，後續簽名配置需要使用。
  • Confirm password：再次輸入密鑰庫密碼。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_開發者_03

編輯

  1. 在“Generate Key and CSR”界面繼續填寫密鑰信息後，點擊“Next”。
  • Alias：密鑰的別名信息，用於標識密鑰名稱。請記住該別名，後續簽名配置需要使用。
  • Password：密鑰對應的密碼，與密鑰庫密碼保持一致，無需手動輸入。
  • Validity：證書有效期，建議設置為25年及以上，覆蓋應用/元服務的完整生命週期。
  • Certificate：輸入證書基本信息，如組織、城市或地區、國家碼等。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_開發者_04

編輯

  1. 在“Generate Key and CSR”界面設置CSR文件存儲路徑和CSR文件名，點擊“Finish”。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_開發者_05

編輯

CSR文件創建成功後，將在存儲路徑下獲取生成密鑰庫文件（.p12）和證書請求文件（.csr）。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_鴻蒙_06

編輯

1.3. 申請發佈證書

發佈證書由AGC頒發的、為HarmonyOS應用配置簽名信息的數字證書，可保障軟件代碼完整性和發佈者身份真實性。證書格式為.cer，包含公鑰、證書指紋等信息。

説明

請確保您的開發者帳號已實名認證。每個帳號最多申請1個發佈證書。

  1. 登錄AppGallery Connect，選擇“用户與訪問”。
    編輯
  2. 在左側導航欄點擊“證書管理”，進入“證書管理”頁面，點擊“新增證書”。
    編輯
  3. 在彈出的“新增證書”窗口填寫要申請的證書信息，點擊“提交”。
    編輯

參數

説明

證書名稱

不超過100個字符。

證書類型

選擇“發佈證書”。

選取證書請求文件（CSR）

上傳生成密鑰和證書請求文件

時獲取的.csr文件。
  1. 證書申請成功後，“證書管理”頁面展示證書名稱等信息。點擊“下載”，將生成的證書保存至本地，供後續簽名使用。
    編輯説明證書一旦廢除將不可恢復，且通過此證書申請的Profile也會全部失效，請謹慎操作。

1.4. 申請發佈Profile

1.4.1. 前提條件

您已在AGC創建HarmonyOS應用。

1.4.2. 操作步驟

發佈Profile格式為.p7b，包含HarmonyOS應用的包名、數字證書信息、應用允許申請的證書權限列表，以及允許應用調試的設備列表（如果應用類型為Release類型，則設備列表為空）等內容。每個應用包中必須包含一個Profile文件。

説明

一個應用最多可申請100個Profile文件。

  1. 登錄AppGallery Connect，選擇“我的項目”。
  2. 找到您的項目，點擊您創建的HarmonyOS應用。
  3. 在左側導航欄選擇“HarmonyOS應用 > HAP Provision Profile管理”，進入“管理HAP Provision Profile”頁面，點擊右上角“添加”。
    編輯
  4. 在彈出的“HarmonyAppProvision信息”窗口中添加Profile，完成後點擊“提交”。
    編輯

參數

説明

名稱

不超過100個字符。

類型

選擇“發佈”。

選擇證書

點擊“選擇”，選擇申請的發佈證書

申請權限
  • 如您的應用需要使用ACL的方式申請的權限：請提供APP ID發送到agconnect@huawei.com，申請開通“受限ACL權限（HarmonyOS API9及以上）”配置項後，在此配置項中申請權限。
  • 如您的應用無需上述權限：選擇“受限權限（HarmonyOS API9以下）”，根據需要配置權限。

説明

請確保您此處申請的權限與軟件包內配置的權限一致。
  1. 發佈Profile申請成功後，“管理HAP Provision Profile”頁面展示Profile名稱、類型等信息。點擊“下載”，將生成的Profile保存至本地，供後續簽名使用。

説明

對於API9及以上的應用/元服務，AGC將簽發新版本Profile文件，已申請的Profile也會自動升級為新版本。使用舊版本Profile的應用/元服務不允許上架。如您已在軟件包內打包了舊版本Profile文件，請重新下載Profile，然後重新打包上傳。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_鴻蒙_07

編輯

1.5. 配置簽名信息

使用製作的私鑰（.p12）文件、在AGC申請的證書文件和Profile（.p7b）文件，在DevEco Studio配置工程的簽名信息，以構建攜帶發佈簽名信息的APP。

  1. 打開DevEco Studio，在頂部菜單欄選擇“File > Project Structure”，進入“Project Structure”界面。
  2. 導航選擇“Project”，點擊“Signing Configs”頁籤，取消“Automatically generate signature”勾選項，然後配置工程的簽名信息，完成後點擊“OK”。
  • Store file：密鑰庫文件，選擇生成密鑰和證書請求文件時生成的.p12文件。
  • Store password：密鑰庫密碼，需要與生成密鑰和證書請求文件時設置的密鑰庫密碼保持一致。
  • Key alias：密鑰的別名信息，需要與生成密鑰和證書請求文件設置的別名保持一致。
  • Key password：密鑰的密碼，需要與生成密鑰和證書請求文件時設置的密碼保持一致。
  • Sign alg：固定設置為“SHA256withECDSA”。
  • Profile file：選擇申請發佈Profile時下載的.p7b文件。
  • Certpath file：選擇申請發佈證書時下載的.cer文件。
    編輯 若是API Version 4至7的工程，請在“Signing Configs”界面選擇“Release”頁籤，然後再配置簽名信息。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_鴻蒙_08

  • 編輯

1.6. 編譯打包應用

1.6.1. 軟件包規範

在正式打包應用前，請確保您已瞭解HarmonyOS應用軟件包規範。

規範

説明

APP包大小

不超過4GB。

HAP包大小

在AGC上傳APP包後，AGC將解析檢測APP包中的HAP包大小，並根據HAP包聲明支持的設備類型判斷HAP包大小是否滿足條件。如APP包大小符合條件，但HAP包超過上限，系統會提示HAP包過大，您仍無法成功上傳APP包。因此請確保每個HAP包滿足大小限制：

  • 不同設備類型的HAP包大小限制：手機/平板不能超過4GB，智能手錶/大屏不能超過2GB，路由器不能超過200MB，運動手錶不能超過20MB。
  • 對於支持單設備的HarmonyOS應用軟件包，HAP包大小不能超過對應設備類型的上限。例如，HarmonyOS應用軟件包僅支持運動手錶，則HAP包不能超過20MB。
  • 對於支持多設備的HarmonyOS應用軟件包，如果APP包中的單個HAP包支持單個設備，則HAP包大小不能超過對應設備類型的上限。如果APP包中的單個HAP包支持多個設備，則HAP包大小不能超過這多個設備類型上限的最小值。

注意

當前僅智能手錶應用支持配置付費下載。如需將應用分發至智能手錶及其他設備（如運動手錶+手機），且希望智能手錶應用為付費下載應用，請將智能手錶應用分開打包，即為智能手錶單獨創建一個應用，為其他設備（如運動手錶+手機）創建另一個應用。

HAP包類型

一個HarmonyOS應用包內所有HAP包都必須是非免安裝類型，即：

  • 如應用為FA模型，需保證每個HAP包的src/main/config.json文件中“installationFree”字段值均為“false”。
  • 如應用為Stage模型，需保證AppScope/app.json5文件的“bundleType”字段值為“app”（無“bundleType”字段則默認為“app”類型）。

APP包名
  • 必須為以點號（.）分隔的字符串，且至少包含三段，每段中僅允許使用英文字母、數字、下劃線（_），如“harmony_11.huawei.com ”。首段以英文字母開頭，非首段以數字或英文字母開頭，每一段以數字或者英文字母結尾，如“harmony99.huawei.11_com”。不允許多個點號（.）連續出現，如“harmony..huawei.com ”。
  • 長度為7~128個字符，且不可包含敏感詞，不能將保留字符作為獨立段呈現。以保留字符harmony為例，包名不能為harmony.huawei.com、com.harmony.huawei、com.huawei.harmony。保留字符包括如下：
  • oh
  • ohos
  • harmony
  • harmonyos
  • openharmony
  • system

1.6.2. 操作步驟

  1. 打開DevEco Studio，在頂部菜單欄選擇“Build > Build Hap(s)/APP(s) > Build APP(s)”。
  2. 等待編譯構建。編譯完成後，將在工程目錄“build > outputs > default”目錄下，獲取可用於發佈的應用包。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_鴻蒙_09

編輯

API Version 4至7的工程需在“build > outputs > app > release”目錄下獲取。

鴻蒙5：HarmonyOS應用開發-項目打包申請證書和上架_開發者_10

編輯

1.7. 上架HarmonyOS應用

獲取到HarmonyOS應用軟件包後，您可將應用提交至AGC申請上架。上架成功後，用户即可在華為應用市場搜索獲取您的HarmonyOS應用。

1.7.1. 配置應用信息

  1. 登錄AppGallery Connect，選擇“我的應用”。
  2. 在應用列表首頁中選擇“HarmonyOS”頁籤，點擊待發布的HarmonyOS應用名稱。如應用較多，可點擊“類型”下拉框僅篩選出HarmonyOS應用，或點擊“支持設備”按設備類型篩選查找。
    編輯
  3. 在左側導航欄選擇“應用信息”菜單。如果您尚未簽署華為智慧分發平台合作協議，此時會彈出華為智慧分發平台合作協議對話框，您需按提示進行協議簽署。否則，頁面將跳轉回AGC首頁，您將無法繼續發佈HarmonyOS應用。注意只有帳號持有者和法務角色才有權限簽署華為智慧分發平台合作協議。
    編輯
  4. 在“基本信息”區域，您可以配置HarmonyOS應用支持的設備信息。
    編輯

參數

説明

支持設備

默認顯示創建應用時選擇的設備類型。

  • 在“設備類型”欄，可新增或減少分發設備。注意
  • 支持由單設備改為多設備，或多設備改為單設備。
  • 升級應用僅允許增加設備類型，不支持刪除原有在架應用已選擇的設備類型。例如，在架應用支持的設備類型為“手機”，升級應用時您無法取消勾選“手機”選項。
  • 在“可兼容設備”欄中，點擊下拉箭頭，可根據需要選擇兼容設備。
  • 手機：可選擇手機、平板。
  • 大屏：可選擇智慧屏。
  • 手錶：可選擇智能手錶、運動手錶。
  • 在“可支持操作設備”欄中，點擊下拉箭頭，可根據需要選擇支持的操作設備。
  • 手機：無。
  • 大屏：可選擇遙控器、手柄、體感。
  • 手錶：無。
  • 在“操作”欄中，點擊“清除”，可一鍵清除所選的兼容設備與支持的操作設備。

説明路由器設備不支持設置兼容設備和操作設備。
  1. 在“可本地化基礎信息”區域，配置HarmonyOS應用發佈後向用户呈現的信息，具體請參見配置可本地化基礎信息。説明
  • 運動手錶和智能手錶共用一套應用素材。
  • 如果選擇分發到多設備，請在各設備標籤頁分別上傳對應的應用素材。
  1. 根據HarmonyOS應用提供的功能和內容，在“應用分類”區域選擇應用歸屬的類別，具體請參見設置應用分類。
  2. 配置HarmonyOS應用的“開發者服務信息”，詳情請參見配置開發者服務信息。
  3. 配置完成後點擊“下一步”，在彈窗中點擊“確認”，進入“準備提交”頁面，開始設置版本信息。

1.7.2. 配置版本信息

  1. 配置HarmonyOS應用的“發佈國家或地區”，詳情請參見設置發佈國家或地區。
  2. 設置是否為開放式測試版本。注意HarmonyOS應用開放式測試當前僅支持手機、平板、智能手錶。
  • 如您想發佈為開放式測試版本，選擇“是”，具體配置請參見開放式測試操作指南。
  • 正式發佈的版本請選擇“否”。
  1. 編輯
  2. 在“軟件版本”下點擊“軟件包管理”後，在彈窗中點擊“上傳”。
    編輯
  3. 在“上傳包”窗口中點擊“+”，上傳應用的軟件包。上傳成功後，您可在“軟件包管理”窗口中執行如下操作：
  • 點擊文件名稱下
    編輯
  • 點擊“操作”欄的“調試”或“測試”鏈接，對軟件包分別進行雲調試或雲測試，可及早發現並解決問題，提高應用審核通過率。具體操作請參考雲測試和雲調試操作指南。
  • 點擊“操作”欄的“刪除”，可刪除不需要的軟件包。僅允許刪除與草稿態版本關聯的軟件包。
  1. 編輯
  2. 配置“審核加急”。
  • 是否加急：配置為“不加急”，您的應用將按照正常的流程進行審核上架。配置為“加急”，系統會優先處理該應用的上架審核任務。若您的應用符合上架條件，將在2小時之內完成上架，同時會扣除一次加急機會。若您的應用被審核駁回，在駁回後的12小時內提交的審核或反饋，將被優先審核，被駁回的情況下不會扣除加急機會。
  • 加急類型：當前加急類型包括、臨時活動、其他。若配置為“臨時”，則表示您需要緊急修復缺陷；配置為“臨時活動”表示正在進行一項商業類活動。
  • 加急説明：您可在此對加急審核上架進行描述，以便運營人員快速處理審核任務。
  1. 編輯説明
  • “審核加急”配置當前僅在中國大陸地區開放。
  • 在一個自然年內，一個應用有3次加急機會。
  • “審核加急”配置當前受限開放，在使用此功能前，您需要向華為運營人員發送申請郵件，華為運營人員將在1-3個工作日內為您安排對接人員。
  • 郵箱地址：agconnect@huawei.com
  • 郵件標題：[申請使用HarmonyOS應用加急審核上架]-[應用名稱]-[APPID]-[公司名稱]-[開發者賬號ID]，開發者帳號ID查詢方法請參見查詢開發者帳號ID及項目ID。
  1. 配置HarmonyOS應用的“付費情況”，具體請參見設置應用付費情況。注意
  • 當前僅智能手錶應用支持付費能力，其他設備類型的HarmonyOS應用僅支持免費下載。因此，當“支持設備”僅選擇“手錶”且“可兼容設備”僅選擇“智能手錶”時，才支持設置“付費情況”為“付費”。
  • 智能手錶應用的付費下載能力目前僅對受邀開發者開放。如有需求，請向華為運營人員申請開通。在收到您的申請後，華為運營人員將在1-3個工作日內為您安排對接人員。申請方法如下：
  • 申請郵箱地址：agconnect@huawei.com。
  • 郵件標題：[申請開通智能手錶應用付費下載能力]-[應用名稱]-[公司名稱]-[開發者帳號ID]，開發者帳號ID查詢方法請參見查詢開發者帳號ID及項目ID。
  • 付費下載的HarmonyOS應用不支持設置促銷價。
  1. 選擇應用內資費類型，即用户在使用應用過程中的付費類型，如因使用道具、開通會員等進行的付費。支持多選。
    編輯
  2. 在“內容分級”區域，點擊“設置”，按實際情況填寫調查問卷，填寫完成將獲取當前應用的年齡分級結果。具體請參見設置內容分級。
  3. 如果涉及以下場景，請填寫HarmonyOS應用的“應用隱私説明”，否則直接進行下一步。
  • 如檢測到應用軟件包涉及獲取敏感隱私權限，您需為每個敏感權限項填寫相應的權限説明，每條權限説明最大支持500字符。
    編輯
  • 如檢測到您的應用軟件包涉及獲取受限權限，您需為每個受限權限項填寫相應的權限説明，並上傳視頻説明使用場景。
  • 權限説明：每條權限説明最大支持500字符。
  • 使用場景視頻：支持MOV或MP4格式，大小500MB以內。僅支持上傳一個視頻。
  • 注意如果您的軟件包聲明要求使用受限權限，請確保您在創建發佈Profile時已經申請該權限，否則您的應用上架審核將會被駁回。如您尚未申請，請重新申請發佈Profile，然後重新上傳軟件包。
    編輯
  • 如檢測到您的應用軟件包涉及獲取ACL權限，您需為每個ACL權限項説明使用場景。注意如果您的軟件包聲明要求使用ACL權限，請確保您在創建發佈Profile時已經申請該權限，否則您的應用上架審核將會被駁回。如您尚未申請，請重新申請發佈Profile，然後重新上傳軟件包。
    編輯
  • 使用場景視頻：通過視頻説明權限使用場景，支持MOV或MP4格式，大小500MB以內。
  • 使用場景説明：可通過選擇AGC提供的場景標籤或者自定義文字來説明權限使用場景。自定義權限説明不得超過500字符。
    編輯
  1. 在“隱私聲明”區域提供隱私聲明鏈接。
  • 隱私政策網址：該網站將供用户訪問，從而瞭解服務是如何處理敏感的用户數據和設備數據。
  • 隱私權利：提供用户實施其權利的相關網站，例如：刪除、修改、導出個人數據的入口。
  1. 根據應用是否收集用户的信息數據選擇是否在華為應用市場的應用詳情頁展示隱私標籤，告知用户您的應用如何使用個人數據，具體請參見錄入隱私標籤信息。注意只有支持手機、平板或大屏的HarmonyOS應用才需配置隱私標籤信息錄入。
    編輯
  2. 在“版權信息”區域上傳發布HarmonyOS應用所需的資質材料。
    編輯
  • 應用發佈範圍包含中國大陸：
  • 電子版權證書：可選。可上傳應用或遊戲的PDF格式“電子版權證書”，大小不超過5MB。如果您上傳了非PDF格式的文件或是將非PDF格式的文件的擴展名改為PDF，均會彈出錯誤提示。
  • 應用版權證書或代理證書：手機應用必選。支持JPG、PNG、BMP格式，默認展示五個圖片上傳框，您可點擊虛線框內的“+”號繼續添加。最多添加10張圖片，每張圖片不超過15MB。
  • 應用發佈範圍不包含中國大陸：
  • 電子版權證書：可選。可上傳應用或遊戲的PDF格式“電子版權證書”，大小不超過5MB。如果您上傳了非PDF格式的文件或是將非PDF格式的文件的擴展名改為PDF，均會彈出錯誤提示。
  • 應用版權證書或代理證書：可選。支持JPG、PNG、BMP格式，默認展示五個圖片上傳框，您可點擊虛線框內的“+”號繼續添加。最多添加10張圖片，每張圖片不超過15MB。
  1. 説明關於版權資質文件的具體要求，請參考應用資質審核要求。如您的版權資質圖片超過了最大支持數量，建議您將圖片進行拼接後再上傳。
  2. 如HarmonyOS應用屬於遊戲類且支持設備包含手機或者路由器，請按要求填寫遊戲版號信息。
    編輯
  • 版號信息：必填，您需要向相關單位申請遊戲版號，版號不超過50字符。
  • 版號證明：必選，需上傳“版號批文”或“版號授權書”，圖片格式支持JPG、JPEG、PNG、PDF。默認展示三個圖片上傳框，您可點擊虛線框內的“+”號繼續添加。最多添加5張圖片，每張圖片不超過4MB。若您上傳了版號授權書，還需填寫“授權書有效期”。
    編輯説明關於版權和版號文件的具體要求，請參考應用資質審核要求。如您的版號資質圖片超過了最大支持數量，建議您將圖片進行拼接後再上傳。
  1. 根據《工業和信息化部關於開展移動互聯網應用程序備案工作的通知》，自2023年9月初起，在中國大陸地區提供互聯網信息服務的APP開發者，需要依法履行APP備案手續，並通過APP分發平台的備案信息核驗。點擊一圖讀懂APP備案，可瞭解APP備案的流程與要求。凡在AGC新上架或升級的應用，如發佈地區包含中國大陸，必須先通過應用的網絡服務接入商完成APP備案，然後在應用上架時提供備案信息用於核驗，核驗通過後才允許上架。您可先前往ICP/IP地址/域名信息備案管理系統查詢當前應用是否已備案；如尚未備案，請聯繫對應的網絡服務接入商完成備案。關於如何選擇接入商，需要根據您所選擇的服務器提供商而定。目前常見的接入商有：華為雲、阿里雲、騰訊雲。
  • 華為雲：https://beian.huaweicloud.com/
  • 阿里雲：https://beian.aliyun.com/
  • 騰訊雲：https://cloud.tencent.com/product/ba
  1. 備案成功後，請使用您備案時的證件信息填寫“備案信息”欄。
  • 如“主體類型”選擇“企業”，請填寫統一社會信用代碼，長度不超過18個字符，僅支持英文字母和數字。説明統一社會信用代碼可通過全國組織機構統一社會信用代碼查詢平台獲取。
  • 如“主體類型”選擇“個人”，請填寫個人身份證號，長度為15或18字符，僅支持英文字母和數字。
  • 如“主體類型”選擇“機構”，請填寫組織機構代碼，長度不超過64個字符，僅支持英文字母、數字和中劃線（-）。

HarmonyOS賦能資源豐富度建設（第四期）-吳東林

https://developer.huawei.com/consumer/cn/training/classDetail/9fdeeb1a35d64d2fabad3948ae7aab72?type=1?ha_source=hmosclass&ha_sourceId=89000248