更新记录
1.0.0(2022-03-25)
初始版本
平台兼容性
Android | iOS |
---|---|
× | 适用版本区间:10 - 15 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
说明
动态修改app图标。此插件需要ios 10.3及以后版本才支持。
调用方式
bfjrModule = uni.requireNativePlugin('u7746-ChangeAppIconModule');
var param = {};
param.iconName = "test1";
bfjrModule.changeAppIconAsync(param, (ret) => {
//ret -2调用手机版本小于ios10.3 -1表示设置失败 0调用完成
//注意 0为调用完成而非设置完成。
console.log(ret);
});
//恢复app源图标
bfjrModule = uni.requireNativePlugin('u7746-ChangeAppIconModule');
var param = {};
param.iconName = "";
bfjrModule.resetAppIconAsync(param, (ret) => {
console.log(ret);
});
插件package.json配置相关
//切换图标支持多图标
"plists": {
"CFBundleIcons": {
"CFBundleAlternateIcons": {
"test1": { //与图片文件名相同 不要加扩展名
"UIPrerenderedIcon": false,
"CFBundleIconFiles": ["test1"] //与图片文件名相同 不要加扩展名
},
"test2": {
"UIPrerenderedIcon": false,
"CFBundleIconFiles": ["test2"]
}
}
}
}
图标文件配置相关
上面package.json配置的图标文件需要复制到插件 nativeplugins/u7746-ChangeAppIcon/ios/BundleResources 下。