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:\Huawei\DevEco 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@Componentstruct 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=trueorg.gradle.jvmargs=-Xmx4gandroid.useAndroidX=trueandroid.enableJetifier=true# 腾讯云镜像distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.6-bin.zip

• 使用代理工具（如 Charles）加速下载。

2. 模拟器启动失败

• 检查项：

• 确保电脑启用虚拟化技术（BIOS 中开启 Intel VT-x/AMD-V）。

• 关闭杀毒软件或添加信任目录。

##鸿蒙开发工具 ##DevEco Studio##商务 #