使用 Egret Engine 所开发的游戏可以非常方便的打包为原生APP。极大的提高游戏或应用的性能,以及应对多平台的渠道分发。
目前的封装方式,实质上是需要额外建立一个 Android 项目,然后通过一些操作来使其可以运行 Egret 标准项目。这样的项目在本文中称之为Android 封装项目。
基于这样的封装方式,包含两部分,一个是 Egret 标准项目,另一个是 Android 封装项目。Egret 标准项目的目的是建立所有的游戏运行及渲染逻辑,Android 封装项目的目的是将 Egret 标准项目封装并且生成标准的 Android APK 包,安装后运行 Egret 标准项目的内容。
使用IntelliJ IDEA打包
本篇教程使用的IDE为eclipse,使用IntelliJ IDEA打包 Android APP 请可以参考下面文档:
使用 IntelliJ IDEA 打包 Andorid APP
准备工作
如果在打包过程中遇到问题请先检查:注意事项
下载 JAVA SDK
地址:http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
- 勾选 “ Accept License Agreement”
- 笔者的环境是WIN7 64位,下载的是: Windows x64 。
- 下载后,自行安装,一路点击下一步。
下载 Android SDK
针对 Windows 与 Mac 谷歌推出了不同的 Android 开发工具包。
- android-sdk-windows (百度云下载)
下载 Android SDK 后,解压到 D:\adt-bundle-windows-x86_64-20140624
。如下图:
下载 Egret Android Support
使用 Egret Engine 引擎管理工具,下载 Andorid 打包工具 Egret Android Support 。
下载完成后,打开 Egret Android Support 目录,拷贝egret-android-support-xxx.zip
到D:\adt-bundle-windows-x86_64-20140624
。 并解压目录,如图:
到目前为止,我们的环境配置已经完成。
注意: Egret Android Support 和下面的 HTML5 项目推荐放在同一盘符下面,比如 D 盘。由于系统限制不推荐使用 C 盘。
创建HTML5项目
使用 Egret Engine 引擎管理工具,下载 集成开发工具 Egret Wing 。
引擎2.5及以上的版本,需 Egret Wing 2.1 以上版本才能支持。
喜欢使用命令行创建维护项目的同学,可以跳转:命令行手册,下文中主要使用IDE创建项目。
为了方便,我们使用 Egret Wing 创建名为 hello_h5
的游戏项目。如图:
点击下一步,我们选的默认的 showAll
比例缩放模式,这里可以根据项目需求,自行选择。点击完成,创建项目。
感兴趣的同学,可以运行一下H5项目,这不是本文的重点,我们需要根据生成的H5项目,创建一个 Andorid 项目,并且打包成为可以在 Andorid 环境中运行的APP。
需要注意的是 egret-android-support-xxx.zip
的版本和 Egret 的版本是一一对应的,使用 Egret 3.0.3 版本的引擎也 要使用相应 3.0.3 版本的 Egret Android Support.
创建 Andorid 项目
首先熟悉一下创建 Android 项目命令:
egret create_app app_name -f h5_game_path -t template_path
app_name
参数即我们要创建的 Android 封装项目的目录名称。
-f
参数用来指定 Egret 项目路径。
-t
参数用来指定创建 Android 封装项目的模板路径。
使用该命令建立 Android 项目:
- 这里我们在
D:\adt-bundle-windows-x86_64-20140624
下创建 Andorid项目,在该文件夹内Shift+ 鼠标右键
,选择在此处打开命令行窗口
。 - 输入
egret create_app hello_app -f D:\www\hello_h5 -t D:\adt-bundle-windows-x86_64-20140624\egret-android-support-3.0.3
这里 -t template_path 的路径,就是我们准备工作中 Egret Android Support 中解压的目录。
如果自定义项目路径,请不要在h5项目内建立android工程。
执行命令后,D:\adt-bundle-windows-x86_64-20140624
内会生成 hello_app
文件夹,此时,我们的 andorid 封装项目已经生成。如图:
如果遇到问题,请查看注意事项
生成Android APP
打开 Android SDK 目录 D:\adt-bundle-windows-x86_64-20140624
中的 eclipse -》eclipse.exe
如图:
如果是第一次启动 eclipse,使用默认配置,点击 OK 继续。
还可能会出现是发送信息到 Google 的界面,一般选择否。
现在可以选择 eclipse - File -Import…导入我们的安卓项目。如图:
Console 中色错误,可以忽略。
此时,需要连接“安卓手机”。并开启手机中的 “开发者调试模式”。
如果系统是 Windows 8 及以上版本,会自动安装所需的驱动程序,如果是 Windows 8 以下的版本,可以安装腾讯手机助手,360手机助手等。
驱动安装完成后,可以进行调试运行:
- 选择 hello_app 项目。
- 点击鼠标右键,选择 Run As…。
- 选择 Andorid Application…。
如图:
驱动安装正确,会弹出 Andorid Device Chooser 界面,选择手机型号后,点击OK按钮运行程序,此时连接的手机会自动安装并运行程序。
到目前为止,我们已经完成APP的打包与调试,APK的包在 bin 目录中,如图:
##Andorid 调试
注: 因为模拟器不能对Open GL ES很好的实现,所以我们只使用真机进行调试,目前不支持模拟器连接与调试。
Eclipse 提供了调试窗口 LogCat 通过 Windows -> Show View -> Other 打开日志输出窗口,如图:
Native 构建
当我们创建好 Native 工程之后如果想继续修改 HTML5 工程,可以使用 egret build --runtime native
来重新构建 Native 工程。
在 Wing 中可以选择项目菜单下的Native构建按钮来构建 Native 工程。当然只有当我们建立了 Native 工程之后才有效。
注意事项
为了能顺利构建和发布Native工程,我们推荐使用更为规范的文件操作。尽量规避以下问题:
- 项目路径中有空格。
- 项目路径中有中文。
- 项目文件夹放在桌面上。
- 发布时不要打开Naive工程项目文件夹,否则有可能命令行不能执行删除、修改等工作。
- 在同一盘符下面操作所有项目比如 D 盘,项目包括 Egret Android Support 、Egret HTML5 项目、生成的 Native 项目。由于系统限制不推荐在 C 盘下操作。