开发注意事项最后更新时间: 2024年04月17日

添加高德 Key

为了保证高德 Android SDK 的功能正常使用，您需要申请高德 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>

配置权限

在AndroidManifest.xml中配置权限:

地图SDK：

<!--允许访问网络，必选权限-->
<uses-permission android:name="android.permission.INTERNET" />  

<!--允许获取粗略位置，若用GPS实现定位小蓝点功能则必选-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 

<!--允许获取网络状态，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />    

<!--允许获取wifi网络信息，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 

<!--允许获取wifi状态改变，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> 

<!--允许写入扩展存储，用于数据缓存，若无此权限则写到私有目录-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

<!--允许写设备缓存，用于问题排查-->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />  

<!--允许读设备等信息，用于问题排查-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

搜索SDK

<!--允许访问网络，必选权限-->
<uses-permission android:name="android.permission.INTERNET" />  

<!--允许获取网络状态-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />    

<!--允许获取wifi网络信息-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 

<!--允许写入扩展存储，用于搜索结果缓存，若无此权限则写到私有目录-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

<!--允许写设备缓存，用于问题排查-->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />  

<!--允许读设备等信息，用于问题排查-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

隐私合规接口说明

地图

地图的合规接口说明如下：

/**
* 更新隐私合规状态,需要在初始化地图之前完成
* @param  context: 上下文 
* @param  isContains: 隐私权政策是否包含高德开平隐私权政策  true是包含 
* @param  isShow: 隐私权政策是否弹窗展示告知用户 true是展示 
* @since  8.1.0 
*/
public static void updatePrivacyShow(Context context, boolean isContains, boolean isShow) ;

/**
 * 更新同意隐私状态,需要在初始化地图之前完成
 * @param context: 上下文
 * @param isAgree: 隐私权政策是否取得用户同意  true是用户同意
 * @since 8.1.0
 */
public static void updatePrivacyAgree(Context context, boolean isAgree) ;

2.在构造MapView之前必须进行合规检查（OfflineMapManager，LBSTraceClient等也是一样的操作），设置接口之前保证隐私政策合规，检查接口如下：

MapsInitializer.updatePrivacyShow(context,true,true);
MapsInitializer.updatePrivacyAgree(context,true);

3.构造OfflineMapManager调用时要捕获异常信息（LBSTraceClient也是一样的操作），具体方式可参考如下：

try {
	mOfflineMapManager = new OfflineMapManager(this, this);
}catch (Exception e){

}

4.并在使用mOfflineMapManager的时候，请进行空指针判断，确保可以使用；

if (mOfflineMapManager != null){
// TODO
}

5.MapView不需要捕获异常信息，但是合规不通过地图将白屏

搜索

1.搜索的合规接口说明如下：

/**
* 更新隐私合规状态,需要在初始化搜索之前完成
* @param  context: 上下文 
* @param  isContains: 隐私权政策是否包含高德开平隐私权政策  true是包含 
* @param  isShow: 隐私权政策是否弹窗展示告知用户 true是展示 
* @since  8.1.0 
*/
public static void updatePrivacyShow(Context context, boolean isContains, boolean isShow) ;

/**
 * 更新同意隐私状态,需要在初始化地图之前完成
 * @param context: 上下文
 * @param isAgree: 隐私权政策是否取得用户同意  true是用户同意
 * @since 8.1.0
 */
public static void updatePrivacyAgree(Context context, boolean isAgree) ;

2.在构造PoiSearch之前必须进行合规检查（RouteSearch，WeatherSearch等也是一样的操作），设置接口之前保证隐私政策合规，检查接口如下：

ServiceSettings.updatePrivacyShow(context,true,true);
ServiceSettings.updatePrivacyAgree(context,true);

3.构造PoiSearch调用时要捕获异常信息，具体方式可参考如下：

try {
	mPoiSearch = new PoiSearch(context);
}catch (AMapException e){
}

4.并在使用mPoiSearch的时候，请进行空指针判断，确保可以使用；

if (mPoiSearch != null){
// TODO
}

个人及设备信息采集设置

/**
 * 基础库设置是否允许采集个人及设备信息
 * @param collectEnable: true 允许采集 false 不允许采集 
 */
AMapUtilCoreApi.setCollectInfoEnable(boolean collectEnable);

代码混淆

在生成 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.**{*;}

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 以上系统。地图

开发注意事项 最后更新时间: 2024年04月17日