在Android Studio中导入高德地图以及百度地图SDK之后进行汇总。
本文为第一次导入地图类SDK，以百度地图和高德地图为例，腾讯地图后续加入。
百度和高德地图开放平台官网链接
步骤
1.获取KEY
在相应的国内SDK开发者网站上获取key
注意：
首次创建应用需要输入的SHA1分两种：测试版（又称调试版，看各平台的描述），
发布版的KEY SHA1 值是不同的，发布 apk 时需要根据发布 apk 对应的 keystore 重新配置 Key。
by 高德地图申请开发密钥步骤
每个Key唯一对应一个APP
by 百度地图申请开发密钥步骤
此步骤通常需要输入发布版SHA1，获取方法：
-
系统终端获取
-
AS中终端获取
命令：keytool -v -list -keystore
2.配置
2.1:将SDK导入工程：添加so文件
导入so文件，有两种方法：
第一种：新建文件目录，工程会自动加载src目录下的so文件
路径：
app\src\main\
- 新建jniLibs目录
- 将各种架构的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语言进行标记以及引用各个部分的链接，百度开放平台可以学习一下。
本文若有不当之处以及勘误，欢迎留言指正。
本文同时发表在我的个人博客：故事熊
欢迎评论留言以及观光。
网友评论