Android Studio3.0对于百度地图SDK的开发（前置准备）

---

---

前言

这个学期在学习安卓项目开发，正好小组打算做有关地图的APP，在这里记录下自己的开发过程，以便日后进行查看。由于百度地图SDK的不断更新，无法保证以后该文章的代码依旧适用，请注意文章发布时间。

关于百度地图

百度地图开放平台
百度地图提供开源的SDK，注册成为百度地图开发人员即可下载。
百度地图对于自己提供的SDK同样提供了开发文档，但是值得吐槽的是，在跟着开发文档的过程中，遇到了不少问题。因此除了开发文档，在遇到bug时可以查看开发文档下附带的示例代码，有时候你会发现示例代码中的代码与开发文档中不同，可以进行参考。

百度地图控制台
开发百度地图SDK的关键平台，要想获取百度地图服务，就需要在这里创建应用，具体流程下文会说。

---

一、创建Android项目，获取SHA1

创建项目

File→New→New Project…，选择Empty Activity即可。
输入自己的项目的名字和包名，包名之后将作为百度地图控制台的验证内容之一，所以确定后尽量不要修改。
记住自己项目存放的位置，后续导入百度地图SDK时需要用到。
语言这里选的Java，因为本人比较熟悉。
最小SDK和手机运行系统有关，理论上API越小，能兼容的系统就越多，但是有些系统可能会因为SDK版本过低而无法安装，建议提前创建一个项目进行真机模拟，以确定该SDK版本能够在自己手机上运行。

获取SHA1

在百度地图控制台中我们可以看到，申请一个项目必须要发布版的SHA1，那么我们该如何去获取SHA1呢？

前置准备

在Android Studio最下方能找到Terminal选项，打开它。

输入cd C:\Program Files\Android\Android Studio\jre\bin

可以看到此时路径已经跳转了。
注意：这里的 C:\Program Files\Android\Android Studio是默认安装路径，如果是自定义安装请自行修改路径，在其中的\jre\bin文件夹中能找到keytool.exe文件

开发版SHA1

在C:\Users\（自己的用户名）中有一个.android文件夹，里面有一个叫做debug.keystore的文件，复制该文件的路径。

在Terminal中输入keytool -list -v -keystore （debug.keystore路径）

默认密钥库口令为android，输入不可见，请确定自己的输入没有出错。
在输出的文件中，我们可以在证书指纹中找到SHA1，这个SHA1是开发版的SHA1，如果只打算进行调试，可以当作发布版SHA1填上去，根据网上其他的文章来看，这么做可能会导致只有第一次定位能成功。

发布版SHA1

项目签名

在Android Studio中选择Build->Generate Bundle or APK
选择APK然后点击next

如果没有生成过jks文件，那么选择Create new…，生成过选择Choose existing…并选中jks文件即可。接下来讲讲如何创建新的jks。

Key store path一栏选择jks存储路径，可以不和项目放在一起，并起好名字。
在Password中设置密码并在Confirm中确认。
Alias中输入的名字一定要记住，在给项目签名时会用到。
同理设置密码并确认。
Validity默认即可，毕竟咱们的项目肯定用不到25年。
接下来在Certificate中随便写些内容，无关紧要，但不能空着。
输入完毕后点击OK。

此时我们可以看到所有栏位都被填好了。如果是选择已有的jks的话，下面的三栏需要自己手动填写。点击Next。

选择release，再点击Finish，就能签名完成了。

获取SHA1

和获取开发版SHA1一样，我们找到刚刚保存jks的地方，复制jks文件的路径，在Terminal中输入keytool -list -v -keystore （jks文件路径）
此时的密码是自己设置的密码，不是默认的android。
这样获取到的SHA1就是发布版的SHA1了

二、百度控制台创建应用

控制台
选择应用管理→我的应用
点击创建应用。

应用类型选择Android SDK

在此填入根据上文获取的发布版SHA1（开发版SHA1可不填），并填入项目的包名。

如果忘记了自己的包名是什么，选择app文件夹下的build.gradle

applicationId后面的就是该项目的包名

提交后便能得到访问该应用的AK

配置工程文件

SDK下载
根据自己的需要下载相应功能，这是我下载的配置

解压下载到的压缩包，将里面的内容复制到项目文件夹中的app->libs文件夹中。
可以看到在Android Studio的文件夹中也发生了变化。
右键.jar文件，选择Add as Lisbrary，确认后就可以看到.jar文件的左侧也出现了小箭头。

在app文件夹下的build.gradle文件中，在android块内添加如下代码

sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }

上方会出现一个蓝条，选择Sync now。
在app→src→main文件夹下的AndroidManifest文件中，在中加入以下代码

<meta-data
            android:name="com.baidu.lbsapi.API_KEY"
            android:value="控制台中获取的AK" />

这样，工程文件就配置完毕，可以开始开发地图了。

关于真机模拟

由于模拟器的定位功能受限，所以对地图的开发最好在真机上进行测试。
在手机设置的开发人员选项中打开USB调试，并打开监控ADB安装应用

将电脑与手机用数据线连接后会出现以下消息，点击确定

等待片刻可以看到调试设备变成了自己的手机，此时进行调试将会向手机发送安装包，安装后即可进行测试。