2.3 创建第一个鸿蒙应用项目

创建第一个鸿蒙应用项目是开发鸿蒙应用的第一步。通过 DevEco Studio，开发者可以快速创建并运行一个简单的应用程序。本节将介绍如何从头开始构建一个基础的鸿蒙应用项目。

2.3.1 创建鸿蒙项目

步骤一：启动 DevEco Studio

  1. 打开已安装的 DevEco Studio。
  2. 在欢迎界面选择 New Project，或者通过菜单栏选择 File > New > Project。

步骤二：选择项目模板

  1. 在弹出的窗口中，选择项目类型：
    • Empty Ability：一个空的基础项目模板。
    • Empty Feature Ability：适用于拥有页面堆栈管理的项目。
    • Empty Page Ability：简化版本的 Ability，适用于轻量级应用。
  2. 选择 Empty Feature Ability 作为模板，点击 Next。

步骤三：填写项目信息

  1. 输入以下基本项目信息：
    • Project Name：项目名称，例如 FirstHarmonyApp。
    • Package Name：包名，例如 com.example.firstharmonyapp。
    • Device Type：目标设备类型，例如 Phone 或 Tablet。
  2. 点击 Finish，DevEco Studio 将自动生成项目文件。

2.3.2 项目结构解析

创建项目后，DevEco Studio 会生成以下项目结构：

  1. entry/src/main/：
    • config.json：应用的配置文件，定义应用 ID、权限等。
    • resources/：存放界面布局文件（xml）和资源文件（图片、字符串等）。
    • java/：包含应用逻辑代码。
  2. entry/src/test/：单元测试代码。
  3. build.gradle：
    • 项目的构建脚本，定义依赖和打包规则。

2.3.3 编写简单代码

修改主界面布局

  1. 打开 entry/src/main/resources/base/layout/ability_main.xml。
  2. 修改布局文件为以下内容：
    <DirectionalLayout
    xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:height="match_parent"
    ohos:width="match_parent"
    ohos:alignment="center"
    ohos:orientation="vertical">
    <Text
        ohos:id="$+id:welcome_text"
        ohos:height="wrap_content"
        ohos:width="wrap_content"
        ohos:text="Hello, HarmonyOS!"
        ohos:text_size="30fp"
        ohos:alignment="horizontal_center" />
</DirectionalLayout>

修改逻辑代码

  1. 打开 entry/src/main/java/com/example/firstharmonyapp/MainAbility.java。
  2. 确保 onStart 方法正确加载布局：
    @Override
public void onStart(Intent intent) {
super.onStart(intent);
super.setUIContent(ResourceTable.Layout_ability_main);
}

2.3.4 运行项目

步骤一：选择运行目标

  1. 在 DevEco Studio 工具栏中，选择运行按钮右侧的下拉菜单。
  2. 选择目标设备（模拟器或已连接的真机）。

步骤二：启动应用

  1. 点击运行按钮（绿色箭头）。
  2. 等待应用编译和安装完成。
  3. 应用启动后，设备或模拟器上会显示 Hello, HarmonyOS!。

2.3.5 常见问题排查

  1. 无法检测到目标设备：

  • 检查 USB 连接是否正常。
  • 确保目标设备开启了 开发者选项 和 USB 调试。

  1. 编译失败：

  • 确认 build.gradle 文件中配置的 SDK 和插件版本正确。
  • 检查控制台输出的错误日志，定位问题。

小结

通过上述步骤，开发者完成了第一个鸿蒙应用的创建和运行。通过简单的布局和逻辑代码示例，初步掌握了鸿蒙应用开发的流程。接下来可以进一步探索更复杂的功能和分布式能力的实现。

Last Updated::