AS导入并显示地图SDK对比以及注意点（百度、高德地图）

在AndroidStudio中导入高德地图以及百度地图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.配置

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

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

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

路径：

app\src\main\

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

**第二种：**修改gradle

app\libs

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

app\build.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仓库地址 路径： app\build.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包的方式：

implementation  fileTree(dir: 'libs', include: ['*.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

路径

app\src\main\res\layout\activity_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" /> //百度地图独有

管理地图生命周期

合理管理地图生命周期。

路径

app\src\main\java\Main.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语言进行标记以及引用各个部分的链接，百度开放平台可以学习一下。

本文若有不当之处以及勘误，欢迎留言指正。

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

欢迎评论留言以及观光。

、