Android Studio导入并显示国内地图SDK步骤对比以及需要注意的点（百度地图和高德地图为例）

本文为第一次导入地图类SDK，以百度地图和高德地图为例，腾讯地图后续加入。
本文若有不当之处以及勘误，欢迎留言指正。

百度和高德地图开放平台官网链接

百度地图开放平台

高德开放平台

步骤

1.获取KEY

在相应的国内SDK开发者网站上获取key

注意：

首次创建应用需要输入的SHA1分两种：测试版（又称调试版，看各平台的描述），

发布版的KEY SHA1 值是不同的，发布 apk 时需要根据发布 apk 对应的 keystore 重新配置 Key。

by 高德地图申请开发密钥步骤

每个Key唯一对应一个APP

by 百度地图申请开发密钥步骤

此步骤通常需要输入发布版SHA1，获取方法：

1. 系统终端获取
2. AS中终端获取

命令：keytool -v -list -keystore

2.配置

配置过程通常需要X步，

2.1:将SDK导入工程：添加so文件

导入so文件，有两种方法：

第一种：新建文件目录，工程会自动加载src目录下的so文件

路径：

appsrcmain\

1. 新建jniLibs目录
2. 将各种架构的so文件（夹）拷贝进其中。

第二种：修改gradle

applibs

新建libs,将各种架构的so文件（夹）拷贝进其中，之后在

appbuild.gradle中：

android {
...
sourceSets{
  main{
       jniLibs.srcDir 'libs'  //添加此行，说明so的路径为该libs路径，关联所有地图SDK的so文件
      }
}
...
}

注意：此代码必须放在android括号内，否则会报错：**

Could not get unknown property 'jniLibs' for source set 'main' of type

参考链接：CSDN博客

2.2 添加Jar文件/依赖代码

此处则根据项目（工程）需求自行填加所需jar。

有两种方法：

在Project的build.gradle文件中配置repositories，添加maven/jcenter仓库地址 路径： appbuild.gradle

1. allprojects {
2.    repositories {
3.        jcenter() // 或者 mavenCentral()
4.   }
5. }

主工程配置依赖，有两种方式：

将jar放在libs目录下，之后（以下两步可选其一）：

1.1： jar的每个jar文件:右键-Add As Library

1.2： File -Project Structure-Project Structure-module app, 点击 Dependencies，下方则会自动生成

相关依赖代码：

dependencies{

 compile files('libs/BaiduLBS_Android.jar') //百度地图

}

注意：官方文档中为 compile,最新为implementation，若输入 compile则会出现以下报错：

WARNING: Configuration 'compile' is obsolete and has been replaced with 'implementation' and 'api'.

建议输入最新写法。

第二种：

或者直接使用引入libs下所有jar包的方式：

注意：此方式libs无需导入jar包，即以上方法添加so文件第二正方法不适用。

高德-Android Studio 配置工程：注意说明了这一点，我的高德地图集成汇总链接复现了这一点，出现以下报错：

Cause: archive is not a ZIP archive

显示地图

此处展示需要添加在地图中的权限以及key添加的位置，由于地图不一致，所以只显示其共同特点。

添加权限

此处列举出几种地图都需要的权限，可能会有所出入。

路径

AndroidManifest.xml

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 
<!--获取设备网络状态，禁用后无法获取网络状态-->

<uses-permission android:name="android.permission.INTERNET"/> 
<!--网络权限，当禁用后，无法进行检索等相关业务-->

<uses-permission android:name="android.permission.READ_PHONE_STATE" /> 
<!--读取设备硬件信息，统计数据/读写手机状态和身份-->

<uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" /> 
<!--读取系统信息，包含系统版本等信息，用作统计-->

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 
<!--获取设备的网络状态，鉴权所需网络代理,访问WiFi网络信息-->

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> 
<!--允许sd卡写权限，需写入地图数据，禁用后无法显示地图-->

<uses-permission android:name="android.permission.WRITE_SETTINGS" /> 
<!--获取统计数据-->

<uses-permission android:name="android.permission.CAMERA" />  
<!--使用步行AR导航，配置Camera权限-->
   
<!--高德地图-->
<!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 

初始化地图

参考链接：

百度：Android 地图SDK-Hello BaiduMap

高德：开发指南-创建地图-显示地图-第三步，初始化地图容器

添加主要view

路径

appsrcmainreslayoutactivity_main.xml

此处不同地图的宽和高，match_parent/fill_parent，至于为什么不一致，需要再探究。

<com.baidu.mapapi.map.MapView  
    android:id="@+id/amapView/bmapView"  //高德或百度地图
    android:layout_width="match_parent/fill_parent"   //高德或百度地图 
    android:layout_height="match_parent/fill_parent"    //高德或百度地图
    android:clickable="true" /> //百度地图独有

管理地图生命周期

合理管理地图生命周期。

路径

appsrcmainjavaMain.activity.java

public class MainActivity extends Activity {  
     private MapView mMapView = null; //百度地图
     MapView mMapView = null; //高德地图
    
    @Override
        protected void onDestroy() {
            super.onDestroy();
            //在activity执行onDestroy时执行mMapView.onDestroy()，销毁地图
            mMapView.onDestroy();
        }
        @Override
        protected void onResume() {
            super.onResume();
            //在activity执行onResume时执行mMapView.onResume ()，重新绘制加载地图
            mMapView.onResume();
        }
        @Override
        protected void onPause() {
            super.onPause();
            //在activity执行onPause时执行mMapView.onPause ()，暂停地图的绘制
            mMapView.onPause();
        }
        @Override //在这两例中高德地图独有
        protected void onSaveInstanceState(Bundle outState) {
            super.onSaveInstanceState(outState);
            //在activity执行onSaveInstanceState时执行mMapView.onSaveInstanceState (outState)，保存地图当前的状态
            mMapView.onSaveInstanceState(outState);
        }
    }
    }

以上注释引用自高德地图—第三步，初始化地图容器，有添加百度地图第二行初始化代码。

不同地图的初始化时间

在添加主要view后百度地图需要初始化之后即可显示，

高德地图在管理地图生命周期后需要初始化地图即可显示，以下分别是他们的方法：

百度地图初始化方法：

SDK引用

public class DemoApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        //在使用SDK各组件之前初始化context信息，传入ApplicationContext   
        SDKInitializer.initialize(this);
        //自4.3.0起，百度地图SDK所有接口均支持百度坐标和国测局坐标，用此方法设置您使用的坐标类型.
        //包括BD09LL和GCJ02两种坐标，默认是BD09LL坐标。
        SDKInitializer.setCoordType(CoordType.BD09LL);
    }
}

高德地图初始化方法：高德地图-显示地图

//定义了一个地图view
mapView = (MapView) findViewById(R.id.map);
mapView.onCreate(savedInstanceState);// 此方法须覆写，虚拟机需要在很多情况下保存地图绘制的当前状态。
//初始化地图控制器对象
AMap aMap;
if (aMap == null) {
    aMap = mapView.getMap();        
}

注意：最新的Android Studio依照上述方法会报错：错误: 可能尚未初始化变量aMap

则需要修改为：

AMap aMap = null;
if (aMap == null) {
   aMap = mapView.getMap();
            }
        }

总结

在百度地图的开发教程中，首先配置，随后Hello Baidumap一章即可显示百度地图在界面中，很方便的表现出了“次序”，所见即所得。

高德地图文档则首先配置，其次需要在创建地图里的显示地图中添加相应权限，之后在显示地图的过程中再次包含了配置的过程，最后则显示地图，

此举可能是有考虑到开发者检查是否正确，但根据我的链接，出现错误后直接在论坛上反馈，而并非向下看，高德地图在这一点上可以标注一下。

高德地图开发者文档，则明显地列举出了步骤以及网页，很好的使用了导航逻辑, 使得本文可以顺利的使用mardown语言进行标记以及引用各个部分的链接，百度开放平台可以学习一下。

本文同时发表在我的个人博客：故事熊

欢迎评论留言以及观光。