定位SDK自V4.0版本之后,引入了百度地图开放平台的统一AK验证体系。
通过AK验证机制,开发者可以更方便、更安全地配置自身使用的百度地图资源(如服务配额等)。
随着百度地图开放平台的发展,未来您还可以通过AK获得更多服务(如提升服务次数、定制化服务等)。
注意:
1. 当您选择使用V4.0及之后版本的定位SDK时,需要先申请且配置AK,并在程序相应位置填写您的AK;(选择使用V3.3及之前版本SDK的开发者,不需要使用AK);
2. 每个AK仅且唯一对于1个应用验证有效,即对该AK配置环节中使用的包名匹配的应用有效。因此,多个应用(包括多个包名)需申请多个AK,或者对1个AK进行多次配置;
3. 若您需要在同一个工程中同时使用Android定位SDK和Android地图SDK,可以使用同一个AK。
获取AK的流程大致可分为如下四个步骤:(1)登录API控制台;(2)创建应用;(3)配置SHA1和包名;(4)提交生成AK。
接下来向各位开发者做详细介绍:
输入网址,进入API控制台。如果您还未登录,会显示如下页面,输入帐号及密码,点击登录,即可正常进入API控制台;
如果您还不是我们百度地图开放平台的开发者用户,请点击立即注册,按照流程指引,一步一步完成开发者注册工作,然后再进入API控制台获取AK;
如何获取SHA1和包名?请开发者继续阅读本页后文。
a. 应用名称:开发者请自行定义,建议与应用名称一致,便于管理;
b. 应用类型:开发者请注意选择为Android SDK,选择其他类型,将导致所生成的AK不可用;(启用服务默认全部启用即可);
c. 填写SHA1和包名:这两个信息请开发者注意准确填写,它们是AK验证合法性的唯一依据。SHA1和包名的获取方式,请参考如下介绍:
(一)SHA1的获取方法:
SHA1分为发布版和开发版,便于开发者开发调试和最终上线使用。
获取方式一:通过Eclipse获取
使用 adt 22 以上版本,可以在 Eclipse 中直接查看,具体位置如下:
Windows:依次在 Eclipse 中打开 Window -> Preferances -> Android -> Build;
Mac:依次在 Eclipse 中打开 Eclipse/ADT->Preferances -> Android -> Build。
在弹出的对话框中SHA1 fingerprint中的值即为 Android 签名证书的 SHA1 值,如下图所示:
获取方式二:通过Android Studio获取
1. 打开Android Studio,进入Terminal工具,如下图所示:
2. 输入命令行和密码,即可获取SHA1等信息;
命令行:keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey (注意目录选择、开发版本、发布版本等问题)
密码:原始密码一般为android,开发者根据实际情况填写。
获取方式三:使用 keytool(jdk自带工具)获取
1. 运行进入控制台
Windows:运行 -> 输入cmd -> 确定。
Mac:直接打开 终端。
2. 在控制台内,定位到.android文件夹,输入cd .android
Windows与Mac操作一致,如下截图为Mac效果。
3. 输入命令行和密码,获取SHA1等信息
命令行:keytool -list -v -keystore debug.keystore;
密码:原始密码一般为android,开发者根据实际情况填写。
注意:
调试版本使用 debug.keystore,命令为:keytool -list -v -keystore debug.keystore。 发布版本使用 apk 对应的 keystore,命令为:keytool -list -v -keystore apk 的 keystore。
(二)包名的获取方法:
获取方式一:在Eclipse中获取
适用于使用Eclipse开发工具的开发者。
打开 Android 项目的 AndroidManifest.xml 配置文件,package 属性所对应的内容为应用包名,如下图所示:
获取方式二:在Android Studio中获取
适用于使用Android Studio开发工具的开发者。
Android Studio可以通过applicationId配置包名,如果配置了build.gradle文件,包名应该以applicaionId为准,防止build.gradle中的applicationId与 AndroidMainfest.xml中的包名不同,导致AK鉴权失败。
获取AK过程中,如遇问题,请及时在线反馈给我们。
请开发者妥善保管生成的AK。