開發環境搭建(1-2天)
- 硬件準備
操作系統:Windows 10 64位 或 macOS 10.13+
內存:8GB以上(推薦16GB)
硬盤:至少10GB可用空間
- 軟件安裝
下載 DevEco Studio 3.1+(官網:https://developer.harmonyos.com/cn/develop/deveco-studio)
-
安裝時勾選:
HarmonyOS SDK
Node.js(自動集成)
Ohpm(HarmonyOS包管理器) -
環境驗證
# 檢查Node.js版本
node -v # 需≥14.19.1
檢查ohpm版本
ohpm -v # 需≥1.0.0
配置鏡像源(加速依賴下載)
修改ohpm/ohpmrc文件:
復制
registry=https://repo.harmonyos.com/ohpm/
二、項目創建與開發(7-30天)
新建項目
選擇模板:Empty Ability + JS/ArkTS(推薦ArkTS)
最小API版本:建議≥API 7(對應HarmonyOS 3.0)
核心目錄結構
復制
├── entry # 主模塊
│ ├── src/main
│ │ ├── ets # ArkTS代碼
│ │ ├── resources # 資源文件
│ │ └── config.json # 應用配置
關鍵開發要點
UI開發:使用ArkUI聲明式語法
typescript
復制
@Entry
@Component
struct Index {
@State message: string = ‘Hello HarmonyOS’
build() {
Column() {
Text(this.message)
.fontSize(30)
Button(‘Click Me’)
.onClick(() => {
this.message = ‘Button Clicked!’
})
}
.width(‘100%’)
.height(‘100%’)
}
}
功能開發:
使用@ohos開頭的系統API(如網絡、傳感器)
通過import router from '@ohos.router’實現頁面跳轉
調試技巧
使用HiLog輸出日志:
typescript
復制
import hilog from ‘@ohos.hilog’;
hilog.info(0x0000, ‘testTag’, ‘Test Log Message’);
真機調試:開啟開發者模式(設置→關于手機→連續點擊版本號7次)
三、應用測試(3-7天)
測試類型
單元測試:使用@ohos/hypium框架
UI測試:XTS自動化測試框架
兼容性測試:至少覆蓋3款不同分辨率設備
云測試服務
使用華為提供的云真機測試服務
重點測試項目:
冷啟動時間≤1.5秒
內存峰值≤系統限制的80%
無ANR(應用無響應)情況
四、應用簽名(0.5天)
生成密鑰
在DevEco Studio:Build → Generate Key
必填信息:
Alias:至少8字符,包含大小寫字母
Validity:≥應用市場要求的25年(建議填30年)
申請證書
登錄AppGallery Connect
進入「我的項目」→「應用簽名」→上傳生成的CSR文件
簽名配置
json
復制
// build-profile.json5
{
“app”: {
“signingConfigs”: [{
“name”: “release”,
“material”: {
“certpath”: “cert/example.p12”,
“storePassword”: “",
“keyAlias”: “exampleKey”,
“keyPassword”: "”,
“signAlg”: “SHA256withECDSA”
}
}]
}
}
五、上架華為應用市場(3-7天)
材料準備
應用截圖:5張(1242x2208px PNG)
隱私政策URL:必須獨立頁面
測試賬號(如有登錄功能)
版權證明(如涉及第三方內容)
提交流程
登錄華為開發者聯盟
進入「應用市場」→「我的應用」→「創建應用」
填寫信息:
分類選擇精確到三級目錄
年齡分級需符合實際內容
上傳簽名的HAP包(通過Build → Build HAP生成)
審核要點
隱私合規:必須遵循《華為應用市場審核指南》4.7條款
權限最小化:禁止請求非必要權限
無后臺自啟動(需在config.json聲明)
六、常見問題解決方案
簽名失敗
現象:INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES
解決:清理舊包 adb uninstall com.example.app
審核被拒高頻原因
隱私政策未明確數據收集類型
應用描述含"beta"、"測試版"等字樣
圖標含華為Logo等侵權元素
性能優化建議
使用組件替代大量
復雜計算使用Worker線程
圖片資源使用.webp格式
進階建議
持續集成
配置DevEco CLI自動化構建:
bash
復制
npm install -g @ohos/hpm-cli
hpm build
關注更新
定期查看HarmonyOS版本動態
社區資源
官方論壇:https://developer.huawei.com/consumer/cn/forum/block/harmonyos
代碼樣例:https://gitee.com/harmonyos/codelabs
按照以上流程,通常可在1-2個月內完成從開發到上架的全流程。建議首次提交時預留至少5個工作日用于審核修改。