快速集成

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

创建AndroidStudio项目

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

在项目中集成SDK

在工程 build.gradle 文件中，添加 maven 地址：

maven{
    url "https://oss.sonatype.org/content/groups/public/"
}
maven{
    url "https://oss.sonatype.org/content/repositories/snapshots/"
}

在项目 build.gradle 文件中添加导航sdk 依赖：

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.5.1-lite'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.8.3'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.1.0.1'
}

在 AndroidManifest.xml 配置key

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

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

在AndroidManifest.xml中添加权限配置

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

<!--访问网络获取服务-->
<uses-permission android:name="android.permission.INTERNET"/>
<!--检查网络可用性-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!--需要外部存储写权限用于日志-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

在proguard-rules.pro中添加混淆配置

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

-keep class com.tencent.map.**{ *; }

在启动APP时调用如下代码

TencentNavi.Config config = new TencentNavi.Config();
// 记录设备标识，反馈导航问题时请提供该设备标识以及发生问题的时间
String deviceID = DeviceUtils.getImei(getApplicationContext();
config.setDeviceId(deviceID);
// 或者设置开发者自己的的设备号config.setDeviceId(xxxxxxxx);
TencentNavi.init(this, config);