一、开发前准备

1、华为开发者账号注册流程

1）、华为开发者联盟账号注册地址：点此链接直达

如下图所示：

2）、登录华为开发者联盟

点击管理中心或者头像-立即登录


使用华为手机扫码登录或者账号密码登录即可。

3）实名认证自行认证。

3、电脑环境要求检查（JDK、Node.js、内存等）

二、DevEco Studio安装

DevEco Studio 是 HarmonyOS 应用及服务的集成开发环境（IDE），提供了一站式的开发平台，包括代码编辑、编译构建、代码调试、性能调优、模拟器、应用测试等能力。（来自官网）

1、下载渠道与版本选择（推荐稳定版）

下载中心：点击直达

根据对应的电脑系统与芯片选择要下载的版本
【Tips】：如果是Mac电脑，可以如下操作查看芯片架构

命令行查看：终端输入 uname -m，输出arm64或aarch64，则为ARM架构；输出x86_64，则为x86架构

2、安装步骤与组件选择

【Tips】所有操作基于Mac系统
为保证DevEco Studio正常运行，建议电脑配置满足如下要求：

• 操作系统：macOS(X86) 11/12/13/14/15、 macOS(ARM) 12/13/14/15
• 内存：8GB及以上
• 硬盘：100GB及以上
• 分辨率：1280*800像素及以上

1）安装：下载完成后直接拖拽安装即可

2）下载SDK

路径：DevEco Studio > Settings > OpenHarmony SDK

3）、诊断开发环境

菜单栏 Help > Diagnostic Tools > Diagnose Development Environment

3、配置中文简体

File > Settings > Appearance & Behavior > System Settings > Language

不过小鱼习惯了使用英文的IDE，总感觉切换成汉语意思怪怪的。无伤大雅，全凭个人喜好 🙏。

三、SDK配置与管理

在前面下载步骤已经截图了SDK Manger页面，下面具体介绍一下

1）SDK列表区域

位于界面左侧，展示已安装和可下载的SDK版本。包括HarmonyOS API版本、工具链（如OpenHarmony NDK）、模拟器等。支持按类型筛选，如“已安装”、“未安装”或“可更新”。

2）操作按钮组

底部或侧边提供核心操作按钮：

• 安装/更新：下载并配置选定SDK。
• 卸载：移除不再需要的SDK版本。
• 设置代理：配置网络代理以加速下载。

2、HarmonyOS SDK版本选择策略

HarmonyOS SDK版本选择需综合考虑项目需求、设备兼容性、API稳定性及开发周期等因素。以下为关键策略：

1）评估目标设备与API需求

• 确认目标设备支持的HarmonyOS版本范围，优先选择覆盖大多数设备的SDK版本。
• 检查所需API功能是否在候选版本中提供，避免因功能缺失导致开发受阻。

2）稳定性与长期支持

• 优先选择官方标记为LTS（长期支持）的版本，确保获得持续的安全更新和漏洞修复。
• 避免使用早期预览版或实验性版本，除非有特定功能需求且能接受潜在风险。

3）开发工具链兼容性

• 确保IDE（如DevEco Studio）与所选SDK版本完全兼容，避免工具链冲突。
• 验证第三方库或插件对SDK版本的依赖性，防止集成时出现兼容性问题。

4）社区与文档资源

• 选择文档齐全、社区活跃的版本，便于问题排查和学习参考。
• 参考官方发布日志，了解版本间的重大变更，评估升级或降级成本。

5）分阶段验证策略

• 在开发初期通过模拟器和真机测试验证核心功能在不同SDK版本下的表现。
• 针对关键用户场景进行多版本兼容性测试，确保覆盖边缘情况。

6）升级路径规划

• 制定清晰的版本升级路线，平衡新特性引入与系统稳定性。
• 预留测试周期，确保版本切换不会影响现有功能或用户体验。

注：具体版本选择可参考华为官方发布的HarmonyOS版本生命周期表，结合项目时间线做出决策。

3、模拟器镜像下载与安装

本小鱼 X86 不支持模拟器，就不介绍啦

四、创建第一个项目

1、项目模板选择：Empty Ability（Stage模型）

2、关键配置项解析

Project name：项目名称
Bundle name：同Android的包名，命名规范如下

• 使用反向域名表示法 包名通常采用反向域名格式，确保全球唯一性；
• 全小写字母；
• 避免使用特殊字符；
• 明确层级结构；
• 简洁且有意义

Compile SDK版本选择：需根据项目需求、目标设备及开发工具链的兼容性综合考虑。
以下是关键因素和推荐策略：

• 目标设备与系统版本
• 开发工具链兼容性
• 新特性与兼容性权衡

五、项目结构深度解析

MyApplication/
├── AppScope/           # 全局资源目录
│   ├── resources/      # 多语言、媒体资源
│   └── app.json5       # 全局配置文件
├── entry/              # 主模块
│   ├── src/
│   │   ├── main/
│   │   │   ├── ets/
│   │   │   │   ├── entryability/
│   │   │   │   │   └── EntryAbility.ets
│   │   │   │   └── pages/
│   │   │   │       └── Index.ets
│   │   │   ├── resources/ # 模块资源
│   │   │   └── module.json5 # 模块配置
│   └── oh-package.json5  # 依赖配置
├── oh_modules/         # 依赖库目录
└── build-profile.json5 # 构建配置

六、实践

1、运行 - 签名

2、实战

• 修改应用名称：编辑entry/src/main/resources/base/element/string.json的EntryAbility_label字段，改为 “夏小鱼鸿蒙应用”

• 修改应用图标：替换AppScope/resources/base/media/icon.png 改为huaweilogo.png

• 修改首页文本：编辑Index.ets中的Text组件，将显示的"Hello World"改为"你好，夏小鱼！"