当前位置：首页 > news >正文

UniApp 制作高德地图插件

news 2025/7/3 18:39:20

1、下载Uni插件项目

在Uni官网下载Uni插件项目，并参考官网插件项目创建插件项目.

开发者须知 | uni小程序SDK

如果下载下来项目运行不了可以参考下面链接进行处理

UniApp原生插件制作_wangdaoyin2010的博客-CSDN博客

2、引入高德SDK

2.1 在高德官网下载对应SDK

相关下载-Android 地图SDK | 高德地图API

2、引入高德SDK

Android Studio 配置工程-创建工程-开发指南-Android 地图SDK | 高德地图API

也可以参考：高德地图：No implementation found for void com.autonavi.base.ae.gmap.GLMapEngine.nativeInitParam_易寻资料的博客-CSDN博客

注意：一定要按照官网方式进行引入，且多种方式不能混合起引用，本人比较建议使用方法一

3、设置ApiKey和更新隐私合规

调用如下方法进行隐私合规更新和设置APiKey

可以参考：开发者注意事项-创建工程-开发指南-iOS 地图SDK | 高德地图API

MapsInitializer.updatePrivacyShow(this.mUniSDKInstance.getContext(), true, true);
MapsInitializer.updatePrivacyAgree(this.mUniSDKInstance.getContext(), true);
MapsInitializer.setApiKey(apiKey);

4、创建一个组件打开高德离线地图

package com.mnyc.amap.amap3dsearch;import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.view.View;
import android.widget.Button;import androidx.annotation.NonNull;import com.alibaba.fastjson.JSONObject;
import com.amap.api.maps.MapsInitializer;
import com.amap.api.maps.offlinemap.OfflineMapActivity;import java.util.HashMap;
import java.util.Map;import io.dcloud.feature.uniapp.UniSDKInstance;
import io.dcloud.feature.uniapp.ui.action.AbsComponentData;
import io.dcloud.feature.uniapp.ui.component.AbsVContainer;
import io.dcloud.feature.uniapp.ui.component.UniComponent;
import io.dcloud.feature.uniapp.ui.component.UniComponentProp;/*** 自定义打开离线地图组件按钮*/
public class MnycAMapOfficelineButton extends UniComponent<Button> implements View.OnClickListener {Context context;Button button;private static final String TAG = "MnycAMapOfficelineButton";public MnycAMapOfficelineButton(UniSDKInstance instance, AbsVContainer parent, AbsComponentData componentData) {super(instance, parent, componentData);}@Overrideprotected Button initComponentHostView(@NonNull Context context) {this.context = context;button = new Button(context);button.setText("离线地图");button.setOnClickListener(this);return button;}@Overridepublic void onClick(View view) {try {context.startActivity(new Intent(this.context, OfflineMapActivity.class));} catch (Exception e) {exception(e);Log.e(TAG, e.getMessage());}}@UniComponentProp(name = "label")public void setLongitude(String label) {button.setText(label);}//    将打开离线地图异常进行抛出成Uni中的事件public void exception(Exception exception) {JSONObject dataJson=new JSONObject();JSONObject detailJson=new JSONObject();detailJson.put("exception", exception);//目前uni限制 参数需要放入到"detail"中 否则会被清理dataJson.put("detail", detailJson);fireEvent("exception", dataJson);}
}

5、错误场景

错误1：离线地图组件没有城市列表

问题：没有调用高德更新隐私合规两个方法，进行调用即可

错误2：地图组件为白色

问题：没有调用高德更新隐私合规两个方法，进行调用即可

错误3：地图为黑屏、但是有高德Logo和放大缩小按钮

问题：so文件引入错误，按照官网方法1引入sdk(so文件)，注意不能多种方式混合引入

错误4:离线地图组件“下载出现异常”在AS中调试或者使用真机调试可以正常下载地图，打包成插件使用UniApp进行调试时出现“下载出现异常”

问题：有可能是高德ApiKey没有正确配置

解决思路：不适用高德离线地图组件，通过如下代码手动下载，在OfflineMapManager第二个参数对应类的onDownload方法中可以查看具体的错误代码是多少

/构造OfflineMapManager对象 
OfflineMapManager amapManager = new OfflineMapManager(this, this);
//按照citycode下载
amapManager.downloadByCityCode(String citycode)；
//按照cityname下载
amapManager.downloadByCityName(String cityname)；

离线地图状态值