首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >微信小游戏的引擎插件今日全量开放!LayaAir引擎插件使用说明!

微信小游戏的引擎插件今日全量开放!LayaAir引擎插件使用说明!

作者头像
Layabox Charley
发布2019-11-20 14:59:22
1.4K0
发布2019-11-20 14:59:22
举报
文章被收录于专栏:LayaboxLayabox

一直以来,微信小游戏都在不断寻求更优的小游戏使用体验,从微信7.0.7版本开始,就一直在灰度测试的微信小游戏通用引擎插件,今日已全量放开。

该插件内置了主流的通用游戏引擎,其中包括近一年以来的LayaAir 1.0系列与LayaAir2.0系列的正式版。

开发者使用了微信小游戏的引擎插件后,当玩家曾体验的任何一款游戏中包括了该插件的相同版本引擎,都无需再次加载,直接调用已加载的微信公共插件库中的引擎版本。

与从本地包加载引擎的模式相比,引擎插件模式无疑会增强用户玩游戏时的加载体验。未来,随着微信7.0.7及以后版本的普及,或许可以只使用引擎插件,不再使用本地包中的引擎库。

下面我们就针对引擎插件的使用,进行详细说明。

1、下载支持引擎插件发布的LayaAir IDE

LayaAir 1.x IDE从1.8.6beta版本开始支持引擎插件的适配发布,LayaAir 2.x IDE从2.4.0beta版本开始支持引擎插件的适配发布,所以必须要下载支持引擎插件的IDE。

LayaAir1.x IDE 下载地址为:

https://ldc.layabox.com/layadownload/?type=layaairide

LayaAir2.x IDE 下载地址为:

https://ldc2.layabox.com/layadownload/?type=layaairide

2、以前IDE创建的项目需要适配吗?

假如你刚刚下载完已支持引擎插件的LayaAirIDE,TS和JS语言的项目哪怕打开的是以前版本IDE创建的项目,也不需要做任何人工修改,在编译并发布时,IDE会自动进行适配。

AS项目则需要人工更改一下编译参数,以使得项目在编译时,引擎与项目代码分离。

如果你的AS项目是2.2.0 IDE版本之前创建的,需要打开.laya/compile.js ,搜一下asconfig.json;在其后增加配置参数outlaya=true;如下图所示。

如果你的AS项目是LayaAirIDE1.8.6 IDE版本之前创建的,打开.laya/tasks.json ,找到 "args" 字段,在该字段的配置参数后增加新的配置参数outlaya=true,如下图所示。

修改后别忘了要先编译一下项目,TS实验版尽管IDE自动完成了适配,也需要先编译一下。

3、IDE发布时的配置选项

发布的时候,在微信小游戏发布的功能选项下,勾选是否使用引擎插件的功能模块选项,如下图所示。

勾选后,发布的微信小游戏版本,会自动配置好引擎插件的相关配置。然后和普通发布小游戏的流程一样就可以了。

4、了解一下IDE生成的引擎插件目录与配置

引擎插件的适配,IDE其实自动做好了,不需要开发者做什么,不过大家可以了解一下LayaAir IDE做了哪些事。

4.1 自动生成了引擎插件的本地目录

我们会发现,发布后的微信小游戏目录与没用引擎插件的目录相比,多了一个laya-libs目录。如下图所示。

这个多出来的laya-libs目录就是引擎插件本地版目录,这个目录的作用是为了兼容微信7.0.7以下版本用的。如果玩家的微信是低版本,则自动使用本地包引擎插件目录laya-libs下的引擎插件,如果是微信7.0.7及以上版本。这个目录则不会使用。

4.2 修改了 game.json

除了多创建了一个laya-libs,IDE还修改了game.json。插件的使用全靠这里。如下图所示。

我们可以看到game.json里多了plugins(插件)配置。

version 字段的内容是版本号,字段必须保留 provider 字段是引擎插件提供者appId,千万不要动这里。 path 字段是引擎插件的本地目录,如果不考虑兼容7.0.7以下用户和不需要使用本地版插件进行调试,可以删除本字段。

如果大家要想使用引擎插件,plugins这里的信息大家最好不要手工改,发布时IDE会自动生成,改了之后,会影响大家对于引擎插件的使用。

5、微信开发者工具中的配置

5.1 调试基础库版本

微信开发者工具,点开详情,本地设置,调试基础库至少要2.9.0及以上版本才可以在微信开发者工具中使用引擎插件。

5.2 什么时候使用本地插件

本地设置里有一个选项 使用本地的插件,一般情况下不用勾选。如下图所示。

不勾选的时候,默认会采用引擎方提供的微信小游戏内置公用版本引擎插件库,只有在7.0.7以下版本才会读本地laya-libs目录下的引擎库。

一旦勾选,就会只采用本地laya-libs目录下的引擎库,而不再使用微信小游戏内置的公用版本引擎插件库。

除非是怀疑公用版本可能存在BUG,才需要勾选开启本地插件,通过本地与公用版本的对比,用于排查问题,或者真的有BUG,使用本地临时修改的版本。(一般是不需要的,引擎插件库只上传LayaAir引擎稳定版本,且会在官网更新后一两周才同步到引擎插件库)

6、FAQ

6.1 引擎插件支持哪些版本?

LayaAir 1.x引擎,当前支持 1.7.22、1.8.0、1.8.1、1.8.2、1.83、1.8.4。

LayaAir 2.x引擎,当前支持2.0.1、2.0.2、2.1.0、2.1.1、2.2.0。

其它的更多版本的查询方式可以在layabox官网文档中获得

1.x引擎文档: https://ldc.layabox.com/doc/?nav=zh-as-5-0-8 2.x引擎文档: https://ldc2.layabox.com/doc/?nav=zh-as-5-0-9

6.2 插件版引擎中包括哪些引擎库?

微信插件版引擎,并非是官网中引擎库的全部。

LayaAir 1.x引擎 包括的库为:

laya.ani.min.js
laya.core.min.js
laya.d3.min.js
laya.d3Plugin.min.js
laya.device.min.js
laya.filter.min.js
laya.html.min.js
laya.particle.min.js
laya.pathfinding.min.js
laya.tiledmap.min.js
laya.ui.min.js
laya.webgl.min.js
laya.wxmini.min.js

LayaAir 2.x引擎 包括的库为:

laya.ani.js
laya.core.js
laya.d3.js
laya.html.js
laya.particle.js
laya.ui.js
laya.webgl.js //仅在LayaAir2.1.0之前的版本存在
laya.d3Plugin.js//仅在LayaAir2.2.0之前的版本存在
laya.filter.js //仅在LayaAir2.2.0之前的版本存在

对于这些,开发者知道即可,后续可能会有所变化,不需要管太多,之前不用插件的时候怎么开发还是怎么开发。哪怕不知道引擎插件库包括哪些,也不影响使用。LayaAir会自动识别哪些库属于引擎插件库。不在插件库里的,引擎也会自动处理引用关系。

6.3、开放域中可以使用引擎插件吗?

开放域中目前还不可以使用引擎插件。未来也许可以。

6.4、LayaAir旧版本引擎在使用引擎插件有什么需要注意的吗?

引擎方面,要注意的是,必须要使用正式版,具体是哪些版本号,请按本文介绍的方式来查看。

IDE方面,

LayaAirIDE 1.x必须要升级到 >= 1.8.6 beta版本。

LayaAirIDE 2.x必须要升级到 >= 2.4.0 beta版本。

其它的,引擎与IDE都已做好适配,按本篇文档操作即可。

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2019-11-12,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 Layabox 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 1、下载支持引擎插件发布的LayaAir IDE
  • 2、以前IDE创建的项目需要适配吗?
  • 3、IDE发布时的配置选项
  • 4、了解一下IDE生成的引擎插件目录与配置
    • 4.1 自动生成了引擎插件的本地目录
    • 5、微信开发者工具中的配置
    • 5.2 什么时候使用本地插件
    • 6、FAQ
    • 6.3、开放域中可以使用引擎插件吗?
    • 6.4、LayaAir旧版本引擎在使用引擎插件有什么需要注意的吗?
    相关产品与服务
    云开发 CLI 工具
    云开发 CLI 工具(Cloudbase CLI Devtools,CCLID)是云开发官方指定的 CLI 工具,可以帮助开发者快速构建 Serverless 应用。CLI 工具提供能力包括文件储存的管理、云函数的部署、模板项目的创建、HTTP Service、静态网站托管等,您可以专注于编码,无需在平台中切换各类配置。
    领券
    问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档