MapLibre Native安卓集成实战：从环境配置到地图展示全指南

dependencies {
    // 引入MapLibre Native安卓SDK（最新稳定版11.0.0）
    implementation 'org.maplibre.gl:android-sdk:11.0.0'
}

pluginManagement {
    repositories {
        // 阿里云镜像（优先使用，加速依赖下载）
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/repository/google/' }
        maven { url 'https://maven.aliyun.com/repository/jcenter/' }
        // 官方仓库（作为 fallback）
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // 同上，配置阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/repository/google/' }
        maven { url 'https://maven.aliyun.com/repository/jcenter/' }
        google()
        mavenCentral()
    }
}

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 地图组件：占满整个屏幕 -->
    <org.maplibre.android.maps.MapView
        android:id="@+id/mapView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import org.maplibre.android.MapLibre
import org.maplibre.android.maps.MapView
import org.maplibre.android.camera.CameraPosition
import org.maplibre.android.geometry.LatLng

class MainActivity : AppCompatActivity() {

    // 声明MapView变量，用于控制地图
    private lateinit var mapView: MapView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // 1. 初始化MapLibre（必须在布局加载前调用）
        MapLibre.getInstance(this)

        // 2. 加载布局
        setContentView(R.layout.activity_main)

        // 3. 绑定MapView实例
        mapView = findViewById(R.id.mapView)

        // 4. 异步加载地图，并设置样式和初始相机位置
        mapView.getMapAsync { map ->
            // 加载默认样式（MapLibre提供的示例样式）
            map.setStyle("https://demotiles.maplibre.org/style.json")

            // 设置初始相机位置（示例：聚焦到北京）
            val initialCameraPosition = CameraPosition.Builder()
                .target(LatLng(39.9042, 116.4074)) // 北京经纬度
                .zoom(10.0) // 缩放级别（1-20，数值越大越近）
                .build()
            map.cameraPosition = initialCameraPosition
        }
    }

    // 以下为生命周期回调，确保地图资源正确管理
    override fun onStart() {
        super.onStart()
        mapView.onStart() // 地图进入前台
    }

    override fun onResume() {
        super.onResume()
        mapView.onResume() // 地图恢复交互
    }

    override fun onPause() {
        super.onPause()
        mapView.onPause() // 地图暂停交互
    }

    override fun onStop() {
        super.onStop()
        mapView.onStop() // 地图进入后台
    }

    override fun onLowMemory() {
        super.onLowMemory()
        mapView.onLowMemory() // 低内存时释放资源
    }

    override fun onDestroy() {
        super.onDestroy()
        mapView.onDestroy() // 销毁地图，释放所有资源
    }

    override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        mapView.onSaveInstanceState(outState) // 保存地图状态（如缩放位置）
    }
}

plugins {
    // 声明Kotlin插件版本
    id 'org.jetbrains.kotlin.android' version '1.9.0' apply false
}

# 保留MapLibre相关类不被混淆
-keep class org.maplibre.** { *; }
-keep interface org.maplibre.** { *; }