本页介绍了请求和管理后台位置信息使用权限的最佳实践。
请求“一律允许”位置信息权限
从 Android 14 开始,应用必须具有 ACCESS_BACKGROUND_LOCATION
权限才能访问用户的位置信息。Navigation SDK 在其清单文件中包含此权限,因此您无需明确请求此权限(如果不需要用于其他用途),因为 Gradle 清单合并工具会确保将其与应用的清单合并。
不过,仅拥有 ACCESS_BACKGROUND_LOCATION
权限不足以在后台访问位置信息,我们建议您向用户请求“始终允许”位置信息权限。这可确保应用能够在后台运行并显示通知,从而最大限度地提高导航期间的位置信息准确性。
提示应向用户说明授予此权限如何提高位置信息准确性,以及如何改善应用在后台运行时的导航体验。
如需详细了解如何提示用户授予位置信息访问权限,请参阅 Android 开发者文档中的请求位置信息权限 | 传感器和位置信息 | Android 开发者。
确保正确清理导航通知
为确保您的应用不会在通知不再需要后让其保持活跃状态,请务必执行以下清理步骤:
- 调用
startGuidance()
后,请务必调用stopGuidance()
或clearDestination()
。 - 注册
ArrivalListener
后,请务必取消注册。 - 注册
RoadSnappedLocationProvider
后,请务必取消注册。
完成这些步骤可确保在不再需要通知时,系统不会让通知保持活跃状态,这可能会导致电池电量耗尽和内存泄漏。
重新调用 NavigationApi#initForegroundServiceManager 方法时,请先调用 NavigationApi#clearForegroundServiceManager
如果您的应用使用的是 ForegroundServiceManager
,请先调用 NavigationApi#clearForegroundServiceManager
,然后再调用 NavigationApi#initForegroundServiceManagerProvider
;如果您已初始化 ForegroundServiceManager
,请调用 NavigationApi#initForegroundServiceManagerMessageAndIntent
。您可以通过此操作在初始化前台服务管理器后更新通知 ID 或通知内容。
Android 14 中引入的新限制简介
Android 14 (Android U) 对在后台访问用户位置信息的应用引入了新限制。为了帮助缓解这些变化,我们在 Navigation SDK 5.4.0 版本中进行了更新,以便更好地管理后台位置信息访问权限。我们还建议您更新实现方式,以确保您的应用能够继续访问最精确的位置数据。
Android 14 中的变更对 Navigation SDK 有何影响
当您在应用中调用 startGuidance()
时,前台服务会开始显示有关精细导航的用户通知。精细导航功能需要能够访问用户的位置信息,以便更新路线并显示正确的视觉和音频指示。从 Android 14 开始,应用若要在后台访问用户的精确位置信息,必须征得用户的权限。默认情况下,如果应用没有用户的后台位置信息访问权限,并且尝试启动用于位置信息更新的前台服务,系统会抛出 SecurityException
,导致应用崩溃。
Navigation SDK 如何缓解此问题
从 5.4.0 版开始,Navigation SDK 会处理此 SecurityException
,而不会影响应用,从而允许导航继续在后台运行。此外,Navigation SDK 在其 AndroidManifest
中包含 ACCESS_BACKGROUND_LOCATION
权限。这样,您的应用无需自行声明权限,因为 Gradle 合并将会处理该权限。不过,如果在应用进入后台之前未向用户显示通知,Navigation SDK 将依赖于系统提供位置信息更新。这些系统更新可能不频繁或不精确,从而导致导航体验欠佳。因此,我们建议您还应提示用户授予后台位置信息访问权限。
应用开发者可以采取哪些措施来提高导航位置信息的精确度
您可以更新应用,以提示用户授予后台位置信息访问权限,从而提高 Navigation SDK 使用的位置信号的精确性。如需了解详情,请参阅请求“一律允许”位置信息权限。