uniapp离线打包如何集成高德地图SDK

在uniapp中进行离线打包时，如何正确集成高德地图SDK？具体步骤是什么？是否需要额外的配置或依赖？在Android和iOS平台上集成方式有什么区别？遇到SDK初始化失败或地图无法显示的问题该如何解决？

2 回复

在HBuilderX中，将高德地图SDK的aar文件放入nativeplugins目录，配置manifest.json的App模块权限，添加高德相关配置。然后使用自定义基座打包即可。


在 UniApp 中离线打包集成高德地图 SDK，需通过原生开发配置。以下是 Android 和 iOS 平台的步骤概要：

Android 平台

  1. 获取高德 SDK
    从高德开放平台下载 Android 地图 SDK（如 AMap_Location.jar 等），并解压。

  2. 导入 SDK 到项目

    • 将 .jar 文件放入 libs 目录，so 文件放入 src/main/jniLibs（按 CPU 架构分文件夹）。
    • 在 app/build.gradle 的 dependencies 中添加：
      implementation fileTree(dir: 'libs', include: ['*.jar'])

  3. 配置权限和 Key

    • 在 AndroidManifest.xml 中添加网络、定位等权限：
      <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    • 在高德平台申请 App Key，并在 application 标签内配置：
      <meta-data
    android:name="com.amap.api.v2.apikey"
    android:value="你的高德 Key" />

  4. 编写原生代码
    创建地图 Activity 或 Fragment，参考高德官方文档初始化地图。

iOS 平台

  1. 获取高德 SDK
    下载 iOS 地图 SDK（如 MAMapKit.framework）。

  2. 导入 SDK 到项目

    • 通过 Xcode 将 framework 添加到项目。
    • 添加依赖库：CoreLocation.framework、SystemConfiguration.framework 等。

  3. 配置 Key 和权限

    • 在 Info.plist 中添加定位权限描述：
      <key>NSLocationWhenInUseUsageDescription</key>
<string>需要定位功能</string>
    • 在 AppDelegate.m 的 didFinishLaunchingWithOptions 中设置 Key：
      [AMapServices sharedServices].apiKey = @"你的高德 Key";

  4. 编写地图视图
    使用 MAMapView 创建地图界面。

UniApp 与原生交互

通过 uni.requireNativePlugin 调用封装的原生模块，或使用条件编译分别处理各平台。

注意事项

  • 确保高德 Key 的包名（Android）/Bundle ID（iOS）与申请时一致。
  • 离线打包需使用 HBuilderX 生成本地打包资源，再通过 Android Studio 或 Xcode 集成。

完成配置后，可调用高德 SDK 实现地图显示、定位等功能。具体接口使用参考高德官方文档。

回到顶部