示例中心
功能在线体验
控制台

高德 开发 Android 导航SDK 开发指南 创建工程 开发注意事项

更新时间:2018年02月01日

注意:Android 64位操作系统设备可以采用兼容模式运行32位的库文件,需要您在Eclipse、Android Studio配置工程的时候,在libs下面只保留一个armeabi文件夹,其余可以去除。

声明定位 service 组件

为了保证使用导航 1.9.3(以上)-5.0.0(不含)版本导航功能的正确使用,需在 AndroidManifest.xml 中配置定位 service 组件。请在application标签中声明service 组件,添加如下代码:

<service android:name="com.amap.api.location.APSService"></service>

添加高德Key

需要将您刚申请的高德 Key 配置到项目中,打开项目的 “AndroidManifest.xml” 文件中,添加如下代码:

<application
         android:icon="@drawable/icon"
         android:label="@string/app_name" >
         <meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="请输入您的用户Key"/>
            ……
</application>

配置权限

Android 6.0及以上系统可以参考Android 6.0权限说明章节

在 AndroidManifest.xml中配置权限,代码如下:

<!--用于访问网络,网络定位需要上网-->
<uses-permission android:name="android.permission.INTERNET" />
<!--写入扩展存储,向扩展卡写入数据,用于写入缓存定位数据-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!--用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!--获取运营商信息,用于支持提供运营商信息相关的接口-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!--用于访问GPS定位-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!--用于读取手机当前的状态-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!--用于访问wifi网络信息,wifi信息会用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--这个权限用于获取wifi的获取权限,wifi信息会用来进行网络定位-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<!--这个权限用于允许程序在手机屏幕关闭后后台进程仍然运行-->
<uses-permission android:name="android.permission.WAKE_LOCK"/>

代码混淆

在生成 apk 进行代码混淆时进行如下配置(如果报出 warning,在报出 warning 的包加入类似的语句:-dontwarn 包名)

3D 地图 V5.0.0之前:
-keep   class com.amap.api.maps.**{*;} 
-keep   class com.autonavi.amap.mapcore.*{*;} 
-keep   class com.amap.api.trace.**{*;}

3D 地图 V5.0.0之后:
-keep   class com.amap.api.maps.**{*;} 
-keep   class com.autonavi.**{*;} 
-keep   class com.amap.api.trace.**{*;}

定位
-keep class com.amap.api.location.**{*;}
-keep class com.amap.api.fence.**{*;}
-keep class com.autonavi.aps.amapapi.model.**{*;}

搜索
-keep   class com.amap.api.services.**{*;}

2D地图
-keep class com.amap.api.maps2d.**{*;}
-keep class com.amap.api.mapcore2d.**{*;}

导航
-keep class com.amap.api.navi.**{*;}
-keep class com.autonavi.**{*;}


内置语音 V5.6.0之后
-keep class com.alibaba.idst.nls.** {*;}
-keep class com.google.**{*;}
-keep class com.nlspeech.nlscodec.** {*;}

so 文件说明

地图 SDK 和导航 SDK 的核心功能实现依赖 so 库。在使用 SDK ,以及向工程中添加 so 时请注意以下几点:

确保添加了正确的 so 库文件

何为正确的 so 文件?

官方发布新版 SDK 时一定会同时更新 jar 文件和 so 文件,您需要做的是更新这些文件到您的工程中,不要出现遗漏。

您可以参考Eclipse、Android Studio 配置工程提到的添加方法进行操作。

确保添加的 so 库文件与平台匹配

何为正确的 so 文件与平台匹配?

arm与x86,这代表核心处理器(cpu)的两种架构,对不同的架构需要引用不同的 so 文件,如果引用出现错误是不能正常使用 SDK 的。

解决这个问题最简单的办法是在 libs 或 jnilibs 文件夹下只保留 armeabi 一个文件夹。

其余问题

您也可以浏览这篇帖子的内容,基础的开发技能均在其中。

兼容性

支持 Android 4.0 及以上系统。

示例中心 功能
在线体验
常见问题