Egret Engine

 　　Egret Engine官方版（白鹭引擎）是一款开源免费的遵循HTML5标准的2D、3D引擎，解决了HTML5性能问题及碎片化问题，灵活地满足开发者开发2D或3D游戏的需求，并有着较强的跨平台运行能力。

Egret Engine软件特色

　　多平台渠道功能一键接入

　　可以快速接入众多游戏渠道、支付、用户系统等接入更加轻松。

　　较高的项目开发效率

　　简洁、易用、高效的API，让游戏开发像写作一样简单。完善的中文文档说明，让你快速上手。

　　完整的游戏开发工作流

　　从资源配置到代码编写、再到调试发布，针对每个环节提供不同工具帮你完成。

　　较强的跨平台支持

　　完善的2D、3D引擎，忽略平台差异性，写一份代码在任何平台都可使用。

　　高速的运行性能

　　Egret底层针对不同浏览器优化策略进行大量优化，让你的代码运行计算处于健壮性状态。

　　独有的脏矩形渲染

　　内置脏矩形算法可帮助你优化游戏画面渲染性能，整体性能提升1倍，项目运行更加流畅

　　组件化的EUI系统

　　更好的屏幕适配，功能强大的组件系统，更加优化的渲染体系，新手易用性更强。

Egret Engine安装步骤

下载本站安装包，双击运行后，跟随安装向导走， 稍等片刻即可完成安装。

使用方法

　　 安装引擎

　　下载Egret Engine。

　　安装开发工具

　　打开 Egret Launcher，会显示登录界面，如下图。

　　登陆成功后会显示 Egret Launcher 主界面。

　　创建项目

　　1、点击菜单 项目 -> 创建项目 来创建项目，如下图。

　　也可以选择 导入项目 来导入已有项目。

　　2、在弹出的新建项目面板中，设置项目的基本配置，如下图。

　　项目名称

　　当前项目的名称，如 HelloWorld。

　　项目路径

　　该项目所存放的文件路径。

　　项目类型

　　该项目的项目类型，如 Egret 游戏项目 ， Egret EUI 项目。

　　引擎版本

　　当前项目所使用的 Egret 的版本。

　　选择扩展库

　　项目中需要使用的系统库。更多关于扩展库选择的介绍可以参考：扩展库简介

　　舞台尺寸

　　默认游戏舞台的高度与宽度，以像素为单位.

　　缩放模式

　　屏幕的适配方式，这里选择showALL模式。更多关于缩放模式的介绍可以参考：屏幕适配

　　旋转方式

　　屏幕的旋转模式，这里选择auto模式。更多关于旋转设置的介绍可以参考：屏幕适配

　　点击 创建 ，创建Hello World项目。

　　项目可以直接在Egret Launcher 中进行打开，管理。

　　项目结构

　　在Egret Wing左侧，可看到当前项目的目录结构：

 

 

　　各文件夹功能说明

　　.wing：包括 Egret 项目的任务配置文件和启动配置文件。

　　bin-debug：项目调试时，所产生的文件存放于此目录。

　　libs：库文件，包括 Egret 核心库和其他扩展库存放于此目录。

　　resource：项目资源文件存放于此目录。

　　script：项目构建和发布时需要用到的脚本文件存放在此目录。

　　src：项目代码文件存放于此目录。

　　template：项目模板文件存放于此目录。

　　egretProperties.json：项目的配置文件。具体的配置说明可以参考：EgretProperties说明

　　index.html：入口文件。具体的配置说明可以参考：入口文件说明

　　manifest.json：清单文件。

　　tsconfig.json：typescript 编译配置文件。

　　wingProperties.json：Egret Wing 项目配置文件。

　　运行项目

　　点击菜单“项目”->“构建”，编译项目，如下图。

　　构建完成之后点击菜单“项目”->“调试”，运行项目，如下图。

FAQ

　　如何分包加载资源?

　　关于微信小游戏中新加入的分包加载 API

　　微信小游戏增加了分包加载功能(微信 6.6.7 客户端)，运用分包功能，小游戏代码包总上限可以从之前的 4 M提升至 8 M。开发者可以根据游戏品类和场景需要，在合适时机加载指定包，提升打开速度，优化用户体验。

　　微信小游戏之所以提供了分包的策略，最主要的目标是希望开发者将包体积尽可能降低，将首屏加载的压力分散到游戏逻辑中，保证尽快给玩家一个可以交互的界面，而不是停留在微信小游戏的启动页中。为此，微信小游戏本次更新中不仅仅更新了分包加载，也在管理后台的运维中心提供了加载性能监控功能，允许开发者针对上述数据数据分析功能，正是希望通过这些数据分析能力帮助开发者更精细化的优化小游戏的加载效率。

　　因此，将微信的本次更新简单粗暴的理解为“包体积从4M提升到了8M”是片面的。也很不建议开发者直接这样做，因为目前您仍然要兼容微信不存在分包下载的老版本，如果您将您的游戏直接放置了8M的分包，就会在用户首次启动时必须加载完8M资源才能跳出启动页，这也不是很好的用户体验。

　　为此，白鹭引擎的策略是，引入一个 loading.js 的逻辑，并将其与白鹭引擎的核心代码(以及最简化的loading资源)打包为主包，然后在 loading.js 中去动态下载子包，并在下载过程中借助已经加载的白鹭引擎为用户渲染出 Loading 界面。

　　之所以将微信分包策略与白鹭引擎采用这种方式结合，是在效仿页游的分包机制。几乎所有的 Flash 页游都会至少存在两个 SWF 文件(可以近似理解为编译后的代码包文件)，第一个SWF文件只负责加载逻辑并保持其体积尽可能小，而真正的业务逻辑由于代码总编译体积很大，都会放在后续加载。

　　最后用一张图概述：

　　如何在白鹭引擎中使用分包下载

　　借助于白鹭引擎 5.1 版引入的新的自定义构建管线功能，您无需升级白鹭引擎至最新版本，而只是在构建管线中添加一些插件，并调整少量逻辑就可以完成此改动。

　　考虑到这项功还没有经过长时间的测试，我们暂时不将该功能集成在引擎里，而是给开发者提供一个示例项目。开发者应首先在引擎提供的示例项目中将该功能跑通，然后再将其应用于您的正式项目。

　　步骤一：下载示例项目

　　您可以在 https://github.com/himuil/subPackageDemo 处下载示例项目，该项目可以直接运行看到效果

　　该项目使用了 Egret 5.2.3 版本，但是您也可以将 egretProperties.json 中的 engineVersion 和 compilerVersion 调整为您的引擎版本，我们支持 5.1 以上的版本。

　　步骤二：将该项目移植进您的游戏

　　将 scripts/wxgame/subpackage.ts 拷贝进您的项目

　　修改 config.wxgame.ts，将 ManifestPlugin 替换为 SubPackagePlugin (注意，您需要修改 build 和 publish)

　　修改 config.wxgame.ts 中的 CleanPlugin，将 subpackage 对应的目录清除

　　将示例项目的 EgretSubpackageLoading.js 拷贝进您的微信小游戏项目

　　修改微信小游戏项目的 game.json，参考示例项目，引入 subpackages 属性

　　修改微信小游戏项目的 game.js，参考示例项目，重点是添加调用 wx.loadSubPackage 的逻辑

　　步骤三：高级用法

　　您可以通过修改 SubPackagePlugin 的参数和 game.json 的 subpackage 字段配置多个 subpackage

　　您可以在游戏过程运行中，而不是游戏初始化时加载某个 subpackage，比如您可以在游戏启动时只加载一个登陆页面，在用户登陆之后再加载游戏主逻辑。

　　每个 subpackage 可以包含多个 js 文件