包管理器与资源包导入说明
Author: Charley
自 LayaAir 3.1 起,新增了插件系统及资源包的导入导出功能,3.2 版本进一步引入了包管理器。开发者可将外部工具、IDE 插件、项目资源或源码封装为完整的资源包,便于导入与共享,助力引擎生态的持续繁荣与扩展。
为了完整使用资源包的功能,我们建议更新IDE的版本至3.1以上。
资源包的格式有两种,.zip
与 .layapkg
。
.zip
的包表示项目源码资源,其它的资源包为格式均为.layapkg
。这两种资源包的导入形式有着非常明显的差异,.zip
格式的项目源码只能在创建项目之前导入,而.layapkg
的资源包,必须在打开项目之后导入。
打开项目之后,也包含两种不同的资源包导入形式,分别是包管理器导入与直接导入资源包。本篇文档会详细说明。
1、项目源码导入
1.1 资源商店购买导入
资源商店里有免费和收费的源码资源,链接为:https://store.layaair.com/?cid=7&cname=%E9%A1%B9%E7%9B%AE%E6%BA%90%E7%A0%81
打开链接并登录后,免费源码可以直接点击 添加至我的资源
,收费资源则需要先加入购物车
,如图1-1所示,然后进行付费购买。
(图1-1)
无论是免费添加还是付费购买,一旦成功添加至我的资源。打开LayaAir3-IDE登录(与资源商店相同的帐号),在创建项目的面板里,选择 已购源码 再选中目标的源码资源,即可以该源码为模板,创建一个新的项目。如图1-2所示。
(图1-2)
如果源码列表的右上角出现下载标识,说明源码在资源商店里更新了版本,可以点击下载标识按钮更新源码的版本。
1.2 本地模板导入
有的时候,如果想用公司内部的项目框架作为源码初始模板,并不通过资源商店。LayaAir3-IDE也是支持的。
在创建项目时,选择 “本地模板” 栏目,然后点击右上角的 “导入本地模板” 按钮,如图1-3所示,选择对应的源码 .zip
包即可完成导入。
(图1-3)
导入模板后,就如同其它模板一样使用了。
2、常规的资源包导入
2.1 通过资源商店导入
当我们在资源商店里将资源添加至我的资源后,可以在 已购资源
列表中找到,并点击 “在LayaAirIDE中打开”,如图2-1所示。
(图2-1)
在弹出的浏览器窗口点击“打开LayaAirIDE”会调起LayaAir3-IDE
并弹出资源导入面板,加载完资源包后,我们可以看到资源包的结构,如动图2-2所示。开发者可以全选或仅选择所需的资源,点击导入
按钮,将资源导入到项目内。
(动图2-2)
2.2 从网络地址导入资源包
如果开发者的资源包没有上传资源商店,只传到了自己的服务器中,
我们也可以使用可访问的网络地址导入(只能是IDE导出的资源包.layapkg
后缀),操作路径为:工具
-> 从网络导入资源包
,如图2-4所示。
(图2-4)
其它流程与前文一致。
2.3 本地导入资源包
如果资源包是存在IDE本地硬盘中,也可以直接从本地导入,操作路径为:工具
-> 导入资源包
,如图2-5所示。
(图2-5)
在弹出的资源选择窗口内选择本地资源包(只能是IDE导出的资源包.layapkg
后缀)后,其它流程与前文一致。
3、包管理器资源导入
3.1 从包管理器中导入资源包
在资源商店 已购资源
列表中能看到的资源,除了从资源商店网页打开并导入外,也可以直接从IDE的包管理器中下载并导入。操作流程为:开发者
菜单 -> 包管理器
-> 选择资源包 -> 下载
-> 导入
,如图3-1所示。
(图3-1)
3.2 安装包与下载包的差异
从IDE包管理器导入与从资源商店网页中导入,最本质的区别是包管理器中除了下载资源包包入外,还可以安装\卸载资源包,如图3-2所示。
(图3-2)
与下载导入的资源包只能位于assets目录下不同,安装后的资源包,位于packages下,分类与结构更清晰。
不过,packages下的资源包为只读包,不可在项目中二次编辑开发,常用于IDE功能扩展的插件。
从资源商店中导入的资源包,只能位于assets目录下,所以推荐使用包管理器来导入或安装资源包。
安装包在提交到资源商店时的规则与普通的下载包不同,具体说明请查看另一篇文档《资源包导出与提交至资源商店》
3.3 会员专属资源包
除了资源商店中可以免费添加和购买的资源包外,包管理器中还会内置一些资源商店中没有的引擎官方插件安装包。这些安装包,需要购买会员资格,根据帐号坐席数量开通相应的帐号权限。权限开通之后,才会显示出来,并允许安装。如图3-3所示。
(图3-3)
当前有:性能分析插件、智能资源管理插件、CPU粒子系统、Spine动画烘焙插件,后续会继续更新官方内置插件功能,以IDE包管理器中实际显示为准。
如果想了解并多,以及购买咨询,可打开相关网页查看:https://layaair.com/LayaAirEnterprise/
4、更新资源包
需要重点说明的是,资源包的更新,必须要前往资源商店网页的 已购资源
列表中进行操作,先把最新的版本在已购列表中手动同步(更新),包管理器中无法主动对未操作更新的版本进行更新。
以“LayaAIGC插件”为例,开发者需要先查看更新日志内容,决定是否需要更新。
确定更新前,建议开发者自行导出备份旧资源包(以防万一,无法回退版本),点击更新按钮后,即完成了最新版本在已购列表中的同步。
(动图4-1)
更新完成后,建议回到IDE中,采用包管理器重新下载或安装。
如果只是普通的管理包导入,也可以直接在网页中操作,点击“在LayaAirIDE中打开”来重新导入更新后的资源包。