【汇思博SEEK100开发板试用体验】3/第一次使用OpenHarmony

本分享贴，聚焦第一次上手的时候，可能出现的一些问题，希望对其他小伙伴也有帮助。

​​一、创建首个OpenHarmony工程​​

1. ​​选择开发范式​​
   • ​​声明式开发（eTS）​​：主流推荐，高性能开发框架，语法基于TypeScript扩展
     。
   • ​​类Web开发（JS）​​：沿用HML+CSS+JS传统模式，适合前端开发者
     。
2. ​​项目创建步骤​​
   • 打开DevEco Studio → Create Project→ 选择Empty Ability模板。
   • 关键配置：
     • Name：全英文项目名（如FirstApp）
     • Compile SDK：​​API 9​​（当前稳定版本）
     • Language：​​eTS​​（或JS）
     • Device Type：勾选目标设备（如Phone）
       。

​​二、编写第一个功能：修改欢迎语​​

1. ​​定位入口文件​​

   • eTS项目：entry/src/main/ets/pages/index.ets
   • JS项目：entry/src/main/js/pages/index/index.js

2. ​​修改核心代码​​

   // eTS示例：修改默认文本 @State message: string = '你好，OpenHarmony！' // 原内容为'Hello World'
   // JS示例：绑定点击事件（index.js） export default { data: { message: '点击按钮' }, onClick() { this.message = '欢迎使用OpenHarmony！'; } }
   <!-- JS配套模板（index.hml） --> <button value="{{message}}" onclick="onClick"></button>

​​三、实时调试与预览​​

1. ​​预览器（Previewer）​​
   • 右侧工具栏点击Previewer→ 实时渲染界面，支持热更新
     。
   • ​​优势​​：无需编译，秒级响应UI修改（如文本/布局调整）。
2. ​​真机调试​​
   • 连接设备 → 点击Run（三角形图标）→ 自动编译并安装到设备。
   • ​​断点调试​​：
     • 代码行左侧点击设置断点 → 点击甲虫图标（Debug模式）→ 查看变量状态
       。

​​四、签名打包与安装​​

1. ​​自动签名（推荐）​​

   • File → Project Structure → Signing Configs→ 勾选Automatically generate signing
     。
   • 点击Build → Build HAP(s)→ 生成entry-default-signed.hap（自动签名完成）。

2. ​​手动安装到设备​​

   hdc_std install entry-default-signed.hap # 通过HDC命令行工具安装
   • ​​成功标志​​：控制台输出msg:install bundle successfully，设备桌面显示应用图标
     。

​​五、高频问题速查​​

1. ​​安装冲突​​
   # 卸载旧版本 hdc_std uninstall [bundleName] # bundleName在app.json5中查看
2. ​​HDC设备未连接​​
   • 执行hdc_std list targets -v→ 检查设备状态是否为Connected。
   • ​​驱动冲突​​：关闭IDE并结束所有hdc_std.exe进程后重试
     。
3. ​​日志抓取​​
   hdc_std shell hilog | grep "error" # 过滤错误日志