1. 官网下载SDK
(https://lbsyun.baidu.com/index.php?title=androidsdk/sdkandev-download),建议下载sdk.demo示例。示例文件libs文件夹下包含.so文件和.jar文件。
2. 打开AS project,导入百度地图SDK,两种方法
方法一:在app.libs文件夹下将.jar文件导入,app.src.main文件夹下创建jniLibs文件夹并导入.so文件(图一)。
图一 图二
方法二:.jar文件必须导入到app.libs文件夹下,而.so文件可以存放在其他文件夹下(比如与.jar文件同导入app.libs,图二),此时必须在build.gradle(app)文件android{}中加入 sourceSets{ main{ jniLibs.srcDirs = ['libs'] } },以关联app.libs文件夹下的.so文件(图三),其中‘libs’可以换成其他路径。
图三
Tips:注意了,如果使用了方法一,而且又加入了方法二的代码,编译不报错,但程序会闪退,原因就是找不到.so文件(本人就是吃过这个亏)
(可以参考https://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-project/androidstudio)
3. 添加.jar文件依赖,也有两种方法
方法一:直接在build.gradle(app)文件中加入依赖(图四):
图四
Tips:注意了,Gradle3.0以上版本使用implementation,以下则用compile,括号中填入需要加入的.jar文件
方法二:通过菜单File——>Project Structure——>左边Modules.app——>右边Dependencies——>右侧绿色的加号(如图五),导入所需要的.jar文件即可,build.gradle中会自动导入方法一的代码。
(这个方法笔者不管用,不知道是什么原因,加入后还是没反应)
图五
(可以参考https://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-project/androidstudio)
4. 获取密钥并加入到配置文件
1)获取密钥(http://lbsyun.baidu.com/apiconsole/key/create,图六),没有百度账号则需要先注册。
图六
这里需要知道发布SHA1数字证书,Android studio在安装的时候会自动生成一个测试用的Debug数字证书,存储在用户下.android文件夹的debug.keystore文件中,每台计算机都不一样(只能供测试使用)。该测试证书可以通过windows终端或者AS自带的terminal终端中,进入C:\Users\用户名\.android\文件夹下,使用keytool -list -v -keystore debug.keystore命令,(图七):
图七
找到SHA1证书码,输入到图六中SHA1栏中,同时包名栏填写你新建的这个project的包名即可。确认后就可得到密钥(AK),如图八:
图八
2)加入密钥到配置文件中,在AndroidManifest.xml配置文件中的<application>标签中添加子标签<meta-data>,(图九),加入刚刚获取的密钥:
图九
以下5—8步骤均可以参考百度官方网站hello baidumap案例:
(https://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-project/hellomap)
5. 添加API所需要的权限
百度地图API需要以下权限(图十)
打开AndroidManifest.xml配置文件,在<application>标签之外,添加需要的权限:
图十
6. 布局文件中添加百度地图组件
打开布局文件activity_main.xml添加地图组件(图十一):
图十一
Tips:注意了,这里不能在预览页面直接加入MapView组件,这是因为Design页面只能加入google地图组件,必须手动添加百度地图组件的代码。(否则的话,我的情况是,在build.Module页面会出现,依赖了不同版本的libraries错误,不知道你们会是什么错误)
7. 初始化context,以及获取百度地图组件的对象
在MainActivity.java文件的onCreate()方法中加入(需要在setContentView()方法之前执行)SDKInitializer.initialize(getApplicationContext())语句,来初始化地图SDK;并获取地图控件对象nmap(图十二)
图十二
Tips:注意了,使用百度地图组件前,必须执行SDKnitializer.initialize()进行初始化,否则程序会闪退。
8. 重写activity生命周期的方法,管理地图周期(图十三)
图十三
以上导入百度地图SDK(包含定位SDK)基本完成,需要进行地图定位的请参考官方文档:
(https://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-map/location)
//地图SDK(显示定位)
(https://lbsyun.baidu.com/index.php?title=android-locsdk/guide/get-location/latlng)
//定位SDK(即时获取定位信息)
Tips:官网上配置定位SDK时加入了以下代码,但我没有加也能定位,不知道有啥用,你们如果定位不了可以试试加入。
(官网定位SDK配置:https://lbsyun.baidu.com/index.php?title=android-locsdk/guide/create-project/android-studio)
<service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote"> </service>
Tips:注意了,显示定位代码中需要加入第一次定位动态移动到定位点的代码(官网没有给出),不然地图不会自动跳转到当前定位点,代码如下:(mBaiduMap为BaiduMap对象)
详细java代码请参考(https://www.jianshu.com/p/7cf34278d279)
感谢这位大神,代码简练易懂~