微信小游戏白鹭引擎插件使用教程

1、微信小游戏白鹭引擎插件使用教程为了更好的提升微信小嬉戏的打开速度，提高用户体验，微信正式发布了引擎插件功能，白鹭引擎第一时光支持并正式发布支持该功能的5.2.31版本。以下是白鹭引擎插件用法的具体解释文档及常见问题解答，请诸位开发者小伙伴认真阅读。什么是引擎插件我们发布微信小嬉戏的时候，里面会带有egret.min.js、eui.min.js之类的库文件，玩家每次打开一个小嬉戏，都要重复的下载这些文件。现在我们把白鹭引擎做成了微信的插件， 5.2.x系列的全部版本都上传到了微信服务器上，开发者只要在项目里举行配置，就可以用法远端的插件，不用法本地的引擎文件。这样的益处是，假如一个玩家玩了a嬉戏

2、，里面用法了5.2.20版本的引擎插件。然后他又玩了b嬉戏，假如b嬉戏的引擎插件版本和a嬉戏全都，那么这个插件就不需要重新下载。这样就可以提高嬉戏的打开速度，获得更好的用户体验。白鹭引擎插件用法和调试环境1、白鹭引擎5.2.31 版本；2、微信开发者工具调试nightly版本(>=1.02.1910252)；注重：正式版还不支持插件功能；3、在android微信和ios微信的7.0.7版本(>=7.0.7)，可挺直体验和测试插件分别功能。用法了插件分别的小嬉戏，在console日志中会输出：plugin * inject success/fail!；4、因为微信开发者工具的bug，

3、用法测试版的 appid 在开启插件功能时会报错，必需用法在微信后台注册过的正式版 appid 才可以。5、目前一个appid，只支持引用一个插件；6、目前支持整包小嬉戏用法插件，以及分包小嬉戏的主包用法插件。白鹭引擎插件用法办法1、在egret launcher里下载引擎5.2.31版本，用法该版本创建一个嬉戏项目；2、打开项目中的scripts/config.wxgame.ts文件，将usewxplugin变量改为true；3、在发布成微信小嬉戏release版本后(egret publisb –target wxgame)，会开启插件功能。debug调试版(egret

4、 build –target wxgame)不支持该功能。老项目升级：在老项目中执行 egret upgrade –egretversion 5.2.31 后会把项目升级成支持插件的版本。用法其他版本的引擎：假如您的项目不想用法最新的5.2.31版本，要用法其他版本，例如5.2.16之类的引擎，那么可以做如下操作：1、用法最新版引擎5.2.31创建一个新项目，把这 3 个文件拷贝到老项目里替换原有文件；注重：其中的wxgame.ts里会对js文件做一定的修改，一定要用法我们提供的办法，不要对这块做任何的修改。由于微信会对js文件做md5校验，任何修改都会

5、转变md5值。2、在老项目根名目的egretproperties.json里，把compilerversion编译器版本改成 5.2.31。比如在本示例中，引擎代码还是5.2.16的，但是编译脚本用法引擎5.2.31，这样就能支持把嬉戏发布成开启微信插件的形式了。用法引擎插件的微信小嬉戏项目结构解释1、在之前的微信小嬉戏项目里，我们会把全部的引擎文件和嬉戏规律文件都放在js文件夹内；2、在新的项目结构里，增强了一个egret-library文件夹：egret-library：放的是引擎库文件；js：放的是项目里的其他js文件，比如嬉戏规律文件main.min.js；3、微信开发者工具打包上传的

6、时候，会自动生成两个包：带egret-library文件夹的包：不支持插件功能的老版本微信，会调用这个文件夹内的引擎文件；不带egret-library文件夹的包：支持插件功能的新版本微信会读取这个包，挺直调用微信服务器上的引擎插件。faq问：引擎插件里都包含哪些库？答：包含白鹭引擎官方提供的 7 个库，注重：只包含发布版的 xx.min.js, 不包含调试版的xx.js。详细的文件列表如下：问：假如为了让包体小一些，不考虑兼容老版本微信的玩家，只用法远程插件里的引擎。是否可以不在小嬉戏项目里放一份引擎，这样可以吗？答：理论上是可以的，但是微信官方不建议这么做。另外假如用法引擎插件功能，包的总大小会算上线上插件里的引擎代码，所以您自己衡量是否值得。问：我对引擎做了修改，还可以用法远程插件吗？答：不能做任何修改，而且必需用官方提供的编译配置文件 script/wxgame/wxgame.ts里的默认参数发布 。由于微信会校验本地和插件里 js 文件的 md5 值，只要做