AndroidStudio配置

最后更新时间:2025-03-13

推荐使用AndroidStudio作为开发工具。这里我们提供了腾讯地图 SDK 在 AndroidStudio 中的工程配置方法。

第1步： 获取Key

获取Key

第2步：创建AndroidStudio项目

在AndroidStudio中创建一个空的Android项目。

第3步：在项目中集成SDK

在 AndroidStudio 项目中集成腾讯地图 SDK 主要有两种方式：

1. 手动将腾讯地图 sdk 的 jar 包和 so 库或者aar包导入到工程
   
2. 通过 Gradle 配置 maven 或 jcenter 仓库集成 SDK
   
   

我们更推荐用户使用第二种方式，通过 maven 导入腾讯地图 SDK，下面我们详细介绍下两种方式。

方式一：通过拷贝 jar 包、so 库添加 SDK

1. 首先，请您在这里获取腾讯地图 SDK for Andorid 及其 Demo。
   
2. 解压下载的压缩包并拷贝文件
   以4.3.4版本的地图功能为例，解压后，得到一个 libs文件夹，该文件夹中包含tencent-mapsdk-release-4.3.4.b8edc92f.jar文件和一个jniLibs文件夹(文件中包含所有的so库文件)。
   
3. 将 libs 目录下的"*.jar"文件拷贝到 AndroidStudio 项目对应的 app/libs/ 文件夹下:
   

4.右键该jar包，选择add as library，弹出如下窗口：

5.点击OK即可，变成下图所示就是导入成功：

6. 将 jniLibs 目录下的所有文件按照原目录格式，拷贝到AndroidStudio项目对应的 app/src/main/jniLibs/ 目录下:
   

方式二：通过 Gradle 配置 maven 或 jcenter 仓库集成 SDK

1. 在 Project 的 build.gradle 文件中配置 repositories，添加 maven 或 jcenter 仓库地址。
   AndroidStudio 默认会在 Project 的 build.gradle 为所有module自动添加 jcenter 仓库地址，如果已存在，则不需要重复添加:

buildscript {
    repositories {
        google()
        jcenter()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.0'
    }
}
//向所有模块配置仓库：
allprojects {
    repositories {
        google()
        jcenter()
        mavenCentral()
    }
}

2. 在 Project 的 build.gradle 文件中配置 maven 地址：

maven {
     url "https://mirrors.tencent.com/repository/maven/tencent_public/"
}
maven {
     url "https://mirrors.tencent.com/repository/maven/tencent_public_snapshots"
}
maven {
     url "https://oss.sonatype.org/content/groups/public"
}
maven {
     url "https://oss.sonatype.org/content/repositories/snapshots/"
}
maven {
     url "https://oss.sonatype.org/content/repositories/staging/"
}

3. 在主工程 app module 的 build.gradle 文件配置 dependencies。
   如需引入指定版本 SDK（所有 SDK 版本号与官网发版一致），则在 app module 的 build.gradle 中修改 maven 仓库版本号:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
   //最新版本号参考：https://lbs.qq.com/mobile/androidMapSDK/download/3dDownload
    implementation 'com.tencent.map:tencent-map-vector-sdk:5.7.0'
}

第4步：在AndroidManifest.xml的application标签中配置key

开发者申请key后，把Key输入工程的AndroidManifest.xml文件中，在application标签里，添加名称为TencentMapSDK的meta，如下所示(value值为申请的key)：

	<meta-data
        android:name="TencentMapSDK"
        android:value="*****-*****-*****-*****-*****-*****"/>

第5步：在AndroidManifest.xml中添加权限配置

地图SDK需要使用网络，访问硬件存储等系统权限，在AndroidManifest.xml文件里，添加如下权限：

<!--腾讯地图 SDK 要求的权限(开始)-->
<!--访问网络获取地图服务-->
<uses-permission android:name="android.permission.INTERNET"/>
<!--检查网络可用性-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!-- 访问WiFi状态 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--需要外部存储读写权限用于读取保存地图缓存-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!--腾讯地图 SDK 要求的权限(结束)-->

第6步： 在proguard-rules.pro中添加混淆配置

如果需要混淆您的工程，请在module里找到proguard-rules.pro文件，添加如下混淆脚本：

-keep public class com.tencent.lbssearch.** {*;}
-keep public class com.tencent.map.** {*;}
-keep public class com.tencent.mapsdk.** {*;}
-keep public class com.tencent.tencentmap.**{*;}
-keep public class com.tencent.tmsbeacon.**{*;}
-keep public class com.tencent.tmsbeacon.**{*;}
-dontwarn com.qq.**
-dontwarn com.tencent.**

注意事项

1. 依照上述方法集成SDK以后，就不需要使用第一种方式集成地图 SDK，否则会出现类冲突。
2. 对于2D地图只需要把jar包集成进去便可。