HarmonyOS 4应用开发:1.从环境搭建到Hello World

发布时间:2023年12月18日

????????在踏上HarmonyOS应用开发之旅之前,需要进行一些必要的准备工作。首先,你需要下载并安装DevEco Studio,并进行相应的环境配置。

一、下载和安装DevEco Studio

  • 前往DevEco Studio官方的下载地址,点击“立即下载”跳转至下载页面。
  • DevEco Studio提供了Windows和Mac版本的选择,根据你的操作系统选择相应版本进行下载。
  1. 在Windows上进行安装

    • 下载完成后,双击下载的“deveco-studio-xxxx.exe”文件,启动DevEco Studio安装向导。
    • 在安装向导界面,选择安装路径。默认路径为“C:\Program Files”,你也可以点击“Browse…”选择其他安装路径,然后点击“Next”继续。
    • 在安装选项界面,勾选DevEco Studio,可以创建桌面快捷方式,然后点击“Next”,点击“install”,直至安装完成。
    • 安装完成后,点击“Finish”来结束整个安装过程。

现在,你已经成功安装了DevEco Studio,下一步就是运行DevEco Studio,然后开始配置开发环境!

二、配置开发环境

  1. 启动DevEco Studio配置向导

    ?双击已安装的DevEco Studio快捷方式,打开配置页面。IDE将自动进入配置向导。在配置向导中,选择同意相关条款,然后点击"Next"。

  2. 基础配置设置

    进入DevEco Studio配置页面后,首先进行基础配置。这包括设置Node.js和Ohpm的安装路径,选择从华为镜像下载并安装到适当的目录。点击"Next"进入SDK配置。

  3. SDK配置

    在SDK配置中,设置适当的路径,并点击"Next"。

  4. 在显示SDK许可协议后,阅读相关内容并勾选"Accept"。点击"Next"。

  5. 配置预览

    点击"Next"后,进入配置预览页。在这里确认配置项,确保设置符合需求。确认后,点击"Next"进入下一步。

  6. 等待配置自动下载

    等待配置自动下载完成,完成后点击"Finish"。IDE将进入欢迎页,这标志着我们已成功配置好开发环境。

通过以上步骤,你已经顺利完成了DevEco Studio的配置,现在可以愉快地开始开发了!

三、项目创建和运行

  1. 进入DevEco Studio创建项目

    完成前述准备工作后,现在我们将使用DevEco Studio进行项目的创建和运行。

  2. 创建项目

    • 如果这是你首次打开DevEco Studio,你将首先进入欢迎页。
    • 在欢迎页中,点击"Create Project",进入项目创建页面。
  3. 选择应用类型

    • 在项目创建页面,选择"Application",然后选择"Empty Ability"。点击"Next",进入工程配置页。
  4. 配置项目详细信息

    • 在配置页中,提供以下详细信息:
      • Project name: 这是开发者可以自行设置的项目名称。根据你的选择,修改为你的项目名称。
      • Bundle name: 包名称,默认情况下应用ID也会使用该名称,发布时需要保持一致。
      • Save location: 工程保存路径。
      • Compile SDK: 编译的API版本,默认选择API9。
      • Model: 选择"Stage"模型,其他保持默认即可。
      • Device Type:设备类型,Phone和Table类型分别代表可以运行在手机和平板上。

  5. 完成工程创建

    点击“Finish”按钮完成工程创建,然后等待工程同步完成。

通过以上步骤,你已经成功创建了一个项目,并准备好进行开发。接下来,你可以开始添加代码和其他资源,然后运行你的HarmonyOS应用。

四、DevEco Studio界面介绍

????????创建好项目,我们会进入IDE,首先我们要了解基础的界面布局,它主要分为四个部分:1.工程目录区、2.代码编辑区、3.预览区、4.日志和控制台。这些部分的位置和大小都是可调整的,初始位置如下图所示。

1.工程目录区: 位于左侧,用于查看和管理项目文件。详细的介绍将在后续章节中进行。

2.代码编辑区: 这是IDE的核心部分,位于中央位置。你可以在这里修改代码并切换显示的文件。通过按住Ctrl键并滚动鼠标滚轮,可以方便地实现界面的放大和缩小。

3.日志和控制台等: 在编辑器底部有一行工具栏,主要包括常用信息栏。其中,Run是项目运行时的信息显示栏,Problems是当前工程的错误和提醒信息栏,Terminal是命令行终端,用于执行命令行操作,PreviewerLog是预览器日志输出栏,Log是模拟器和真机运行时的日志输出栏,Profiler是可视化性能优化工具,这些功能将在应用开发过程中基本都会用到。

4.预览区: 通过单击右上角的Previewer,可以预览文件的UI展示效果。

????????预览器提供了丰富的界面显示功能,如旋转屏幕、切换显示设备以及多设备预览等。你可以通过单击旋转按钮来切换竖屏和横屏显示效果。也可以单击列表按钮切换显示的设备类型,弹出框内会显示可用的设备类型。

?????????例如,单击Foldable可以切换设备,同时你还可以通过单击旋转按钮切换Foldable的横竖屏显示模式。打开Muti-profile preview开关,可以实现多个尺寸设备的实时预览。

????????另外,单击预览器右上角的组件预览按钮,可以进入组件预览界面。组件预览模式允许你预览当前组件对应的代码块,点击相应组件时,代码文件中会框选对应的组件代码部分,下方则展示当前组件的基本属性。

五、运行Hello World

IDE提供了一套本地模拟器,供开发者使用。首先,需要下载并安装本地模拟器,并随后运行工程。

  1. 在顶部工具栏中选择Tools > Device Manager。

  2. 选择Local Emulator,并设置适当的Local Emulator Location存储地址,然后点击'+New Emulator'。

  3. 在弹出的窗口中,选择Huawei_Phone手机模拟器,点击'Next',进入模拟器系统下载页。

  4. 选择下载api9的系统镜像,然后点击'Next',等待下载完成。

  5. 下载完成后,创建相应的手机模拟器,点击Finish完成创建。

  6. 在Local Emulator页面中,会显示刚创建的手机模拟器。点击Actions按钮,启动模拟器。

  7. 模拟器启动后,点击顶部的启动按钮,将Hello World工程运行到模拟器上。

  8. IDE构建完成后,Hello World工程就成功在模拟器上运行了。

六、基本工程目录结构

1.工程级目录:

工程的目录结构如下,

具体详解如下所示:

  1. AppScope: 存放应用全局所需的资源文件。

  2. entry: 应用的主模块,包含HarmonyOS应用的代码和资源等。

  3. oh_modules: 工程的依赖包,存放工程所需的源文件。

  4. build-profile.json5: 工程级配置信息,包括签名、产品配置等。

  5. hvigorfile.ts: 工程级编译构建任务脚本。hvigor是一款基于任务管理机制实现的全新自动化构建工具,主要提供任务注册编排、工程模型管理、配置管理等核心能力。

  6. oh-package.json5: 工程级依赖配置文件,用于记录引入包的配置信息。

在AppScope中,包含了resources文件夹和配置文件app.json5。AppScope > resources > base中包含element和media两个文件夹:

  1. element: 存放公共的字符串、布局文件等资源。

  2. media: 存放全局公共的多媒体资源文件。

2.模块级目录:

在entry > src目录中,主要包含总的main文件夹,单元测试目录ohosTest,以及模块级的配置文件。

  1. main: 包含ets文件夹用于存放ets代码,resources文件夹存放模块内的多媒体及布局文件等,以及module.json5文件作为模块的配置文件。

  2. ohosTest: 单元测试目录。

  3. build-profile.json5: 模块级配置信息,包括编译构建配置项。

  4. hvigorfile.ts: 模块级构建脚本。

  5. oh-package.json5: 模块级依赖配置信息文件。

进入src > main > ets目录中,其分为entryability、pages两个文件夹:

  1. entryability: 存放ability文件,用于当前ability应用逻辑和生命周期管理。

  2. pages: 存放UI界面相关代码文件,初始生成一个Index页面。

在resources目录下,存放模块公共的多媒体、字符串及布局文件等资源,分别存放在element、media文件夹中。

配置文件解析:

  1. app.json5 (AppScope):?位于AppScope目录下,存放应用的全局配置信息,包括bundleName(包名)、vendor(应用程序供应商)、versionCode(用于区分应用版本)、versionName(版本号)、icon(应用显示图标)、label(应用名)等。

  2. module.json5 (entry > src > main): 存放模块的配置信息,包含当前模块的详细配置,如模块属性、打包信息等,具体信息见注释。

  3. main_pages.json(src/main/resources/base/profile/main_pages.json)

????????main_pages.json文件保存的是页面page的路径配置信息,所有需要进行路由跳转的page页面都要在这里进行配置,我们在新建页面的时候需要到这个文件中配置路由,否则可能会出现页面无法跳转的情况。

?七、总结

????????通过以上步骤,我们完成了HarmonyOS应用开发的初步准备工作。我们详细了解了DevEco Studio的下载安装过程,配置了开发环境,创建并成功运行了一个Hello World项目。探索了DevEco Studio的界面结构,从项目级到模块级,我们对基本工程目录结构有了清晰的认识。这一系列步骤为我们的HarmonyOS应用开发打下了坚实的基础。在接下来的学习和实践中,我们将继续挖掘更多丰富的功能和工具,构建出更为复杂和实用的应用程序。愿你在HarmonyOS的开发之路上取得愉快而成功的经验!

文章来源:https://blog.csdn.net/liuhaikang/article/details/135042776
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。