update / improve GmsCompat documentation

This commit is contained in:
Daniel Micay 2022-02-17 09:35:53 -05:00
parent 49d21c7069
commit b4c0b820df

View File

@ -895,29 +895,29 @@
<h3><a href="#sandboxed-google-play-configuration">Configuration</a></h3>
<p>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.</p>
Apps ➔ Sandboxed Google Play.</p>
<p>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.</p>
<p>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.</p>
<p>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.</p>
<p>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.</p>
<p>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.</p>
</section>
<section id="sandboxed-google-play-limitations">