开发注意事项 最后更新时间: 2024年12月03日
添加高德 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 以上系统。地图