全部服务产品
开发者频道
服务升级
登录
Android Studio配置
下载开发文档
1. 第一步,打开/创建一个Android工程

根据开发者的实际使用情况,打开一个已有Android工程,或者新建一个Android工程。 这里以新建一个Android工程为例讲解。

2. 第二步,添加SDK(jar + so)

方法一:
下载Android定位SDK并解压,将libs中的jar和so放置到工程中相应的位置。
注意:Android定位SDK提供了多种CPU架构的so文件(jar通用,只有一个),开发者可根据实际使用需求,放置所需so到对应的工程文件夹内。
下图为Android定位SDK文件结构示意图:

下图为Android定位SDK放置到Android工程中的示意图,这里仅以arm64-v8a为例:

注意:
1. 如果开发的是系统应用,除了需要在工程中配置so文件,还需要手动把对应架构的so文件拷贝到/system/lib下,如果是64位系统,则需要将64位的so文件拷贝到/sytem/lib64下。
2. 新版本的定位SDK,开发者除了要更新jar包之外,同时需要关注so文件是否有更新。如果so文件名称改变,即so文件有更新,开发者要及时替换掉老版本,否则会导致定位失败。

配置build.gradle文件,注意设置sourceSets。

sourceSets{
main{
jniLibs.srcDir 'libs'
jni.srcDirs = [] //disable automatic ndk-build
}
}
dependencies {
compile fileTree(dir: 'libs' , include: ['*.jar'])
androidTestCompile ('com.android.support.test.espresso: espresso-core: 2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support: appcompat-v7:25.1.0'
testCompile 'junit: junit: 4.12'
}

方法二:
注意:目前Gradle中集成SDK只支持国内版本如果需要Google 渠道版本SDK 请到官网下载一体化包
通过Gradle 集成sdk
1)、在Project的build.gradle文件中配置repositories,添加mavenCentral仓库地址

配置如下:

allprojects {
repositories {
mavenCentral()
}
}

2)、在主工程的build.gradle文件配置dependencies

SDK引入依赖
地图组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Map:7.5.4'
检索组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Search:7.5.4'
工具组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Util:7.5.4'
步骑行组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Map-BWNavi:7.5.4'
基础定位组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Location:9.3.7'
全量定位组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Location_All:9.3.7'
驾车导航组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Map-Navi:7.5.4'
驾车导航+步骑行导航implementation 'com.baidu.lbsyun:BaiduMapSDK_Map-AllNavi:7.5.4'
TTS组件implementation 'com.baidu.lbsyun:NaviTts:3.2.8'
全景组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Panorama:2.9.0'

3)、主工程的build.gradle文件在Project目录中位置:

以下是基础定位组件相关依赖的示例, 配置如下:

android {
defaultConfig {
ndk {
// 设置支持的SO库架构(开发者可以根据需要,选择一个或多个平台的so)
abiFilters "armeabi", "armeabi-v7a", "arm64-v8a", "x86","x86_64"
}
}
}
dependencies {
implementation 'com.baidu.lbsyun:BaiduMapSDK_Location:9.6.0'
}

注意:在gradle依赖时如果同时使用多个组件时,部分组件会产生冲突,在使用时根据自己的项目需求去组合,以下是会产生冲突的组件。

组件依赖备注
基础定位组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Location:9.1.8'选其一
全量定位组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Location_All:9.1.8'
地图组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Map:7.4.0'这些组件中都包含了BaiduMapSDK_Map组件,根据需求选其一
步骑行组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Map-BWNavi:7.4.0'
驾车导航组件implementation 'com.baidu.lbsyun:BaiduMapSDK_Map-Navi:7.4.0'
驾车导航+步骑行导航implementation 'com.baidu.lbsyun:BaiduMapSDK_Map-AllNavi:7.4.0'
3. 第三步,添加AK

Android定位SDK自v4.0版本起,需要进行AK鉴权。开发者在使用SDK前,需完成AK申请,并在AndroidManifest.xml文件中,正确填写AK。AK如何获取?点击这里了解详情。
在Application标签中增加如下代码:

<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="AK" >
</meta-data>

如下图所示:

LocationClient.setKey(xxxxxx);
可在使用该接口与AndroidManifest.xml中配置AK值两种方法中任选一样进行设置。

4. 第四步,添加定位权限

使用定位SDK,需在AndroidManifest.xml文件中Application标签中声明service组件,每个App拥有自己单独的定位service,代码如下:

<service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote"> </service>

除添加service组件外,使用定位SDK还需添加如下权限:

<!-- 这个权限用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
<!-- 这个权限用于访问系统接口提供的卫星定位信息-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
<!-- 用于访问wifi网络信息,wifi信息会用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<!-- 获取运营商信息,用于支持提供运营商信息相关的接口-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<!-- 这个权限用于获取wifi的获取权限,wifi信息会用来进行网络定位-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
<!-- 写入扩展存储,向扩展卡写入数据,用于写入离线定位数据-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<!-- 访问网络,网络定位需要上网-->
<uses-permission android:name="android.permission.INTERNET"></uses-permission>

上一篇

Eclipse配置

下一篇

隐私合规接口

本篇文章对您是否有帮助?