安装开发工具

下载并安装 DevEco Studio（官方 IDE），支持 Windows 和 macOS 系统。访问华为开发者联盟官网获取最新版本，安装过程中需勾选 HarmonyOS SDK 组件。配置 Node.js 环境（建议 v14+），确保 npm 可用。

创建项目

打开 DevEco Studio，选择“Create HarmonyOS Project”，模板选择“Empty Ability”或“JS/ArkTS”模板。填写项目名称（如 HCCDA_Demo）、包名和存储路径，设备类型选择 Phone 或 Tablet，API 版本按需选择。

配置项目依赖

修改 build.gradle 文件，检查 ohos 插件版本与 SDK 是否匹配。在 entry/src/main/resources/config.json 中配置应用基本信息，包括应用图标、权限声明和入口 Ability。同步 Gradle 依赖，确保无报错。

编写核心代码

使用 ArkTS 或 JS 编写 UI 界面，例如：

@Entry
@Component
struct Index {
  build() {
    Column() {
      Text('HCCDA Demo').fontSize(30)
      Button('Click Me').onClick(() => {
        console.log('Button clicked')
      })
    }
  }
}

调试与预览

通过 Previewer 实时预览界面效果，或连接真机/模拟器调试。在 Run/Debug Configurations 中选择目标设备，点击运行按钮。首次运行需在设备上安装 HAP 文件，开启开发者模式并授权安装。

构建与打包

生成正式签名的 HAP 包：配置签名证书（.p12 和 .cer 文件），在 Build > Generate Key and CSR 中创建。修改 build-profile.json5 文件，添加签名配置后执行 Build > Build HAP(s)。

部署与测试

将生成的 HAP 文件通过 ADB 安装到设备：

adb install path/to/entry-debug-standard-ark-signed.hap

或在 AppGallery Connect 提交审核，进行分布式设备兼容性测试。

问题排查

常见问题包括：SDK 版本冲突（修改 ohos 插件版本）、资源引用错误（检查 $r 语法）、签名失败（确保证书密码正确）。查看 Logcat 输出或使用 hilog 命令过滤日志：

hilog | grep HCCDA