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

添加高德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中配置权限:

<!--允许访问网络，必选权限-->
<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 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一个文件夹。

其余问题

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

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