一、系统准备与下载
1. 系统要求
操作系统：Windows 10/11（64 位）、macOS 11 及以上（X86/ARM）、Linux（需自行编译）。
硬件配置：至少 8GB 内存、100GB 硬盘空间，推荐 16GB 内存 + SSD 以提升编译速度。
2. 下载 DevEco Studio
官网下载：访问华为开发者官网，点击「立即下载」获取最新稳定版（如 5.0.5.306）。
版本选择：
Release版：适合生产环境，功能成熟。
Beta1 版：适合尝鲜，包含最新特性但可能不稳定。
二、安装与初始化
1. 安装步骤（以 Windows 为例）
解压安装包：下载完成后，解压devecostudio-windows-xxx.zip 到指定目录（如D:\Huawei\DevEco Studio）。
启动安装向导：运行devecostudio.exe，选择安装路径（建议非系统盘），勾选「添加到环境变量」以方便命令行调用。
安装依赖：安装过程中会自动下载并安装OpenJDK 1.8（内置）、Gradle等工具。
2. 首次启动配置
导入设置：首次启动时选择「Do not import settings」，跳过旧配置迁移。
登录华为账号：点击右上角头像登录，用于访问云服务、下载模拟器镜像等。
安装 HarmonyOS SDK：
进入Settings > OpenHarmony SDK，选择需要的 SDK 版本（如API 12），点击「Download」安装。
若网络受限，可提前在官网下载离线包，通过「Add Local SDK」导入。
三、创建第一个 Hello World 应用
1. 新建项目
选择模板：点击Create HarmonyOS Project，选择设备类型（如 Phone）和模板（如Empty Ability）。
配置项目：输入应用名称、包名（如com.example.myapp），选择兼容的 SDK 版本（需与模拟器一致）。
等待同步：项目创建后，Gradle 会自动下载依赖（首次可能较慢，可通过替换镜像源加速）。
2. 编写代码
ArkTS 示例（entry/src/main/ets/pages/Index.ets）：
@Entry
@Component
struct Index{
@State message: string = 'Hello World';
build() {
RelativeContainer() {
Text(this.message)
.id('ThreeHelloWorld')
.fontSize($r('app.float.page_text_font_size'))
.fontWeight(FontWeight.Bold)
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
.onClick(() => {
this.message = 'Welcome';
})
}
.height('100%')
.width('100%')
}
}
3. 运行与调试
启动模拟器：
点击Tools > HVD Manager，选择设备类型（如Huawei_Phone），下载并启动模拟器。
若设备 API 版本与项目不匹配，需在Project Structure中调整compileSdkVersion 和targetSdkVersion。
编译运行：点击工具栏Run按钮（或按Shift+F10），选择模拟器设备，等待应用安装并启动。
四、无网络环境下的安装与使用
1. 离线下载依赖
SDK 离线包：
在联网设备上访问HarmonyOS SDK 下载页面，下载所需 SDK 版本的离线包（如openharmony-sdk-windows-xxx.zip）1020。
将离线包拷贝到离线设备，通过Settings > OpenHarmony SDK > Add Local SDK导入。
Gradle 配置：
提前下载 Gradle 压缩包（如gradle-8.6-bin.zip），解压到本地目录（如D:\gradle）。
修改项目gradle/wrapper/gradle-wrapper.properties，将distributionUrl 指向本地路径：
distributionUrl=file:///D:/gradle/gradle-8.6-bin.zip
同步项目后，Gradle 将使用本地文件。
2. 手动安装插件
中文语言包：提前下载chinese-simplified-intellij-2023.2.zip，通过Settings > Plugins > Install from Disk安装。
五、常见问题与优化
1. Gradle 下载失败
解决方案：
替换为国内镜像源：在gradle.properties 中添加：
org.gradle.daemon=true
org.gradle.jvmargs=-Xmx4g
android.useAndroidX=true
android.enableJetifier=true
# 腾讯云镜像
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.6-bin.zip
使用代理工具（如 Charles）加速下载。
2. 模拟器启动失败
检查项：
确保电脑启用虚拟化技术（BIOS 中开启 Intel VT-x/AMD-V）。
关闭杀毒软件或添加信任目录。
·##鸿蒙开发工具##DevEco Studio##商务#