更新记录
1.0(2023-06-29)
新版发布
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 14.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:9 - 17 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在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原生插件配置”->”云端插件“列表中删除该插件重新选择
集成准备
- 从高德获得Android和ios端的appkey。
- manifest.json中App模块配置,勾选Maps(地图)中的高德地图模块,并配置appkey。
- 制作uniapp自定义调试基座,运行到手机设备进行调试。注:1: appkey如有更改,必需要重新制作自定义基座,2:appkey与App的包名、签名证书的SHA1要对上,3: 基座打包完成后,建议卸载基座后重新运行安装基座调试。
插件接口
1、自定义地图样式插件对象
//自定义地图样式插件对象
var AMapStyle = uni.requireNativePlugin('AMap-Style');
2、设置自定义地图离线样式,支持vue和nvue高德地图map组件
//设置离线样式
var styleDataPath = plus.io.convertLocalFileSystemURL("_www/static/mapstyle/style.data");
var styleExtraPath = plus.io.convertLocalFileSystemURL("_www/static/mapstyle/style_extra.data");
AMapStyle.setMapStyle({
customMapStyle:{
enable:true,
//styleTexturePath:"",//注意:纹理功能需要开通相关权限才可使用。
styleDataPath:styleDataPath,
styleExtraPath:styleExtraPath
}
});
3、设置自定义地图在线样式,支持vue和nvue高德地图map组件
//设置在线样式文件(需要开通权限)
AMapStyle.setMapStyle({
customMapStyle:{
enable:true,
styleId:"97751c44af4cb4ed7f4b6f0d64f3c3bc"//在自定义平台发布新样式后获得样式ID
}
});
4、关闭自定义地图样式,支持vue和nvue高德地图map组件
//设置普通地图,关闭自定义样式
AMapStyle.setMapStyle({
customMapStyle:{
enable:false
}
});