跳到主要内容

资源管理框架

使用方法​

  • 遵循 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 ）参与整个生命周期过程，并提供必要的函数供开发者进行扩展

自定义处理器​

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

const 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