自定义资源数据库

    当我们在扩展内使用了资源时,需要将扩展内的资源文件夹注册到资源数据库里,并在扩展发布时将资源随着扩展一起发布。

    通过本文我们将学会如何注册一个资源文件夹,并在脚本里使用资源。

    资源注册需要在 contributions 中使用 asset-db 字段进行配置,如下所示:

    上面的示例中,我们把扩展 test-package 根目录下的 assets 文件夹注册到了资源数据库中。

    脚本资源

    为了使用 cc 的定义,我们需要拷贝 {项目目录}\temp\declarations 的定义文件到扩展根目录下。

    由于 foo.ts 只是作资源使用,不属于扩展源码,所以我们需要在 tsconfig.json 中加入 exclude 配置进行排除,否则会出现编译错误。

    图片、文本、字体等资源直接放入 assets 目录下即可。

    使用扩展中的资源

    若要以拖拽到组件方式引用包内的资源,使用方式与 assetsinternal 中的资源一致。

    import 脚本

    若要在项目中引用脚本,只需要从资源目录库引用即可,如下所示:

    可以不用刻意关注某个类是否来自某个扩展包,TypeScript 开发环境的自动补齐功能会提示 import 目录的,无需担心。