《鸿蒙HarmonyOS 5.0开发教程》基础篇02:创建第一个鸿蒙项目

994 阅读3分钟

一、创建项目

1、新建项目

打开 DevEco Studio,按照如下步骤,新建我们的第一个鸿蒙项目:

  1. 选择“Create Project”新建项目
  2. 选择第一个“Empty Ability”空白窗口模板
  3. 点击“Next”进入下一步

image-20250114131644378.png

2、项目基本信息

新建鸿蒙项目时,需要配置以下几个基础信息,配置完成后,点击“Fnish”即可完成项目的创建。

image-20250114140335511.png

配置说明(详细说明可以参考官方文档):

  1. Project name:项目工程名称,长度范围为1 ~ 200个字符,必须以字母开头,且只能包含字母、数字和下划线;
  2. Bundle name:标识应用的包名,用于标识应用的唯一性;
  3. Save location:项目工程文件本地存储路径,由大小写字母、数字和下划线等组成,不能包含中文字符;
  4. Compatible SDK:兼容的最低 API Version;
  5. Module name: 模块的名称;
  6. **Device type:**该项目工程支持的设备类型;
    • Phone:手机设备
    • Tablet:平板设备
    • 2in1:融合了屏幕触控和键鼠操作的二合一设备
    • Car:车机设备

3、项目创建完成

项目创建完成后,在 DevEco Studio 中大致能看到如下所示的项目结构及代码:

image-20250114142006518.png

二、运行预览鸿蒙应用

DevEco Studio 一共提供了三种方式来运行鸿蒙应用程序:

  1. Previewer 预览器实现 UI 界面预览:启动更新速度快,但只支持基础功能;
  2. 手机模拟器运行应用:启动更新速度较慢,但能支持大部分功能;
  3. 本地真机运行应用:启动更新速度较慢,支持所有功能;

1、Previewer 预览器

使用 Previewer 预览器进行页面预览的步骤如下:

  1. 打开需要预览的页面文件;
  2. 点击右侧“Previewer”,打开预览器;

202501141434781.png

2、手机模拟器运行应用

要使用手机模拟器运行鸿蒙应用,需要先通过 DevEco Studio 在电脑中安装手机模拟器,然后再在模拟器中运行应用。

(1)新建模拟器

通过“Device Manager”设备管理器,选择好模拟器的安装路径后,点击“+ New Emulator”新建模拟器:

image-20250114230545944

(2)下载模拟器

选择设备类型“Phone”,设置模拟器 SDK 文件的存储路径,然后点击设备后的下载按钮,进行手机模拟器下载:

image-20250114232113811

下载完成后,点击“Finish”返回“Select Virtual Device”设备选择页面。

(3)设置模拟器名称

image-20250114235130976

(4)启动模拟器

模拟器安装成功后,回到设备管理页面,就可以看到对应的Phone设备,点击末尾绿色的启动按钮,就可以在电脑中启动一个手机模拟器:

image-20250115000023538

(5)模拟器运行应用

选中“Phone”设备后,点击旁边的绿色启动按钮,将项目编译运行到模拟器中:

image-20250115000820831

到此,我们的第一个鸿蒙项目就算是创建并运行成功了。