自定义资源数据库
当我们在扩展内使用了资源时,需要将扩展内的资源文件夹注册到资源数据库里,并在扩展发布时将资源随着扩展一起发布。
通过本文我们将学会如何注册一个资源文件夹,并在脚本里使用资源。
资源注册需要在 contributions
中使用 asset-db
字段进行配置,如下所示:
上面的示例中,我们把扩展 test-package
根目录下的 assets
文件夹注册到了资源数据库中。
脚本资源
为了使用 cc 的定义,我们需要拷贝 {项目目录}\temp\declarations
的定义文件到扩展根目录下。
由于 foo.ts
只是作资源使用,不属于扩展源码,所以我们需要在 tsconfig.json
中加入 exclude
配置进行排除,否则会出现编译错误。
图片、文本、字体等资源直接放入 assets
目录下即可。
使用扩展中的资源
若要以拖拽到组件方式引用包内的资源,使用方式与 assets
和 internal
中的资源一致。
import 脚本
若要在项目中引用脚本,只需要从资源目录库引用即可,如下所示:
可以不用刻意关注某个类是否来自某个扩展包,TypeScript 开发环境的自动补齐功能会提示 import 目录的,无需担心。