egret-docs-master/extension/RES/newres

使用方法

• 遵循 ES6 Promise 标准的异步语法

RES.loadConfig().then(()=>{
    RES.getResAsync("assets/bg.jpg");
}).then(()=>{
    RES.getResAsync("assets/icon.jpg");
});

• 支持 ES2015 async / await 异步语法

await RES.loadConfig()
await RES.getResAsync("assets/bg.jpg");
await RES.getResAsync("assets/icon.jpg");

配置

@RES.mapConfig("config.resjs", () => "resource")
class Main extends egret.DisplayObjectContainer {

    constructor(){
        super();
        RES.loadConfig();
    }
}

白鹭资源管理框架采用 ES2015 的装饰器语法进行配置。

如果开发者从老项目迁移到新版资源管理框架，当没有配置 RES.mapConfig 注解时，会强制添加名为 "config.resjs" 的配置，并忽略 RES.loadConfig() 中的参数

资源生命周期

任意一个资源的生命周期都遵循以下机制：

加载 -> 处理 -> 持有 -> 销毁实例 -> 销毁缓存

处理器（ Processor ）参与整个生命周期过程，并提供必要的函数供开发者进行扩展

自定义处理器

开发者如想自定义处理器，首先需要遵循以下接口

var customProcessor:RES.processor.Processor = {

    onLoadStart(host,resource){
        return new Promise(( reslove ,reject ) => {

        })
    },

    onRemoveStart(host,resource){
        return new Promise(( reslove ,reject ) => {

        })
    },

    getData(host, resource, key, subkey) => { //可选函数

    }

}

编写完自定义处理器后，需要针对类型进行映射

RES.processor.map("customType",customProcessor);

并在 config.resjs中将特定文件的类型设置为 customType

不兼容的变化

• RES.Analyzer 相关 API 已被废弃，开发者应使用 RES.processor.Processor API 进行替换
• RES.getResAsync("sheet.json#icon") 如果 sheet.json 尚未加载，将会返回一个 null，而之前的版本会去自动加载并返回 sheet.json#icon所对应的 Texture