Hello Baidu Map

不断尝试未曾尝试的东西，比单调的重复要新鲜的多，不论大小。当然，尝试是探索，重复是沉淀。
最近参与的项目中，存在实时定位需求，因而有幸接触Baidu Map SDK。个人还是比较喜欢百度，腾讯，谷歌等提供的开发平台的。其文档和实例都非常详细。根据项目需求，现分几部分，将一些关键流程记录如下。本篇将记录SDK的融合。
注：项目IDE为Android Studio。

（一）绑定

基于各大平台的APP开发，都需要将平台所提供的SDK与APP绑定。即在开发平台注册APP信息。信息通常包括APP包名，APP名称，APP唯一标识等。因此，当APP信息变化时，务必对相应信息进行更新，以保证SDK的成功调用。其中APP包名和SHA1的获取，最为关键。

（1）APP包名

APP包名，可以从主模块的AndroidManifest.xml中获取。

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

或者从项目build.gradle的“ApplicationID”中获取。

android {
    ...
    defaultConfig {
        applicationId "com.breakloop.app"
        ...
    }
    buildTypes {
...
    }
}

但两者取值务必相同，否则调用SDK时会出错。

（2）APP唯一标识

对于APP唯一标识，百度地图绑定的是APP签名证书的SHA1。
进一步细分为，Debug版和Release版。其中，Debug版仅用于开发时的调试。两者的区别仅为keystore文件不同。Debug版本默认keystore文件为C:\Users\用户名\.android\debug.keystore，Release版则是用户在发布APP时，开发者所指定的keystore（.jks）文件路径。

签名证书的SHA1，可通过java SDK所提供的keytool命令来获取。以Release版为例。
在命令行中输入
keytool –list –v –keystore C:\D\project\KeyStore\Breakloop.jks
随后，输入对应jks的password.
注：Debug版本，无password，回车即可。

获取包名和SHA1后，可在百度开发平台，注册应用。

平台将根据注册信息，产生唯一的KEY，即AK。

之后AK值将被固化在APP中，即APP主模块AndroidManifest.xml中。

<application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <meta-data
            android:name="com.baidu.lbsapi.API_KEY"
           android:value="mn...GP" />
           <!--Instead with your App AK-->
        <activity android:name=".AroundActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

至此，绑定完成！接下来，就是使用SDK了。

（二）SDK的使用

SDK下载路径：http://lbsyun.baidu.com/sdk/download?selected=mapsdk_basicmap,mapsdk_searchfunction,mapsdk_lbscloudsearch,mapsdk_calculationtool,mapsdk_radar

可按照项目需求，选择性下载SDK（个人建议越多越好，毕竟免费。当然，也要考虑Size）。

SDK包括jar和so文件夹两部分，需要分别保存至app/libs和app/src/main/jniLibs下。So文件添加后将被自动识别，jar则需要手动添加至project buildpath。

此时，SDK已完成导入。但使用SDK，需要根据功能的不同，开通不同权限。项目中用到了Baidu Map的基本功能，以及定位功能。因此，申请以下权限。

    <!-- add Permission for Baidu Map Common-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.INTERNET" />

    <!-- add Permission for Baidu Map Basic-->
    <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.WRITE_SETTINGS" />

    <!-- add Permission for Baidu Map Location-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"></uses-permission>

至此，准备工作完成。剩下的，就是敲几行代码了。几~行~而~已~

（三）Hello Baidu Map

首先，创建Activity，并添加MapView控件。
此处的控件，并非Android Studio自带的com.google.android.gms.maps.MapView
，而是SDK中的com.baidu.mapapi.map.MapView。

其次，初始化SDK。

    private MapView mc_Around; 

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        Context context=getApplicationContext();
        SDKInitializer.initialize(context);
        mc_Around =(MapView)findViewById(R.id.mv_around);
        setContentView(R.layout.activity_around);
    }

注：务必在setContentView前完成SDK的初始化
注：务必使用getApplicationContext()获取context.

最后，重新Activity的生命周期函数。

 @Override
    protected void onDestroy() {
        super.onDestroy();
        mc_Around.onDestroy();
        mc_Around =null;
    }

    @Override
    protected void onPause() {
        super.onPause();
        mc_Around.onPause();
    }

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

至此，SDK融合完毕。效果图如下。

---

接下来，将记录Baidu Map 自动定位的实现。

---