在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语言进行标记以及引用各个部分的链接,百度开放平台可以学习一下。
本文若有不当之处以及勘误,欢迎留言指正。
本文同时发表在我的个人博客:故事熊
欢迎评论留言以及观光。