跳到主要内容

背景

团结引擎鸿蒙化第一课，请开发者 一定要认真阅读 ；

主要包括以下工作：

  • 团结引擎环境配置，以及DevEco的下载、环境配置
  • 团结引擎工程配置、直接出包流程
  • 团结引擎导出DevEco工程，以及出包流程

0. 前置准备

  • 下载团结引擎，先下载TuanjieHub，安装Editor和OpenHarmony平台支持即可。
    • 下载时，建议将OpenHarmony OpenJDK和Nodejs都勾选上 输入图片说明
  • 团结引擎OpenHarmony文档参考
  • 下载Deveco Studio； 注意，请下载5.0.3.800及以上版本的Deveco Studio，其中会携带Release版本的SDK12，使用该sdk构建项目。游戏提审需要使用Release的SDK 。
  • 下载本目录下的 HeadFirstPackage.zip ,并且解压，里面的.package文件或者.unitypackage文件均可导入团结引擎中 输入图片说明
  • 使用团结引擎新建一个空项目，并且将上一步下载的插件导入进去。 输入图片说明

1. 环境配置

1.1 DevEco环境配置​

双击安装包运行即可。

1.2 团结引擎环境配置​

打开"Edit-Preferences-External Tools"，进行环境配置

  • OpenHarmony SDK 可以配置Deveco Studio中携带的SDK，在${DevecoStudo安装目录}/sdk/default目录下，比如我本地安装到了D:\softwares\Deveco\DevEco Studio目录，配置如下： 输入图片说明
  • Node.js的安装以及JDK的安装，按照上图勾选即可。如果使用自己本地的jdk环境，至少需要jdk17或以上的版本。

2. 切换平台

打开"File-Build Settings", 点击OpenHarmony，然后点击Switch Platform: 输入图片说明 如果工程较大，这一步会消耗较多时间，请耐心等待。

2.1 PlayerSettings配置修改​

打开[Player Settings] - [Other Settings] - [Target Architecture]，仅勾选 ARM64 , 配置如下： 输入图片说明

3. 构建Hap包

3.1 导出工程并使用DevEco出包​

3.1.1 导出工程​

如图所示，勾选"Export Project", 之后选择目录，即可导出团结引擎过程对应的DevEco工程： 输入图片说明

3.2.3 签名​

点击 File > Project Structure... > Project > SigningConfigs 界面勾选“ Automatically generate signature ”和“ Support HarmonyOS ”，等待自动签名完成后，点击“OK”即可。如下图所示: 输入图片说明

3.2.4 出包​

在菜单栏点击 Build > Build Hap(s)/APP(s) > Build Hap(s) , 如下图所示： 输入图片说明 提示“BUILD SUCCESSFUL”，表示构建成功。 输入图片说明 构建后的Hap包路径在entry/build/default/outputs/default目录下，安装到手机上的是entry-default-signed.hap 输入图片说明

4. 安装Hap包到手机

安装Hap包有两种方式，命令行安装和在Deveco Studio里面安装

4.1 命令行安装Hap包​

将搭载单框架鸿蒙系统的真机与电脑连接，启动cmd, 在cmd中输入

hdc install **.hap

等待安装完成即可 输入图片说明

4.2 在DevecoStudio中一键运行​

在完成 3.2.3 步骤之后，在连接手机设备的情况下，在右上角点击如图所示位置，即可运行当前项目到设备上： 输入图片说明

5. 打开应用

在手机上点开应用，屏幕中间显示"Hello OpenHarmony",即代表demo成功了。 输入图片说明