环境搭建

这里我们只提供eclipse 和Android Studio的腾讯地图SDK的工程配置方法。

1、eclipse

将下载到的压缩包解压,将"Tencent*.jar"(这个jar包可以是TencentMapSDK_x_vx.x.x.jar, TencentSearch_v1.x.x.jar, TencentStreetSDK_v.x.x.x.jar)拷贝到工程目录的libs文件夹下。如果您使用3D版地图SDK,还需要将对应平台的so文件拷贝到工程目录的libs文件夹下,如下图所示:

  • Tips
  • 如果必须使用eclipse开发,强烈建议使用23.0.7版本的ADT。低版本的ADT可能会导致 MapView 添加到 xml 后无法正常加载,可以尝试在地图SDK jar包上右键选择 "Build Path -> Add to Build Path" 解决这个问题。

2、Android Studio

使用 maven

矢量地图 v4.0.3.2 开始支持 maven 配置地图sdk,配置方法:

工程顶级 build.gradle 文件中加入:

module build.gradle 文件中添加依赖库名称:

使用 jar 包

方法一:将下载到的压缩包解压,将"Tencent*.jar"(这个jar包可以是TencentMapSDK_x_vx.x.x.jar, TencentSearch_v1.x.x.jar, TencentStreetSDK_v.x.x.x.jar)拷贝到app/libs/文件夹下,右键选择"Add As Library"。

方法二:在"Project Structure"中选择"Dependencies", 点击"+"选择"File dependency", 选择要添加到工程的jar包即完成开发包的导入,如图所示:

注:如果您要使用3D版地图SDK,还需要引入so库。需要您在app/src/main/目录下新建jniLibs目录,将so文件放到此目录下,如图所示:

申请密钥

要正常使用腾讯地图SDK用户需要申请开发密钥,可以到 这里申请开发密钥,申请开发密钥是免费的,腾讯地图SDK的使用也是免费的。

申请结果如下所示。

用户还可以在key配置页修改Key的配置信息,如下,点击“设置”

如下图,在Key配置页,用户可以修改key的应用类型,及授权白名单(当遇到提示授权失败的时候,您也应该检查一下您设置的白名单是否有误)。

申请开发者权限后,把Key输入工程的AndroidManifest.xml文件中,在application节点里,添加名称为TencentMapSDK的meta,如下所示。

腾讯地图SDK及定位SDK都可以通过此处的密钥设置正常工作。

混淆配置

如果需要混淆您的工程,请添加下面的混淆脚本: