microG Mobile Services

Note to maintainers: This is a collection of FOSS APKs, coupled with the respective Makefiles for an easy integration in the Android build system.

To include them in your build, add a repo manifest file to include this repository as vendor/partner_gms and set WITH_GMS to true when building.

Example manifest:

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
    <project path="vendor/partner_gms" name="lineageos4microg/android_vendor_partner_gms" remote="github" revision="master" />
</manifest>

Note 1. You do not need to set CUSTOM_PACKAGES for the packages to be included when building with our Docker engine. LineageOS did not make those changes in the 17.1 branch, so to make a 17.1 build, you will need to apply the changes to AndroidManifest.xml and strings.xml from the Android Q LOS 17.1 branch-specific patch. You do not need to apply the other changes in that patch. (See this issue, and all it's comments for more information about this)

Note 2. LineageOS now support restricted signature spoofing, in 18.1 and later branches, so it is no longer neccessary to patch their sources, unless you want unrestricted signature spoofing For the microG packages to work, signature spoofing must be enabled, by patching the LineageOS sources before building.

• If you are building with our Docker engine, this is done automatically according to the values of the SIGNATURE_SPOOFING variable - see here. By default, this variable is set to restricted, allowing only system apps (those built-in to the ROM) to 'spoof' the signature of another app.
• If you are building manually, you can download and include the patches from here. If you follow the microG patching instructions, you ROM will allow any app, not only system apps, to spoof app signatures. To apply only 'restricted' signature spoofing, you should do something similar to what the Docker engine build.sh does in this code.

---

The included APKs are:

• FDroid packages (binaries are sourced from here)
  • FDroid: a catalogue of FOSS (Free and Open Source Software) applications for the Android platform
  • additional_repos.xml: a simple package to include the microG F-Droid repository and the guardian FDroid-repo in the ROM (requires FDroid >= 1.5)
• microG packages (binaries sourced from here)
  • GmsCore: the main component of microG, a FOSS reimplementation of the Google Play Services (requires FakeStore - for full functionality)
  • FakeStore: an empty package that mocks the existence of the Google Play Store

These are official unmodified prebuilt binaries, signed by the corresponding developers.