如何将HERE SDK for Android (Starter Edition)3.12升级至3.13

整个升级过程没有业务API层面的适配成本，核心是替换依赖和清理旧版本兼容分区存储的临时配置，步骤如下：

• 替换SDK依赖文件
  本地AAR依赖的项目，直接删除libs目录下原有的3.12版本SDK AAR包，替换为3.13版本的AAR文件即可；使用远程仓库依赖的项目，直接把模块级build.gradle文件中HERE SDK依赖的版本号修改为3.13，执行Gradle同步确认依赖加载成功。
• 清理分区存储临时兼容配置
  如果你之前为了让3.12版本在Android 10+上运行，在AndroidManifest.xml的<application>标签下添加了android:requestLegacyExternalStorage="true"属性，升级后直接删除该属性即可。3.13版本已经原生适配分区存储机制，不需要依赖旧版存储兼容模式运行。
• 调整权限声明
  旧版SDK需要读写公共外部存储目录，因此很多项目会声明READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE权限。升级到3.13后，SDK默认将地图缓存、离线地图数据存储在应用私有目录下，如果你的应用没有其他外部存储读写需求，可以直接删除这两个权限声明，减少权限申请成本。
• 验证核心场景
  升级完成后重点验证几个核心场景即可：
  • Android 10及以上系统版本上冷启动加载地图，确认无存储权限相关报错、无地图白屏问题
  • 存量用户升级场景下，验证原有已下载的离线地图、用户缓存的地图数据可以正常加载，SDK首次启动会自动完成旧路径数据到新私有目录的迁移，不需要手动编写迁移逻辑
  • 如果你有自定义的地图相关文件操作（比如导入自定义点位、导出轨迹），不要继续读写旧版SDK使用的公共存储目录，统一使用context.getExternalFilesDir()对应的应用私有目录即可。

注意：3.13版本和3.12版本的业务API完全向下兼容，你之前写的地图加载、点位标注、路径规划等业务代码不需要做任何修改。如果升级后出现鉴权失败问题，优先检查AAR包是否替换完整、是否存在旧版本SDK类文件残留，3.13版本的鉴权规则和3.12完全一致，只要包名、应用签名和license绑定信息一致就不会触发鉴权拦截。

内容的提问来源于stack exchange，提问作者Serggio Lysenko