拆解 HCCDA 鸿蒙应用实验：环境配置与基础操作步骤-优快云博客

环境配置

安装DevEco Studio
从华为开发者官网下载最新版DevEco Studio，支持Windows和macOS系统。安装过程中需勾选HarmonyOS SDK组件，默认包含OpenHarmony工具链。

配置SDK路径
启动DevEco Studio后，在Preferences > Appearance & Behavior > System Settings > HarmonyOS SDK中检查SDK路径。若未自动识别，需手动指定本地存储路径并下载API 7+的SDK版本。

创建模拟器
在Device Manager中选择Phone设备模板，下载API 7的系统镜像。创建P40 Pro模拟器时建议分配4GB以上内存，开启硬件加速需确保BIOS中VT-x/AMD-V已启用。

项目初始化

新建工程模板
选择"Empty Ability"模板，配置项目名称（如HCCDA_Demo）、包名（com.example.hccda）和保存路径。注意Compile SDK版本需与模拟器API版本一致，Model勾选"Stage"模型。

Gradle同步
首次构建会自动下载依赖库，若出现网络超时，需在gradle.properties中添加阿里云镜像源：

systemProp.http.proxyHost=mirrors.aliyun.com
systemProp.http.proxyPort=80

基础开发操作

界面布局设计
在entry > src > main > resources > base > layout中编辑xml文件。使用DirectionalLayout时，需设置ohos:width="match_parent"和ohos:height="match_content"属性，组件间距通过ohos:margin系列属性控制。

Ability生命周期实现
在MainAbility.ts中重写关键生命周期方法：

onWindowStageCreate(windowStage: window.WindowStage) {
  windowStage.loadContent('pages/index', (err) => {
    if (err.code) console.error('加载页面失败')
  })
}

调试与部署

日志输出
使用HiLog类打印调试信息，需先定义domain标签：

const TAG = 0xFF00
HiLog.info(TAG, '调试信息')

通过IDE的Logcat窗口过滤"HiLog"查看输出。

真机测试配置
在File > Project Structure > Signing Configs中配置应用签名证书。需提前在AGC控制台生成p12证书文件，调试时开启"Automatically sign in debug mode"选项。

常见问题处理

资源引用异常
当出现$r('app.string.xxx')报错时，检查resources > base > element目录下的string.json文件是否正确定义了资源ID，多语言场景需在en_US等子目录同步配置。

热重载失效
修改代码后未触发实时更新时，在DevEco Studio中执行Build > Clean Project，并确认已开启Enable Hot Reload功能。若使用预览器，需手动点击刷新按钮。