nift4 / microg_installer_revived

Install microG GmsCore, GsfProxy, FakeStore (or Play Store if you want so) and MapsV1 to /system/
GNU General Public License v3.0
760 stars 41 forks source link

microG Installer Revived

This is a Magisk module - originally based on Hieu Van's microG Installer - that installs microG GmsCore, GsfProxy and Companion (or Play Store if you want so) to /system/priv-app.

Currently, GmsCore 0.3.2 (including Companion, previously known as FakeStore) and earlier are supported. GsfProxy 0.1.0 and MapsV1 0.1.0 are bundled in the module.

Note: Install this module before installing any GMS-dependent apps, as well as do not disable it after installing such apps, unless you know what you're doing.

There are two copies of this online: The Magisk alt module repo and the personal one. The personal one contains the latest development version and is used for pull requests and issues and the Magisk alt repo one is the stable code only.

Installation

Again, if you have Google services currently installed, DO NOT INSTALL THIS MODULE.

How do I get the real Play Store?

First, if you experience an bootloop, use Magisk Safe Mode to disable the module and use an older Play Store APK, then post a bug report. This module needs to be updated for new Play Store versions every while. If it boots, but Play Store is broken, it's probably a microG issue. Feel free to report issues in the bugtracker here though.

Get an Play Store APK (I suggest unpatched Play Store from APKMirror) - please note that the file has to be a non-bundle APK, which means APKM files are not supported. Then, just install it before flashing the module! If you now install, update or reflash microG Installer Revived there will be an message "Installing real Play Store". This indicates it worked. Now grant all permissions. You can now install updates for the Play Store like for every app.

Note: previously, this module told you to put it into /data/adb/Phonesky.apk. This is no longer needed and the module will ignore that file.

Can I update to new versions without waiting for module updates?

Yes, just download the new APK (in the normal variant, not -hw or -lh) from microG GitHub, download page or microG F-Droid repo (all those use the exact same APK files!) and install it as you always would without reflashing the module. If you use Companion, update it this way too. Please note that some F-Droid clients report signature compatibility issues, which however appears to be a problem with interactions between the microG repo, clients and signature spoofing. In this case, download the APKs using a web browser and install them normally.

Common issues

Build

Linux, BSD, macOS, Android

Requires wget.

wget -O META-INF/com/google/android/update-binary https://raw.githubusercontent.com/topjohnwu/Magisk/master/scripts/module_installer.sh && zip microG_Installer_Revived.zip -9r * -x update.json

Other

Download this and put it into META-INF/com/google/android/update-binary. And ZIP it.

About microGOverlay.apk

This APK file is an simple overlay containing configuration for UnifiedNlp. The source can not be checked in into this git repository because of compatibility reasons with module repositories, so I posted the trivial source code on an extra branch. You can use any signing keystore to sign the overlay, but it needs to be signed.

Credits