Egret iOS Support(iOS APP打包)2.0.2 官方正式版

Egret iOS Support是一款iOS APP打包方案，可以将Egret开发的HTML5游戏打包为IPA文件，转换后的APP效率更加接近原生游戏性能。

iOS APP打包方案

1、安装iOS开发环境——Xcode

运行App Store，在搜索项查找“Xcode”，下载并安装即可

第二部分、安装Egret游戏框架

2、预备知识

运行Mac OS X的Terimal应用：在Finder中打开Applications文件夹，再打开Utilities文件夹，找到Termial应用，双击运行。如下图：

进入你的工作目录，在演示中，我们的的工作目录为“labs/”，工作目录为空文件夹，如下图：

接下来，为我们的游戏建立一个projects文件夹，运行

$ mkdir projects

如下图：

3、安装Egret

传送门：Mac OS X 系统下安装最新的Egret。

4、下载Egret的iOS支持包

创建Egret Support文件夹

下载Egret ios支持包

下载egret-ios-support，将egret-ios-support放置在“labs/egret-support/”文件夹下，如下图：

第三部分、创建一个iOS打包的示例

5、创建一个Egret项目

这里创建一个名称为ACoolHtmlGame的项目，使用命令如下：

$ egret create ACoolHtmlGame

如图：

6、编写你的游戏项目

接下来要做的事情就是编写你的游戏项目逻辑。这里我们不进行操作，使用默认的项目来进行演示。

7、创建你的ios项目工程

从你的HTML5游戏创建ios项目工程

回到我们的游戏工程文件夹“labs/projects/”下，我们通过一个新的命令来创建适用于ios的项目，该命令创建项目时，需要指定原有HTML5工程和你的egret-ios-support路径。命令如下：

$ cd projects/$ egret create_app ACoolIosGame -f ACoolHtmlGame -t ../egret-support/egret-ios-support

create_app命令可用来创建适用于ios的项目工程。ACoolIosGame则是该工程的工程名。

-f参数则指定我们的HTML5游戏项目，我们直接将刚刚创建的HTML5项目路径填写进入即可。

-t参数则是ios项目工程的模板，我们需要指定“egret-ios-support”项目路径。

下图为运行命令演示：

运行命令后，你将看到新生成的ACooliosGame项目文件夹，该文件夹结构如下：

自此，我们已经创建了一个完整的ios工程，我们来看一下当前的文件层级：

labs/-+      +-- egret-core/-+                         # egret      +-- egret-support/-+                      # egret 支持库      |                  +-- egret-ios-support/ # ios支持      +-- projects/-+      |             +-- ACoolIosGame            # ios工程      |             +-- ACoolHtmlGame           # html应用      ...

8、编译iOS游戏

8.1 导入项目

打开ACoolIosGame文件夹，双击“ACoolIosGame.xcodeproj”，等待Xcode加载完成

9、测试项目

点击Xcode的Run命令，直接进入iOS模拟器运行

下图为运行效果

如需生成ipa包，请访问苹果开发网站，注册开发者账号，阅读相关设置即可。

自此，完成了使用Egret实现一个iOS游戏应用的全过程。

10、项目开发的整体流程

我们推荐的开发方式：在原有的HTML5游戏项目中进行开发，开发测试ok，再编译到iOS平台。下面为大家演示一下流程：

1.创建一个HTML5游戏：

egret create ACoolHtmlGame

2.创建对应的iOS游戏：

egret create_app ACoolIosGame -f ACoolHtmlGame -t ../egret-support/egret-ios-support

3.测试一下各个平台游戏

4.在ACoolHtmlGame中开发游戏，一个小步进的开发后，我们要开始编译我们的游戏并在浏览器上测试，这是使用

egret build ACoolHtmlGame --runtime native -e

这行命令执行了两项任务：1.编译TypeScript到JavaScript，2.将编译出的文件同步到Xcode项目中。这里需要注意的有两点：1.编译的项目是HTML5项目，2.不要更改iOS项目的位置，项目位置的设置将在高级教程给出, 3.此时HTML5项目会失效，想查看HTML5项目，请使用

egret build ACoolHtmlGame -e

来使得HTML5项目生效，此时iOS项目失效。

5.此时可以使用egret startserver ACoolHtmlGame 启动游戏服务，这样浏览器就能观察到实现的游戏逻辑了。

6.接下来回到ACoolIosGame的Xcode工程中，使用Xcode来清除、重新编译、调试项目，这样就可以在手机上得到和HTML项目的游戏逻辑了。

7.返回4，不断的迭代。

Egret iOS Support更新日志

新功能

[新特性] 支持WebSocket TypedArray流传输

[新特性] 支持游戏包加密

[新特性] 支持网络设置文件启动游戏

[新特性] 支持游戏设置项读取和保存

[新特性] 支持iOS 8.4

[更新] 使用新的JavaScriptCore框架

[更新] 使用新的Graphics接口

[更新] 使用新的Math库

[更新] 使用新的项目模版

[修复] 进入后台崩溃问题

[修复] 输入文字bug