第一个鸿蒙应用-HelloWorld

DevEco Studio 配置开发环境完成后,通过运行 Hello World 工程来验证环境设置是 否正确。接下来以创建一个 Phone 设备的工程为例进行介绍。

1. 创建一个新工程

  • 步骤1:打开 DevEco Studio,在欢迎页单击 Create Project,创建一个新工程。

image-20240305155130178

  • 步骤 2 :根据工程创建向导,选择创建 Application 或 Atomic Service。选择“[OpenHarmony]Empty Ability”模 板<先基于OpenHarmony学习,可以使用最新版的sdk>,然后单击 Next。

image-20240305160001659

关于工程模板的介绍和支持的设备类型,请参考工程模板

模板名称 说明
Empty Ability 用于 Phone、Tablet、TV、Wearable 设备 的 Feature Ability 模板,展示了基础的 Hello World 功能。
Native C++ 用于 Phone、Car、Tablet 设备的 Feature Ability 模板,作为应用/服务调用 C++代 码的示例工程,界面显示“Hello World”。
[Lite]Empty Ability 用于 Lite Wearable、Smart Vision、 Router 设备的 Feature Ability 模板,包含 一个简单的 Hello World 文本。该模板包 含两个组件:div 和 text,同时演示了数 据绑定的使用方式。使用该模板时,不 能同时选择多个设备,即不能创建跨设 备工程。
[OpenHarmony]Empty Ability 用于创建支持 OpenHarmony 工程的 Feature Ability 模板,展示了基础的 Hello World 功能。
About Ability 用于 Phone、Tablet 设备的模板,可以快 速创建应用的关于页面。模板的上方通 过基础组件 Image、Text 展示了应用的基 本信息,点击中间的 List 组件可以打开 详情页,下方使用 Web 组件加载了用户 协议和隐私声明的 Html 文件。开发者可 以在模板的基础上,补充 List 内容,替换相关显示信息。
Business Card Ability 用于 Phone、Tablet 设备的模板,可以快 速创建应用的名片页面。模板底部通过 Tab 组件实现不同名片的切换,中间的详 情 List 组件使用了不同的 Widget,如 Information 图标、Switch 开关、右侧箭 头图标等。开发者可以根据需要替换用 户名称和 List 组件内容。
Category Ability 用于 Phone、Tablet 设备的模板,可以快 速创建应用的分类展示页面。模板上方 是 Navigation 组件和 search 组件,下方 是 Tab 组件。中间的 List 组件有联动, 点击左边 List 的分类项,右边 List 会滑 动到对应位置,反之亦然。开发者可以 根据需要替换相关内容。
Category List Ability 用于 Phone、Tablet 设备的模板,可以快 速创建应用的卡片型设置页面。模板上 方是 Navigation 组件和 search 组件,中 间的 List 组件参考 Settings 的界面风格, 由子标题加 List 卡片组成。开发者可以 根据需要替换标题和每一个设置项的内 容。
Grid Ability 用于 Phone、Tablet 设备的模板,可以快 速创建应用的网格布局页面。模板上方 是 Navigation 组件,中间分割成两个大 小不同的 Grid 组件,每个 Grid 组件的 Item 等比例显示。开发者可以通过模板 学习 Grid 组件的使用方式。
List Ability 用于 Phone、Tablet 设备的模板,可以快 速创建应用的列表页面。模板上方是 Navigation 组件和 search 组件,下方是 Tab 组件。中间的 List 组件使用了双行布 局,点击打开详情页。开发者可以根据 需要替换双行列表和辅助文本内容。
Login Ability 用于 Phone、Tablet 设备的模板,可以快 速创建应用的登录页面。用户输入账号 和密码之后,才能点击登录按钮。点击 登录、注册和遇到问题分别会跳转到示 例页面。模板底部使用 Web 组件加载了 隐私声明的 Html 文件。开发者可以补充 账号密码的存储逻辑,完善登录功能。
Splash Screen Ability 用于 Phone、Tablet 设备的模板,可以快 速创建应用的启动过程页面。模板右上角显示倒计时图标,点击跳过按钮或者 等倒计时结束都会进入应用主界面,下 方提供了应用的版权信息。开发者可以 设置倒计时时间,根据需要整体替换广 告背景。
Empty Ability with CloudDev 端云一体化开发通用模板。更多信息请 参见端云一体化开发。
  • 步骤 3 :在工程配置页面,需要根据向导配置工程的基本信息。

image-20240305160412653

  • Project name:工程的名称,可以自定义,由大小写字母、数字和下划线组成。

  • Bundle name:应用的包名,用于标识应用的唯一性。

  • Save location:工程文件本地存储路径,由大小写字母、数字和下划线等组成,不 能包含中文字符

  • Compile SDK:应用/服务的目标 API Version,在编译构建时,DevEco Studio 会根 据指定的 Compile API 版本进行编译打包。

  • Compatible SDK:兼容的最低 API Version。

  • Module name: 模块的名称。

  • Model:应用支持的模式,API Version 4~8 只支持 FA 模式。

  • Enable Super Visual:支持低代码开发模式。部分模板支持低代码开发,可选择打 开该开关。当前仅 API 9 及以下工程支持低代码开发。

  • Device type:该工程模板支持的设备类型。

  • Node:配置当前工程运行的 Node.js 版本,可选择使用已有的 Node.js 或下载新的 Node.js 版本。

当前 DevEco Studio 需分别配置 IDE 级 Node.js 和工程级 Node.js:

  • IDE 级 Node.js 用于支持 DevEco Studio 整体运行。安装 DevEco Studio 时,在配置向导中对 IDE 级 Node.js 进行配置。打开工程后,如需修改 IDE 级 Node.js 配置,单击 File > Settings > Build, Execution, Deployment > Node.js and npm (macOS 为 DevEco Studio > Preferences > Build, Execution, Deployment > Node.js and npm),在 Node.js home 中选择或下载其他 Node.js 版本。
  • 工程级 Node.js 服务于工程构建的运行过程。API Level 与 Node.js 版本配套关系请参见配套 关系。如需修改工程级 Node.js 配置,单击 File > Project Structure… > Project ,在 Basic Info 页签下选择或下载其他 Node.js 版本。
  • 步骤4:因为之前安装工具时下载安装的sdk是HarmonyOS的sdk,之前的步骤选择的模板是OpenHarmony,因此这一步需要再下载配置OpenHarmony的sdk

image-20240305161515566

  • 步骤5:单击 Finish,工具会自动生成示例代码和相关资源,等待工程创建完成。

image-20240305161749236

2. 运行Hello World

Hello World 工程可以运行在模拟器中,或者运行在真机设备中。本示例以选择将 Hello World 工程运行在模拟器中进行说明。

DevEco Studio 提供远程模拟器和本地模拟器,本示例以远程模拟器为例进行说明。

  • 步骤 1:在 DevEco Studio 菜单栏,单击 Tools > Device Manager。

image-20240305162314218

  • 步骤2:在 Remote Emulator 页签中单击 Sign In,在浏览器中弹出华为开发者联盟帐号登录界 面,请输入已实名认证的华为开发者联盟帐号的用户名和密码进行登录。

image-20240305162332841

登录后,请单击界面的允许按钮进行授权,授权完成后,切换回 Device Manager 界 面

image-20240305162634228

步骤 3: 在设备列表中,选择 合适的设备,并单击 按钮,运行模拟器。

image-20240305164306120

运气不好,P50提示unavailable,因为之前创建工程的时候选择的兼容的最低sdk版本是9,只有P50适配,结果用不了,那只有换本地的模拟器了。

步骤4:本地模拟器下载安装

image-20240305164626060

image-20240305164719845

单击 File > Settings > SDK,下 拉框选择 HarmonyOS,勾选并下载 Platforms 下的 System-image 和 Tools 下的 Emulator 资源。

image-20240305165333171

image-20240305165655328

下载完资源文件后,进入Device Manager中创建本地模拟器

image-20240305170318307

选择api9的模拟器版本进行创建

image-20240305170358436

image-20240305170448681

创建完成

image-20240305170529572

  • 步骤5:模拟器中运行第一个鸿蒙应用-Hello World

按照前面的步骤配置好本地模拟器后,即可将应用安装到模拟器中运行查看效果

image-20240305171205028

点击▲,安装运行app

image-20240305171757541

至此,鸿蒙应用开发Hello World开发完成。