百度智能小程序 使用动态库
动态库介绍
动态库,是指可被添加到小程序内直接使用的功能组件。开发者可直接在小程序内使用动态库,无需重复开发,为用户提供更丰富的服务。具体动态库使用方法参见动态库。
动态库采用静默更新的方式,即小程序中引用了动态库,动态库更新之后,用户小程序里使用了该动态库的功能将在小程序调起后进行更新,更新操作对用户小程序开发者无感知。
引入动态库代码包
使用动态库前,开发者要在 app.json 中声明需要使用的动态库,例如:代码示例
{
"dynamicLib": {
// 定义一个别名,小程序中用这个别名引用动态库。
"myDynamicLib": {
// 这是动态库的 `dynamicLibName`,是全局唯一的名字,标志着被引用的动态库
"provider": "TheUniqueNameOwnedByThisDynamicLib"
}
}
}
如上例所示, dynamicLib 定义段中可以包含多个动态库声明,每个动态库声明以一个开发者自定义的动态库引用名作为标识,并指明动态库的唯一标识,及动态库名称。其中,引用名(如上例中的 myDynamicLib)由开发者自定义,无需和动态库名称保持一致。在后续的动态库使用中,该引用名将被用于表示该动态库。
使用动态库
使用动态库时,动态库的代码对于开发者来说是不可见的。为了正确使用动态库,开发者应查看动态库的详细信息,阅读提供的动态库开发文档,通过文档来明确动态库提供的自定义组件、js 接口规范等。
自定义组件
使用动态库提供的自定义组件,和使用普通自定义组件的方式相仿。在 json 文件定义需要引入的自定义组件时,使用 dynamicLib:// 协议指明动态库的引用名和自定义组件名,例如:
代码示例
{
"usingComponents": {
// 这里的 'myDynamicLib' 就是上面定义的,本小程序使用此动态库的别名。
// 这里的 'special-list' 是此动态库的公开的自定义组件(publicComponents)的名称。
// 动态库有哪些公开的自定义组件,应从各个动态库的用户文档中得到。
// 这里的 'my-special-list' 也是个自己定的别名,本页面或者本组件在模板中用此别名引用这个自定义组件。
"my-special-list": "dynamicLib://myDynamicLib/special-list"
}
}
从而页面中可以使用此自定义组件:
<view class="container">
<view>下面这个自定义组件来自于动态库</view>
<!-- 这里的 'my-special-list' 就是本页面中对于此自定义组件的别名 -->
<my-special-list />
</view>
js 接口
使用动态库的 js 接口时,可以使用 requireDynamicLib 方法。例如,动态库提供一个名为 getData 的方法,则可以像下面这样调用:
// 这里的 'myDynamicLib' 就是上面定义的,本小程序使用此动态库的别名。
let lib = requireDynamicLib('myDynamicLib');
// 这里调用动态库里定义的一个叫做 getData 的方法。
// 动态库有哪些公开的方法或属性可以被调用或访问,应从各个动态库的用户文档中得到。
lib.getData();
页面
自小程序基础库版本 3.180.3 、开发者工具 3.7.0 开始支持。
动态库中页面可作为小程序的启动页面,也可以作为被跳转的页面。
1.启动打开动态库页面的配置方式:
调起协议中的路径格式为:
__dynamicLib__/{dynamicLibName}/{dynamicLibPath}
2.路由跳转的 url 格式为:
dynamicLib://{dynamicLibName}/{dynamicLibPath}
例如 navigateTo 路由跳转:
// 获取基础库版本号
const {SDKVersion} = swan.getSystemInfoSync();
// 通过对比版本号,高于 3.180.3 时再调用
swan.navigateTo({
url: 'dynamicLib://dynamicLibName/pages/index/index'
});
即将要跳转的页面是动态库 dynamicLibName
中的pages/index/index
页面。
说明:
1.启动页面的 dynamicLibName 必须为线上动态库的名字,不能为别名;
2.路由跳转 url 中的dynamicLibName
可以为线上动态库的名字,也可以为别名,优先当做别名处理;
3.使用的动态库需在小程序app.json
中的dynamicLib
字段中配置;
4.支持跳转到动态库页面的 API 为: swan.navigateTo、swan.reLaunch、swan.redirectTo、swan.navigateToSmartProgram。
Tips:
- 使用动态库,请确保小程序基础库版本在 3.60.2 及以上,开发者工具版本在 2.4.0 及以上。
- 目前暂不支持开发者自行开发动态库,但任何小程序开发者都可以使用已有动态库。