DevEco Studio 安装与使用全流程

一、系统准备与下载

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 为例）

1. 解压安装包 ：下载完成后，解压?devecostudio-windows-xxx.zip?? 到指定目录（如?D:HuaweiDevEco Studio?）。
2. 启动安装向导 ：运行?devecostudio.exe?，选择安装路径（建议非系统盘），勾选「添加到环境变量」以方便命令行调用。
3. 安装依赖 ：安装过程中会自动下载并安装 OpenJDK 1.8 （内置）、Gradle等工具。

2. 首次启动配置

1. 导入设置 ：首次启动时选择「Do not import settings」，跳过旧配置迁移。
2. 登录华为账号 ：点击右上角头像登录，用于访问云服务、下载模拟器镜像等。
3. 安装 HarmonyOS SDK ：

• 进入 Settings > OpenHarmony SDK ，选择需要的 SDK 版本（如 API 12 ），点击「Download」安装。
• 若网络受限，可提前在官网下载离线包，通过「Add Local SDK」导入。

三、创建第一个 Hello World 应用

1. 新建项目

1. 选择模板 ：点击 Create HarmonyOS Project ，选择设备类型（如 Phone）和模板（如 Empty Ability ）。
2. 配置项目 ：输入应用名称、包名（如?com.example.myapp?），选择兼容的 SDK 版本（需与模拟器一致）。
3. 等待同步 ：项目创建后，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. 运行与调试

1. 启动模拟器 ：

• 点击 Tools > HVD Manager ，选择设备类型（如 Huawei_Phone ），下载并启动模拟器。
• 若设备 API 版本与项目不匹配，需在Project Structure中调整?compileSdkVersion?? 和?targetSdkVersion?。

2. 编译运行 ：点击工具栏Run按钮（或按?Shift+F10?），选择模拟器设备，等待应用安装并启动。

四、无网络环境下的安装与使用

1. 离线下载依赖

1. SDK 离线包 ：

• 在联网设备上访问?[?HarmonyOS SDK 下载页面?]??，下载所需 SDK 版本的离线包（如?openharmony-sdk-windows-xxx.zip?）1020。
• 将离线包拷贝到离线设备，通过Settings > OpenHarmony SDK > Add Local SDK导入。

2. 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##商务#

审核编辑 黄宇