egret 变量_Egret全新RES模块详解

近期Egret发布了全新的4.0版本，此次版本中最大的特色就是释放了全新的RES资源管理模块。相信不少人在官网或者直播中已经对新的RES资源管理模块有所了解。这篇文章就全新的RES进行一次介绍。与此同时，在引擎新版本中，由于引入了TypeScript 2.1.4，所以在语法糖层面也增加不少特性，我后续会在其他文章中逐步介绍。

首先来简单说面一下这次RES模块升级后的特点。相对于旧版本，变化如下：

借助新的ES规范，API使用发生明显变化

资源配置文件格式改变，减小体积的同时，增加了热更新机制。

新版本RES采用单独运行方式，和旧版本可以保持很好的共存。当然，在你的项目中你只能选择使用其中一种。

旧版本中的自定义格式解析器被废除，取而代之的是新的格式解析扩展方法。

开发者在刚刚接触新版本时，由于语法糖变化，可能会带来暂时的不习惯，当你熟悉这部分语法后，使用起来效率会比以前高很多。为了兼容旧版本，在新版本中你也可以使用旧版本的API调用方式，但不同的是，一部分API的参数和行为会发生少许变化，这对于就项目迁移尤为需要注意。

安装

新的RES模块并没有放置于引擎之中，很多人更新Egret引擎后不知道新版RES所处位置。这里需要对安装方法做一个简单介绍。

当你想使用新版本的RES模块时，你需要借助npm来记性安装，安装命令如下：

npm install egret-resource-manager -g

在这行命令中，添加 -g 参数，我们希望你能够以全局方式进行安装，保证在不同系统账户下都可以使用RES命令。

安装完成后，你即可使用新版本RES模块，但对于要使用的项目需要进行进一步操作。

将项目切换为全新的RES模块

进入到你的项目中，为了实验对比，我们新建两个项目，一名明明为old，另外一个命名为new 。然后进入到new目录下，执行如下命令：

res upgrade

如果命令执行完成后，并没有报错，即证明新版本RES切换成功。

对比新旧两个项目，我们来看一下发生了哪些变化：

新项目中，在bin目录下，新增了一个名为resourcemanager的文件夹，该文件夹存放全新RES模块代码。这个文件夹中的代码文件共有4个，四个文件也就是git仓中bin目录下的4个文件。

在egretProperties.json文件中，原有modules节点中的res节点被删除，取而代之的是名为resourcemanager的模块配置。

除了以上两点，你还需要自己修改一下tsconfig.json文件。因为全新的RES模块依赖于ES2015标准中的Promise对象，所以在编译器编译阶段，我们需要在这里添加对Promise对象的编译支持。修改后内容如下：

{

"compilerOptions": {

"target": "es5",

"experimentalDecorators":true,

"lib": [

"es5","dom","es2015.promise"

]

},

"exclude": [

"node_modules"

]

}

以上工作都完成后，我们即可使用全新的RES模块来编写代码。

RES模块代码编写第一步

在使用旧版本时候，我们所有的资源都依赖于一个名为default.res.json的资源配置文件，该文件记录这资源的相对路径和配置name属性名称。那么新版本的资源配置文件如何生成？这里需要使用RES命令的另外一个操作，build资源。进入到项目目录上一层，然后执行如下命令：

res build 你的项目名称

这里的项目名称和你的文件夹名称相同，如果没有发生任何报错，那么你在打开项目中的resource目录，会发现其中多了一个名称为config.json的文件