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.配置

配置过程通常需要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 &＃8216;jniLibs&＃8217; for source set &＃8216;main&＃8217; 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 &＃8216;compile&＃8217; is obsolete and has been replaced with &＃8216;implementation&＃8217; and &＃8216;api&＃8217;.

建议输入最新写法。

第二种：

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

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

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

Cause: archive is not a ZIP archive

显示地图

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

添加权限

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

路径

AndroidManifest.xml

初始化地图

参考链接：

百度：Android 地图SDK-Hello BaiduMap

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

添加主要view

路径

appsrcmainreslayoutactivity_main.xml

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

android:id="@+id/amapView/bmapView" //高德或百度地图
android:layout_ //高德或百度地图
android:layout_ //高德或百度地图
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语言进行标记以及引用各个部分的链接，百度开放平台可以学习一下。

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

欢迎评论留言以及观光。