android-navsdk

导航SDK集成

1权限说明

<!--访问网络，用于SDK鉴权、算路导航-->
<uses-permission android:name="android.permission.INTERNET" />
<!--用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!--用于访问GPS定位-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!--获取网络状态，避免产生不必要的网络请求-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!--获取Wi-Fi状态，避免产生不必要的网络请求 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 用于ugc事件上报拍照录像 -->
<uses-permission android:name="android.permission.CAMERA"/>
<!-- 用于ugc事件上报录音 -->
<uses-permission android:name="android.permission.RECORD_AUDIO"/>

2授权key配置

申请到百度开放平台应用Key后，为了能够百度导航SDK正常运行，将其配置在AndroidManifest.xml的application节点内部，如下所示：

<meta-data android:name="com.baidu.lbsapi.API_KEY" android:value="申请的Key" />

3导航SDK核心集成

导航SDK核心已经打包为一个独立的aar，命名为onsdk_all.aar，可以将其以aar module引入集成APP project，引入后，即可引用导航SDK相关类进行开发。在4.8.0.0版本以上，导航SDK中的so从aar中分离出来，分别支持armeabi，armeabi-v7a，arm64-v8a三种架构，开发者可以下载产物后自行选择相应的架构添加至工程。

4导航SDK依赖库集成

导航SDK目前依赖库主要包含两方面：第三方库和百度其他库。目前这些库在提供时都是以jar包提供，实际集成时，对于第三方库，也可以采用gradle自身的引用方式。下图中红圈标记的为第三方库，其他为百度其他库。

除了上图的库，百度导航SDK还需要引入2个库，分别是recyclerview-v7包和apache包，引入方式如下：

android {
  // apache包
  useLibrary 'org.apache.http.legacy'
  ……
}
dependencies {
   implementation 'com.android.support:appcompat-v7:28.0.0'
   implementation 'com.android.support:cardview-v7:28.0.0'
   implementation 'com.android.support:recyclerview-v7:28.0.0'
   implementation 'com.android.support.constraint:constraint-layout:1.1.3'
}

5导航SDK自带TTS集成

导航SDK自带TTS能力已经打包为一个独立的aar，命名为NaviTts.aar，可以将其以aar module引入集成APP project，引入后，可以利用导航SDK提供的TTS接口进行初始化。

当不需要导航SDK自带TTS时，可以不进行集成，此时需要利用导航SDK支持外部TTS的方式进行TTS能力初始化。

6SDK和TTS授权申请配置

这里包括SDK授权和TTS授权两部分，申请时先申请SDK授权，再申请TTS授权，具体授权申请方式如下。

5.1 SDK授权申请

1. 准备材料

1） apk包名

2） apk签名sh1

2. 登录//lbsyun.baidu.com/apiconsole/key 申请更详细的过程可参考说明：//lbsyun.baidu.com/index.php?title=android-navsdk/guide/key

3. 记得将申请的key按照上述说明，在工程Manifest文件中进行配置，否则导航SDK将处于功能不可用状态

5.2 TTS授权申请

SDK授权申请后，可以继续申请TTS授权。

1. 以SDK授权申请时相同账号登录 http://yuyin.baidu.com/，点击右上角的“控制台“，进入控制台界面，点击左侧导航栏“语音技术”，然后点击创

建应用。

2. 按步骤填入应用名称、包名等信息。

3. 点击立即创建会生成App ID，就是在开发中初始化TTS能力时传入的参数之一

至此，和导航SDK集成相关的授权申请就完成了。

7so库的集成

在 main 目录下创建文件夹 jniLibs (如果有就不需要创建了)，将下载文件的 armeabi 等相关文件夹复制到这个目录下,如果已经有这个目录，将下载的 so 库复制到这个目录即可。如图所示

8Android Studio配置与Gradle配置

1.由于百度导航不支持instant run，因此开发者使用的Android studio中如果有instant run功能选项请先关闭（较新版本的Android studio没有这个功能选项，可忽略），不然会造成编译失败，在设置中搜索instant run，关闭方式如下图。

2.为了避免Android "64K 引用限制"引起的异常，在app的build.gradle中需要引入multidex包，并进行相关配置，并且导航SDK内部使用了annotationProcessor，同样需要在build.gradle中配置，如下。

defaultConfig {
    ……
    // 避免"64K 引用限制"
    multiDexEnabled true
    // 导航SDK内部使用了annotationProcessor，需要添加下面代码，防止编译异常
    javaCompileOptions { annotationProcessorOptions { includeCompileClasspath = true } }
}

9代码混淆

# BaiduNavi SDK
-dontoptimize
-ignorewarnings
-keeppackagenames com.baidu.**
-keepattributes Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,LocalVariable*Table,*Annotation*,Synthetic,EnclosingMethod

-dontwarn com.baidu.**
-dontwarn com.baidu.navisdk.**
-dontwarn com.baidu.navi.**

-keep class com.baidu.** { *; }
-keep interface com.baidu.** { *; }

-keep class vi.com.gdi.** { *; }

-dontwarn com.google.protobuf.**
-keep class com.google.protobuf.** { *;}
-keep interface com.google.protobuf.** { *;}

-dontwarn com.google.android.support.v4.**
-keep class com.google.android.support.v4.** { *; }
-keep interface com.google.android.support.v4.app.** { *; }
-keep public class * extends com.google.android.support.v4.**
-keep public class * extends com.google.android.support.v4.app.Fragment