From b4c0b820df3a6c557b86b21bc67aade9d3ebcbba Mon Sep 17 00:00:00 2001 From: Daniel Micay Date: Thu, 17 Feb 2022 09:35:53 -0500 Subject: [PATCH] update / improve GmsCompat documentation --- static/usage.html | 42 +++++++++++++++++++++--------------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/static/usage.html b/static/usage.html index 84e78954..e114fa7b 100644 --- a/static/usage.html +++ b/static/usage.html @@ -895,29 +895,29 @@

Configuration

The compatibility layer has a configuration menu available at Settings ➔ - Apps ➔ Sandboxed Google Play. It provides links to this usage guide, Play - services system settings, Google Location Accuracy setting, Play Store system - settings and Google settings. The Play services and Play Store system settings - are only included for convenience since they can be accessed the same way as - any other app via Settings ➔ Apps. The Google Location Accuracy and Google - settings activities would normally be integrated into the OS but we don't - include any of the standard Google Play integration so there needs to be an - app providing a way to access them.

+ Apps ➔ Sandboxed Google Play.

-

The Google Location Accuracy toggle is an internal Google Play toggle for - whether it will use their network-based location service. By default, it will - only use the GNSS-based location provided by the OS. Some apps using the Play - services geolocation service will only work if network-based geolocation is - enabled if they lack a fallback to requesting the higher power usage - GNSS-based geolocation when it's disabled.

+

By default, apps using Google Play geolocation are redirected to our own + implementation on top of the standard OS geolocation service. If you want to + use Google's geolocation service instead, you can disable the "Reroute + location requests to OS APIs" toggle and manually grant "Allow all the time" + Location access to Google Play services. For it to be fully functional, you + also need to use "Google Location Accuracy" link to access the Google Play + services menu for opting into their network location service. This will send + the nearby Wi-Fi and cellular networks provided via the Location permission to + their service to retrieve a location estimate. The Nearby Devices permission + can also be granted to give it access to nearby Bluetooth device IDs. If you + stick with the default enabled redirection mode, none of this needs to be + granted for working geolocation in apps.

-

In the future, the Sandboxed Google Play app will provide a toggle for - geolocation redirection. By default, apps using the Play services geolocation - service will be redirected to an implementation based on the OS geolocation - service without all the advanced features. This will enable apps using it to - work out-of-the-box without needing to grant the Location permission to Play - services. This has been largely developed but still needs substantial work - before we can include it in the OS.

+

The Google Location Accuracy and Google settings activities would normally + be integrated into the OS but we don't include any of the standard Google Play + integration so there needs to be an app providing a way to access them.

+ +

The menu also provides links to this usage guide, Play services system + settings, Play Store system settings and Google settings. The Play services + and Play Store system settings are only included for convenience since they + can be accessed the same way as any other app via Settings ➔ Apps.