1. 鸿蒙应用开发入门指南最近两年鸿蒙生态发展迅猛身边不少开发者朋友都在尝试鸿蒙应用开发。作为一个从Android转战鸿蒙的老兵我深刻理解新手入门时的困惑。今天就用最直白的方式带大家完成从零到一的鸿蒙应用创建全过程。鸿蒙应用开发最大的特点就是一次开发多端部署。简单说就是你写一套代码可以同时运行在手机、平板、智能手表等各种设备上。这得益于鸿蒙的分布式架构设计开发者不用再为不同设备单独适配效率提升非常明显。开发工具方面华为提供了DevEco Studio这个官方IDE。它基于IntelliJ平台开发用过Android Studio的朋友会感觉非常熟悉。工具内置了代码编辑、UI设计、调试、模拟器等全套功能对新手特别友好。2. 开发环境搭建2.1 安装DevEco Studio首先访问华为开发者联盟官网找到DevEco Studio的下载页面。根据你的操作系统选择对应版本Windows/macOS/Linux都支持。我这里以Windows为例下载最新版的exe安装包目前是3.1版本双击安装包建议选择默认安装路径安装过程中会提示安装Node.js和Ohpm包管理器这两个都要勾选安装完成后首次启动会进入配置向导注意安装路径不要包含中文或特殊字符否则可能导致后续构建失败。我遇到过有同事路径带空格导致gradle报错的情况。2.2 配置SDK第一次启动DevEco Studio时会自动检测本地SDK环境。如果没有安装过鸿蒙SDK会提示下载在SDK Setup界面勾选最新版的SDK推荐API 9选择SDK存储路径建议至少预留10GB空间同意License协议后开始下载下载完成后可以在Preferences Appearance Behavior System Settings HarmonyOS SDK中查看已安装的SDK版本。建议把Automatically download missing SDK components选项勾上这样后续创建项目时会自动补全需要的组件。2.3 创建华为开发者账号为了使用真机调试和后续应用上架需要注册华为开发者账号访问华为开发者网站注册账号完成实名认证个人开发者选择身份证认证在DevEco Studio中登录账号File Settings Appearance Behavior System Settings HarmonyOS SDK HarmonyOS Account3. 创建第一个项目3.1 新建工程打开DevEco Studio点击Create Project这里会看到多种项目模板Application普通应用项目Atomic Service元服务项目Library库模块其他模板对于新手建议选择Empty Ability模板这个最基础也最容易理解。填写项目信息时注意Project Name项目名称不要用中文Bundle Name包名建议com.公司名.项目名格式Save Location项目路径Compile SDK选择API 9ModelStage模型推荐点击Finish后IDE会自动创建项目结构并初始化gradle。第一次创建可能会慢一些需要下载相关依赖。3.2 项目结构解析创建完成后左侧项目面板会显示如下结构MyApplication ├── AppScope │ └── resources # 全局资源 ├── entry # 主模块 │ ├── src │ │ ├── main │ │ │ ├── ets │ │ │ │ ├── pages # 页面目录 │ │ │ │ └── entryability # 入口ability │ │ │ └── resources # 模块资源 │ │ └── ohosTest # 测试代码 │ └── build-profile.json5 # 模块配置 └── build-profile.json5 # 工程配置重点目录说明ets/pages存放所有页面文件每个页面一个文件夹entryability应用入口类似Android的MainActivityresources存放图片、字符串等资源文件3.3 运行Hello World默认项目已经包含一个简单的页面在entry/src/main/ets/pages/Index.ets中。我们可以直接运行看看效果点击工具栏上的Device Manager选择Local Emulator标签页下载一个手机模拟器推荐P50 Pro镜像启动模拟器后点击运行按钮稍等片刻就能在模拟器上看到Hello World的文本显示了。恭喜你第一个鸿蒙应用已经跑起来了4. 项目配置详解4.1 配置文件解析鸿蒙项目有几个重要的配置文件需要了解app.json5全局配置{ app: { bundleName: com.example.myapplication, vendor: example, versionCode: 1, versionName: 1.0.0, icon: $media:app_icon, label: $string:app_name } }module.json5模块配置{ module: { name: entry, type: entry, description: $string:module_desc, mainElement: EntryAbility, deviceTypes: [phone, tablet], deliveryWithInstall: true, pages: $profile:main_pages, abilities: [ { name: EntryAbility, srcEntry: ./ets/entryability/EntryAbility.ts, icon: $media:icon, label: $string:EntryAbility_label, startWindowIcon: $media:icon, startWindowBackground: $color:start_window_background } ] } }build-profile.json5构建配置{ app: { signingConfigs: [], products: [ { name: default, signingConfig: default, compileSdkVersion: 9, compatibleSdkVersion: 9, runtimeOS: HarmonyOS } ] } }4.2 修改应用图标替换应用图标很简单准备一张512x512的png图片放到AppScope/resources/base/media目录下在app.json5中修改icon字段指向新图片清理构建后重新运行4.3 多设备适配鸿蒙应用天生支持多设备主要通过以下方式适配在module.json5中声明支持的设备类型使用响应式布局语法为不同设备提供不同的资源文件例如要为平板和手机提供不同的布局resources/ ├── base/ │ └── layout/ # 默认布局 └── tablet/ └── layout/ # 平板布局5. 常见问题解决5.1 构建失败处理新手常遇到的构建问题网络问题导致依赖下载失败解决方法检查代理设置或使用国内镜像源SDK版本不匹配解决方法确保compileSdkVersion和本地安装的SDK版本一致签名配置错误解决方法在Project Structure中配置正确的签名证书5.2 真机调试用真机调试比模拟器更流畅手机开启开发者模式设置-关于手机-连续点击版本号开启USB调试连接电脑后在DevEco Studio中选择你的设备首次运行需要自动签名等待签名完成即可5.3 资源引用问题引用资源时要注意图片$media:ic_launcher颜色$color:red字符串$string:app_name尺寸$float:margin_medium错误的引用方式会导致资源找不到报错。6. 项目进阶建议完成基础环境搭建后可以尝试以下进阶操作添加新页面右键pages文件夹选择New Page使用UI组件尝试Button、TextInput等基础组件页面导航学习router.pushUrl的用法状态管理了解AppStorage和LocalStorage的区别网络请求使用ohos.net.http模块我最近在开发一个天气应用的开源项目完整展示了鸿蒙应用的开发流程。项目地址放在GitHub上新手可以参考这个项目的结构设计和代码实现。刚开始建议多看看官方Sample理解鸿蒙的设计理念和最佳实践。