白鹭引擎Egret Engine mac版v5.1.8 官方版

白鹭引擎Egret Engine mac版是一款非常受开发者欢迎的HTML5游戏引擎，除了支持html5游戏的开发外，你还可以通过这款引擎开发微信小程序游戏。白鹭引擎可以全面提升开发效率、运行效率、加载效率，推荐有需要的开发者下载使用。

特殊优势：

极速的运行性能

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

独有的脏矩形渲染

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

组件化的EUI系统

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

白鹭引擎微信小程序游戏常见问题：

我在使用白鹭引擎 5.0 / 4.x / 3.x 版本，可以直接转换为微信小游戏么？

答：目前我们只支持白鹭引擎 5.1.x 版本发布为微信小游戏，推荐您使用最新的 5.1.2 版本。升级教程

我在使用 egret res 库，5.1.2 创建的新项目使用的是 assetsmanager 库，这两个库有区别么？

答：assetsmanager 是 res 的替代方案，这两者的 API 有 90% 保持一致，但是仍然有一些小区别，主要是在 RES.Analyzer 上，如果您遇到了相关问题，您可以在 egretProperties.json 中修改模块配置，从 assetsmanager 修改回 res 并执行 egret clean ，这样就可以换成 res 资源管理库了。更改如图所示：

微信开发者工具无法识别项目或者无法读取 manifest.js 文件

答：请确保您的微信开发者工具版本是 v1.02.1712280下载连接，遇到识别项目或者无法读取manifest.js 文件问题时先写检查下版本是不是太低导致的

egret 设置横屏后微信小游戏不生效:

答：需要在微信小游戏的项目中找到 game.json 文件，deviceOrientation 参数设置为 landscape，更多设置参考官方文档，如图：

下一引擎版本将会自动切换屏幕旋转模式

当老项目（5.1.2以前）升到到最新版时，发布小游戏项目报错：

答：升级成功后，请首先保证 HTML5 版本可以正常运行，然后再尝试发布为微信小游戏，目前我们遇到了多位开发者通过创建 5.1.2 新项目后拷贝老项目代码和素材的方式尝试升级，由于忽视了修改 egretProperties.json 中的模块配置，导致运行失败的问题。升级教程

在游戏使用到 egret.getDefinitionByName() 报错，找不到对应类时：

答：需要将要反射的类挂载到 window 对象下，例如有个 class People{} 类，需要添加代码 window[“People”] = People。示例demo下载

在 EUI 中使用自定义组件，发布到微信小程序的 default.thm.js 报错提示找不到自定义组件，错误如图：

答：参考上一条回答，需要将自定义组件暴露到全局作用域。

在小游戏中报错 “Main is not defined” 时，

答：请查看游戏的入口类名是否为 Main，如不是请修改为 Main。

找不到 “不检验安全域名、TLS 版本以及 HTTPS 证书” 时如何解决：

答：目前可以在 project.config.json 中手动设置 urlCheck 为 false。

第三方库 Proto Buffer 微信小游戏中使用报错：

答： 因为 protobuf.js 内部包含了加载的逻辑，这部分逻辑需要适配到微信小游戏的 API 才可以使用，目前正在解决这个问题。

在小游戏中播放声音停止后，立即播放会导致没有声音：

答：播放的声音停止后延迟 100ms 再进行播放。

短音效（长度小于 1s 的音效）连续播放会有卡顿、播放不出来等问题：

答：目前只能避免这种使用方式，我们正在和微信团队配合，争取尽快解决这个问题。

使用 navigator.userAgent 在小游戏中获取信息时无论是什么手机的返回值都是一样的 ‘Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_1 like Mac OS X) AppleWebKit/603.1.30 (KHTML, like Gecko) Mobile/14E8301 MicroMessenger/6.6.0 MiniGame NetType/WIFI Language/zh_CN’,

答：目前请暂时避免这种使用方式，这个问题已经反馈给微信团队。

开发者已经安装了最新版微信开发工具，但是执行 egret run –target wxgame 命令时还是提示请安装最新版开发者工具。

答：请开发者检查下自己的操作系统是否是 32位 Windows，这是 5.1.2 版本在 32位 Windows系统上的 BUG，我们会尽快修复，在此之前，建议开发者使用 egret publish –target wxgame 发布后，手动使用微信开发者工具打开。