鸿蒙应用开发从入门到实战(三):第一个鸿蒙应用

​ 大家好,我是潘Sir,持续分享IT技术,帮你少走弯路。《鸿蒙应用开发从入门到项目实战》系列文章持续更新中,欢迎关注!

一、创建第一个HarmonyOS项目

说明:不同版本的DevEco Studio界面有所不同,创建项目步骤基本相同

开发鸿蒙应用,需要先创建一个项目,双击上一小节安装的DevEcoStudio图标,打开项目创建界面:

进入创建应用页面,选择应用模板中的Empty Ability模板:

填写项目信息,其中Project name、Bundle name、Save location都可以自定义:

    • Project name:项目名称
    • Bundle name:包名,通常为公司域名倒置
    • Save location:项目目录

点击Finish完成创建。

项目创建完成后,主界面功能区如图

二、HarmonyOS项目目录结构分析

项目结构相对复杂,先简单了解即可,随之后序学习的深入再逐步为大家介绍

各重要文件说明

typescript 复制代码
AppScope > app.json5:应用的全局配置信息,详见app.json5配置文件。
entry:HarmonyOS工程模块,编译构建生成一个HAP包。
src > main > ets:用于存放ArkTS源码。
src > main > ets > entryability:应用/服务的入口。
src > main > ets > entrybackupability:应用提供扩展的备份恢复能力。
src > main > ets > pages:应用/服务包含的页面。
src > main > resources:用于存放应用/服务所用到的资源文件,如图形、多媒体、字符串、布局文件等。关于资源文件,详见资源分类与访问。
src > main > module.json5:模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明,详见module.json5配置文件。
build-profile.json5:当前的模块信息 、编译信息配置项,包括buildOption、targets配置等。
hvigorfile.ts:模块级编译构建任务脚本。
obfuscation-rules.txt:混淆规则文件。混淆开启后,在使用Release模式进行编译时,会对代码进行编译、混淆及压缩处理,保护代码资产。详见开启代码混淆。
oh-package.json5:用来描述包名、版本、入口文件(类型声明文件)和依赖项等信息。
oh_modules:用于存放三方库依赖信息。
build-profile.json5:工程级配置信息,包括签名signingConfigs、产品配置products等。其中products中可配置当前运行环境,默认为HarmonyOS。
hvigorfile.ts:工程级编译构建任务脚本。
oh-package.json5:主要用来描述全局配置,如:依赖覆盖(overrides)、依赖关系重写(overrideDependencyMap)和参数化配置(parameterFile)等。

三、HarmonyOS项目运行方式

DevEco Studio提供了多种方式用于运行项目,包括预览、模拟器和真机运行。

1、预览项目

Previewer预览用于查看应用的UI界面效果,方便随时调整界面UI布局。只需打开需要预览的页面文件,例如下图中的Index.ets,然后点击IDE右侧的Perviewer即可看到预览效果。

2、模拟器运行

我们也可以利用设备模拟器来查看更真实的效果。首次使用需要先安装配置模拟器。

首先,选择主菜单中的Tools,找到其中的Device Manager,即设备管理:

设备可以是远端设备,也可以是本地设备,我们以本地设备为例。

默认本地没有任何设备,选择install来安装一个:

首次点击时,会弹出一个窗口,下载必要的SDK依赖:

等待一段时间的下载之后,选择Finish。

进入创建模拟器页面,选择New Emulator:

添加手机模拟器:

选择对应的版本,首次进入此页面,需要下载手机设备需要的系统,需要耐心等待:

下载完成后,才可以选中,然后点击Next,进入下一步:

点击finish

创建完成后,在设备列表中会出现一个本地设备,点击后面的运行按钮即可启动设备模拟器:

启动后如图:

然后,在应用启动位置选择刚刚添加的模拟器:

点击启动,可以将应用部署到模拟器:

这样就可以在模拟器上看到项目运行效果,效果与预览类似:

3、真机运行

使用模拟器运行应用时,会占用电脑较多的资源,并且有些功能无法进行测试。当模拟器不满足要求时,可选择真机运行。真机运行的步骤如下

(1)准备一台装有Harmony OS系统的手机,系统版本最好为4.0.0及以上,系统版本可在设置/关于手机 中查看

(2)打开手机的开发者模式。在设置/关于手机 中,连续多次点击系统版本号,直至出现您正处在开发者模式! 的提示信息

(3)开启USB调试。在系统与更新/开发人员选项 中,打开USB调试开关

(4)使用USB数据线将手机和电脑相连,手机会弹框提示选择USB 连接方式 ,需要选择传输文件 。

(4)之后会弹窗询问是否允许USB调试? ,可勾选始终允许使用这台计算机进行调试,然后点击确定

(5)回到IDE,在右上角的设备列表中选择连接的手机(默认已选中)

(6)最后点击运行按钮,即可将项目运行到真机中。首次运行会提示缺少签名信息,点击Open signing configs进行配置即可。

(6)生成签名信息需要先登陆华为开发者账号,点击Sign In

(7)浏览器会自动跳转到登录页面,按照要求完成注册、登录即可

(8)登录成功后,回到IDE,再次点击运行按钮,即可将应用运行到真机。

《鸿蒙应用开发从入门到项目实战》系列文章持续更新中,欢迎关注!

相关推荐
用户861941772074114 小时前
uni-app 的蓝牙 API 在鸿蒙上不生效?我写了个兼容层,让老代码零改动跑起来
harmonyos
HarmonyOS_SDK15 小时前
【HarmonyOS SDK Skills】挂载 Agent Skill,轻松跑通鸿蒙应用广告变现
harmonyos
闫东阳LordGalaxy16 小时前
给小艺装上数学能力:数易 App 接入智能体 FunctionComponent 与 A2A 双通路实战
harmonyos
Dream-Y.ocean17 小时前
鸿蒙PC平台逻控 PLC 编辑器适配实战:基于 Electron 壳方案的纯 JavaScript 梯形图编程与仿真引擎开发
javascript·编辑器·harmonyos
OH_TPC19 小时前
HarmonyOS APP开发---"好物清单"购物清单App,需要用到这个库
harmonyos
贾伟康1 天前
【鸿蒙心迹】个人开发者上架复盘:备案、合规与审核指南没写透的细节
华为·harmonyos
码间留白1 天前
uni-app 鸿蒙离线打包:一个改动从源码到真机要穿过几条链
uni-app·鸿蒙·deveco·离线打包·uts插件
不爱学英文的码字机器1 天前
2026鸿蒙远程控制软件完全选购指南:从入门到精通选型攻略
华为·harmonyos
贾伟康2 天前
【共创稿事节】HarmonyOS 7.0 BindContentCover全屏模态:从接入到生产验证
性能优化·实战·harmonyos·arkts·arkui
KevinChaos2 天前
声音明信片实验室 03|HarmonyOS 7.0 音频空间化:双版本试听无缝切换
harmonyos