installation section for sandboxed Play services

This commit is contained in:
Daniel Micay 2021-11-12 10:01:26 -05:00
parent 34f3c9f5ce
commit edfb3c3842

View File

@ -96,6 +96,7 @@
<li>
<a href="#sandboxed-play-services">Sandboxed Play services</a>
<ul>
<li><a href="#sandboxed-play-services-installation">Installation</a></li>
<li><a href="#sandboxed-play-services-limitations">Limitations</a></li>
</ul>
</li>
@ -801,38 +802,44 @@
is also provided to support dynamically downloaded/loaded modules (dynamite
modules).</p>
<p>Install com.google.android.gsf, then com.google.android.gms and finally use a
split APK installer to install all 5 of the APKs for com.android.vending together.
Make sure to install all 3 in the correct order and don't skip installing the Play
Store since it provides services used by apps depending on Play. You can obtain a
split APK installer app from either Aurora Store, F-Droid or the developers of the
app via their GitHub releases, etc.</p>
<section id="sandboxed-play-services-installation">
<h3><a href="#sandboxed-play-services-installation">Installation</a></h3>
<p>In the future, we'll have a client app for our repository so you'll be able to
install and update the official Play services apps through that app and you won't
need to deal with split APK installation manually.</p>
<p>Install com.google.android.gsf, then com.google.android.gms and finally use
a split APK installer to install all 5 of the APKs for com.android.vending
together. Make sure to install all 3 in the correct order and don't skip
installing the Play Store since it provides services used by apps depending on
Play. You can obtain a split APK installer app from either Aurora Store,
F-Droid or the developers of the app via their GitHub releases, etc.</p>
<ul>
<li><a href="https://apps.grapheneos.org/packages/com.google.android.gsf/">com.google.android.gsf</a></li>
<li><a href="https://apps.grapheneos.org/packages/com.google.android.gms/">com.google.android.gms</a></li>
<li><a href="https://apps.grapheneos.org/packages/com.android.vending/">com.android.vending</a></li>
</ul>
<p>In the future, we'll have a client app for our repository so you'll be able
to install and update the official Play services apps through that app and you
won't need to deal with split APK installation manually.</p>
<p>You should give a battery optimization exception to Google Play services for
features like push notifications to work properly in the background. It isn't
needed for the other 2 apps.</p>
<ul>
<li><a href="https://apps.grapheneos.org/packages/com.google.android.gsf/">com.google.android.gsf</a></li>
<li><a href="https://apps.grapheneos.org/packages/com.google.android.gms/">com.google.android.gms</a></li>
<li><a href="https://apps.grapheneos.org/packages/com.android.vending/">com.android.vending</a></li>
</ul>
<p>After installing the apps, you should open the Play Store and press sign in to
trigger initialization. Signing into an account is optional and it will work fine
without it, but you do need to get it initialized and this is currently the best
way to mimic the initialization done by the stock OS setup wizard.</p>
<p>You should give a battery optimization exception to Google Play services
for features like push notifications to work properly in the background. It
isn't needed for the other 2 apps.</p>
<p>You can obtain updates to these apps from our repository which will be easy
once we have a client app. The Play Store app can also be used to update Google
Play services. Updates to the Google Services Framework (com.google.android.gsf)
app are normally only distributed through OS updates so you need to get those from
our repository. The Play Store app isn't able to update itself through the
compatibility layer yet but it may be supported in the future.</p>
<p>After installing the apps, you should open the Play Store and press sign in
to trigger initialization. Signing into an account is optional and it will
work fine without it, but you do need to get it initialized and this is
currently the best way to mimic the initialization done by the stock OS setup
wizard.</p>
<p>You can obtain updates to these apps from our repository which will be easy
once we have a client app. The Play Store app can also be used to update
Google Play services. Updates to the Google Services Framework
(com.google.android.gsf) app are normally only distributed through OS updates
so you need to get those from our repository. The Play Store app isn't able to
update itself through the compatibility layer yet but it may be supported in
the future.</p>
</section>
<section id="sandboxed-play-services-limitations">
<h3><a href="#sandboxed-play-services-limitations">Limitations</a></h3>