目录
1、环境搭建
2、示例代码
3、填坑日志

1、环境搭建

详见 环境搭建

以android studio为例
在工程顶级 build.gradle 文件中加入：

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

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

implementation 'com.tencent.map:tencent-map-vector-sdk:latest.release'

申请开发秘钥
https://lbs.qq.com/android_v1/guide-project-setup.html

在AndroidManifest.xml中添加权限及输入开发秘钥

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.shufeng.tencentmaptest">

    <!--腾讯地图 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"/>
    <!--获取 device id 辨别设备-->
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <!--获取日志读取权限，帮助我们提高地图 sdk 稳定性-->
    <!--<uses-permission android:name="android.permission.READ_LOGS"/>-->
    <!--腾讯地图 SDK 要求的权限(结束)-->

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".activity.MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>

        <meta-data android:name="TencentMapSDK" android:value="你的开发秘钥" />

    </application>

</manifest>

2、示例代码

官网demo。

https://github.com/TencentSDK/TencentMapSdkDemo

可使用MapActivity来管理地图的生命周期，也可以在activity中进行管理。以下示例在activity中进行管理

执行效果

1）继承MapView

package com.shufeng.tencentmaptest.view;

import android.content.Context;
import android.util.AttributeSet;

import com.tencent.tencentmap.mapsdk.maps.MapView;

/**
 * Created by rorbbinlan on 2015/6/13.
 */
public class CustomerMapView extends MapView {
    public CustomerMapView(Context context) {
        super(context);
    }

    public CustomerMapView(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    public CustomerMapView(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);
    }
}

2）布局文件 activity_hello_map.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
                xmlns:tools="http://schemas.android.com/tools"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                tools:context=".activity.MainActivity" >


    <com.tencent.tencentmap.mapsdk.maps.MapView
        android:id="@+id/mapview"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent" />
</RelativeLayout>

3）activity中调用

package com.shufeng.tencentmaptest.activity;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;

import com.shufeng.tencentmaptest.R;
import com.tencent.tencentmap.mapsdk.maps.MapView;

public class HelloMapActivity extends AppCompatActivity
{
    private final String TAG = HelloMapActivity.class.getSimpleName();
    MapView mapview=null;
    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_hello_map);
        mapview=(MapView)findViewById(R.id.mapview);
    }

    @Override
    protected void onResume() {
        super.onResume();
        mapview.onResume();
    }

    @Override
    protected void onPause() {
        // TODO Auto-generated method stub
        super.onPause();
        mapview.onPause();
    }

    @Override
    protected void onDestroy() {
        // TODO Auto-generated method stub
        super.onDestroy();
        mapview.onDestroy();
    }

    @Override
    protected void onStart() {
        // TODO Auto-generated method stub
        super.onStart();
        mapview.onStart();
    }

    @Override
    protected void onStop() {
        // TODO Auto-generated method stub
        super.onStop();
        mapview.onStop();
    }
}

3、填坑日志

1）fragment变黑问题
现象：

在activity中有两个fragment，其中一个用MapView填充，另外用其他元素填充，类似如下效果
TabLayout + Fragment 实现页面滑动
在切换fragment后，有时没有MapView的fragment会成黑色，看不到任何元素。

解决：

将MapView换成TextureMapView即可

2）MapView中并没有提供什么操作接口，主要是通过TencentMap进行操作

MapView mapView;
TencentMap map = mapView.getMap();

3）使用TencentLocationSdk的定位问题
在请求定位是，出现error=3

int error = mLocationManager.requestLocationUpdates()

解决：
下载SDK https://lbs.qq.com/geo/log.html
除了添加TencentLocationSdk外，将SDK中的libs文件夹下所有文件都拷贝到工程的jniLibs文件夹下

image.png