【鸿蒙 HarmonyOS 4.0】开发工具安装

一、准备开发环境

1.1、安装IDE

鸿蒙应用开发需要使用配套的IDE——HUAWEI DevEco Studio。 DevEco Studio基于IntelliJ IDEA Community（IDEA社区版）构建，为鸿蒙应用提供了一站式开发环境，集成了开发、运行、调试以及发布应用的各项功能。

安装步骤：

①获取DevEco Studio安装包，官方下载地址为：

HUAWEI DevEco Studio和SDK下载和升级 | 华为开发者联盟

 根据自己的电脑版本选择下载

②解压之后双击 deveco-studio-3.1.0.501.exe ，进入安装向导，点击 next 即可

③选择安装路径，完成后点击 next 

④配置安装选项，勾选第一项创建桌面快捷方式即可，完成后点击 next 

⑤点击   Install 开始安装

⑥等待几十秒后，点击 Finish 完成安装

1.2、配置IDE 

 安装完成后，可按以下步骤完成初始化配置

①双击桌面快捷方式，启动DevEco Studio

②阅读各项条款，点击 Agree 表示同意

③初次启动会出现如下设置向导，首先需要为 nodejs 和 ohpm 选择合适的安装路径，完成后点击 Next 即可

备注：

•  nodejs 用于为鸿蒙应用的自动化构建工具提供运行环境。
•  ohpm （OpenHarmony Package Manager）是鸿蒙生态第三方库的包管理工具，支持共享包的发布、安装和依赖管理。

  

  ④为 HarmonyOS SDK 选择安装目录，完成后点击 Next 

   

  ⑤阅读相关协议，勾选 Accept 表示同意，完成后点击 Next 

  

  ⑥浏览配置汇总页，确认无误后点击 Next 

  

  ⑦等待下载

  

  ⑧下载完成后，点击 Finish 完成配置

  

  ⑨完成配置后，可根据喜好调整DevEco Studio主题风格，点击 Configure 下的 Settings 。

  

  ⑩在Appearance & Behavior/Appearance的 Theme 中可选择主题

   

  二、创建项目

  ①点击 Create Project 

  

  ②选择项目模版，此处选择第一个 Empty Ability 即可。

   

  ③配置项目

  可能需要调整的配置项如下，其余保持默认即可，配置完成后，点击 Finish 即可

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

    

    ④IDE界面说明

    

    ⑤项目结构概述

    

    三、运行项目

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

    3.1、Preview 预览

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

    

    3.2、模拟器运行

     Previewer 预览器主要用于查看界面UI效果，如需对项目进行更加深入的测试，可以使用模拟器运行项目。初次使用需要先安装模拟器，

    1、点击 Tools 菜单下的 Device Manager ，打开设备管理器

     2、点击 Install ，安装模拟器

    

     3、点击 Install 后，会首先下载模拟器相关的SDK，下载完成后点击 Finish 即可。

    

    4、选择模拟的安装目录，完成后点击 New Emulator 。

    

    5、选择设备类型—— Phone ，完成后点击 Next 

    

    6、下载系统镜像，注意选择 api9 版本

    

    7、等待下载完成后，点击 Finish 

    

    8、系统镜像下载完毕后，点击 Next 

    

    9、配置模拟器（可选），完成后点击 Finish ，至此模拟器安装完毕

    

    10、若想将项目运行到模拟器，首先需要启动模拟器，点击下图中的启动按钮，稍等片刻，等待模拟器开机

    

    11、开机后的模拟器如下图所示

    

    12、回到IDE，在右上角的设备列表中选择刚刚创建的模拟器（默认已经选中）

    

    13、点击运行按钮

    

    14、查看模拟器

    

    3.3、真机运行

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

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

    

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

    

    ③开启USB调试。在系统与更新/开发人员选项中，打开USB调试开关

    

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

    

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

    

    ⑥回到IDE，在右上角的设备列表中选择连接的手机（默认已选中）

    

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

    

    ⑧生成签名信息需要先登陆华为开发者账号，点击 Sign In 

    

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

    

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

    

    四、了解基本工程目录

    4.1、工程级目录

    

    详细说明：

    • AppScope中存放应用全局所需要的资源文件。
    • entry是应用的主模块，存放HarmonyOS应用的代码、资源等。
    • oh_modules是工程的依赖包，存放工程依赖的源文件。
    • build-profile.json5是工程级配置信息，包括签名、产品配置等。
    • hvigorfile.ts是工程级编译构建任务脚本，hvigor是基于任务管理机制实现的一款全新的自动化构建工具，主要提供任务注册编排，工程模型管理、配置管理等核心能力。
    • oh-package.json5是工程级依赖配置文件，用于记录引入包的配置信息。

      在AppScope，其中有resources文件夹和配置文件app.json5。AppScope>resources>base中包含element和media两个文件夹，

      • 其中element文件夹主要存放公共的字符串、布局文件等资源。
      • media存放全局公共的多媒体资源文件。

        

        4.2、模块级目录

        

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

        • main文件夹中，ets文件夹用于存放ets代码，resources文件存放模块内的多媒体及布局文件等，module.json5文件为模块的配置文件。
        • ohosTest是单元测试目录。
        • build-profile.json5是模块级配置信息，包括编译构建配置项。
        • hvigorfile.ts文件是模块级构建脚本。
        • oh-package.json5是模块级依赖配置信息文件。

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

          • entryability存放ability文件，用于当前ability应用逻辑和生命周期管理。
          • pages存放UI界面相关代码文件，初始会生成一个Index页面。

            

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

             

            4.3、app.json5

            AppScope>app.json5是应用的全局的配置文件，用于存放应用公共的配置信息。

            

            • bundleName是包名。
            • vendor是应用程序供应商。
            • versionCode是用于区分应用版本。
            • versionName是版本号。
            • icon对应于应用的显示图标。
            • label是应用名。

              4.4、module.json5

              entry>src>main>module.json5是模块的配置文件，包含当前模块的配置信息。

              

              其中module对应的是模块的配置信息，一个模块对应一个打包后的hap包，hap包全称是HarmonyOS Ability Package，其中包含了ability、第三方库、资源和配置文件。其具体属性及其描述可以参照下表1。

              属性	描述
              name	该标签标识当前module的名字，module打包成hap后，表示hap的名称，标签值采用字符串表示（最大长度31个字节），该名称在整个应用要唯一。
              type	表示模块的类型，类型有三种，分别是entry、feature和har。
              srcEntry	当前模块的入口文件路径。
              description	当前模块的描述信息。
              mainElement	该标签标识hap的入口ability名称或者extension名称。只有配置为mainElement的ability或者extension才允许在服务中心露出。
              deviceTypes	该标签标识hap可以运行在哪类设备上，标签值采用字符串数组的表示。
              deliveryWithInstall	标识当前Module是否在用户主动安装的时候安装，表示该Module对应的HAP是否跟随应用一起安装。- true：主动安装时安装。- false：主动安装时不安装。
              installationFree	标识当前Module是否支持免安装特性。- true：表示支持免安装特性，且符合免安装约束。- false：表示不支持免安装特性。
              pages	对应的是main_pages.json文件，用于配置ability中用到的page信息。
              abilities	是一个数组，存放当前模块中所有的ability元能力的配置信息，其中可以有多个ability。

              对于abilities中每一个ability的属性项，其描述信息如下表2。

              4.5、main_pages.json

              src/main/resources/base/profile/main_pages.json文件保存的是页面page的路径配置信息，所有需要进行路由跳转的page页面都要在这里进行配置。

              

              五、补充：开发工具切换到中文版本

              ①进入项目后，在右上角点击设置按钮，选择点击Plugins

              

              ②在Plugins -> Installed -> OtherTools -> Chinese

              

              ③勾选上一步操作，点击ok按钮后，会弹出：重新启动 DevEco Studio 更改提示，点击Restart按钮即可

              

              ④此时重新启动的 DevEco Studio 就是中文版本了

              

              最后，👏👏😊😊😊👍👍