百度地图Android 定位SDK—Android Studio配置

您当前位置：
Android定位SDK >
开发指南 >
项目创建 > Android Studio配置 Android Studio配置更新时间：2021年09月20日
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工程中的示意图，这里仅以armeabi为例：

注意：

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.4.0’
检索组件	implementation ‘com.baidu.lbsyun:BaiduMapSDK_Search:7.4.0’
工具组件	implementation ‘com.baidu.lbsyun:BaiduMapSDK_Util:7.4.0’
步骑行组件	implementation ‘com.baidu.lbsyun:BaiduMapSDK_Map-BWNavi:7.4.0’
基础定位组件	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-Navi:7.4.0’
驾车导航+步骑行导航	implementation ‘com.baidu.lbsyun:BaiduMapSDK_Map-AllNavi:7.4.0’
TTS组件	implementation ‘com.baidu.lbsyun:NaviTts:2.5.5’
全景组件	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.1.8'
}

注意：在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>

如下图所示：

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>
<!-- 这个权限用于访问GPS定位-->
<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>