?

---

?一、環境準備?

1. ?安裝 HBuilderX?

   • 下載最新版 HBuilderX 并安裝（官方 IDE，支持一鍵打包）?16
   • 確保已安裝 Node.js（用于依賴管理）?26

2. ?配置 Android 開發環境?

   • 安裝 ?Java JDK 17+?（建議選擇穩定版）?78
   • 安裝 ?Android Studio?（用于本地打包）?26
     • 安裝時勾選 Android SDK、Gradle 等組件?37

---

?二、申請應用標識與證書?

1. ?創建 DCloud 應用?

   • 登錄?DCloud 開發者中心，創建新應用，獲取 ?AppID??15

2. ?生成證書?

   • 在 DCloud 后臺生成 ?Android 云端證書?（自動生成包名、證書密碼、別名等）?56
   • 下載證書文件（.keystore）保存至項目目錄?58

---

?三、生成本地打包資源?

1. ?在 HBuilderX 中操作?

   • 右鍵項目 → ?發行? → ?原生 App 本地打包? → ?生成本地打包資源??13
   • 生成后的資源文件位于?unpackage/resources?目錄?35

2. ?下載離線 SDK?

   • 從 DCloud 官網下載 ?Android 離線 SDK?（需與 HBuilderX 版本一致）?36
   • 解壓 SDK 至本地目錄（如?HBuilder-Integrate-AS）?38

---

?四、配置 Android 項目?

1. ?替換資源文件?

   • 將生成的本地打包資源（__UNI__XXXXX?文件夾）復制到 SDK 的?assets/apps?目錄?38

2. ?修改關鍵配置?

   • ?dcloud_control.xml?：替換 AppID 為 DCloud 后臺申請的 ID?35
   • ?AndroidManifest.xml?：修改應用名稱、權限配置?36
   • ?build.gradle?：
     • 填寫?applicationId（包名，需與證書一致）?36
     • 設置?versionCode?和?versionName（與 HBuilderX 項目版本一致）?35

---

?五、生成 APK 安裝包?

1. ?Android Studio 打包操作?

   • 打開離線 SDK 項目 → ?Build? → ?Generate Signed Bundle/APK??57
   • 選擇之前下載的?.keystore?證書文件，輸入密碼和別名?57
   • 選擇 ?APK? → ?Release? 模式生成安裝包?57

2. ?處理常見問題?

   • ?Gradle 同步失敗?：檢查 Android SDK 路徑是否正確，或手動下載 Gradle 版本?37
   • ?白屏問題?：確保 HBuilderX 版本 ≤ 3.99，高版本需配置隱私彈窗?46

---

?六、測試與發布?

1. ?真機調試?

   • 手機開啟 USB 調試模式 → 運行到 Android 基座 → 查看實時日志?48

2. ?應用上架?

   • 在應用市場注冊開發者賬號（如華為、小米）
   • 上傳 APK 并填寫應用描述、截圖等信息?24

---

?注意事項?

• ?證書安全?：勿泄露?.keystore?文件及密碼?56
• ?版本一致?：HBuilderX、離線 SDK、Gradle 版本需匹配?36
• ?隱私合規?：配置原生隱私彈窗，避免應用商店審核失敗?46

通過以上步驟，可完成從零到 APK 的完整打包流程?13。