restructure readme, important stuff on top
1 file changed
tree: 0924f2075d97cc4034ebf7cee9dee93c592d6ce5
  1. additional_repos.xml/
  2. com.google.android.maps/
  3. FakeStore/
  4. FDroid/
  5. FDroidPrivilegedExtension/
  6. GmsCore/
  7. GsfProxy/
  8. MozillaNlpBackend/
  9. NominatimNlpBackend/
  10. products/
  11. README.md
README.md

microG Mobile Services

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>

The included APKs are:

  • FDroid packages (binaries sourced from here and here)
    • FDroid: a catalogue of FOSS (Free and Open Source Software) applications for the Android platform
    • FDroid Privileged Extension: a FDroid extension to ease the installation/removal of apps
    • additional_repos.xml: a simple package to include the microG FDroid repository in the ROM (requires FDroid >= 1.5)
  • microG packages (binaries sourced from here and here)
    • GmsCore: the main component of microG, a FOSS reimplementation of the Google Play Services (requires GsfProxy and FakeStore for full functionality)
    • GsfProxy: a GmsCore proxy for legacy GCM compatibility
    • FakeStore: an empty package that mocks the existence of the Google Play Store
    • com.google.android.maps: legacy microG's mapsv1 reimplementation

These are official unmodified prebuilt binaries, signed by the corresponding developers, except for:

  • com.google.android.maps, as the JAR and the XML have been extracted from the ZIP on the microG's GitHub release page
  • additional_repos.xml, to include the microG repository in FDroid