[APP] microG GmsCore - FLOSS Play Services compatible framework

WIP, Come back later!

Introduction
microG GmsCore is a FLOSS (Free/Libre Open Source Software) framework to allow applications designed for Google Play Services to run on systems, where Play Services is not available. If you use your phone without GAPPS this might become a useful tool for you.
microG GmsCore is one of the two core components of the microG project.

Instructions
Preparation:

1. You ROM needs to be GAPPS-free. Either don't install them or remove them, if your ROM ships them. Please note that microG GmsCore might run on a cleaned stock ROM, but it might also brick it or cause random bugs.


2. You need a ROM that supports signature faking. Some custom ROMs are patched to support signature faking out of the box, including all OmniROM-based ones. CyanogenMod inclusion is in review. Please ask your ROM developer if unsure.
   If you are a ROM developer or just do custom builds for whatever reason, you can download and include the patch from here.
   If your ROM does not support signature faking, but you use Xposed, you can grab a Xposed module here. Note however that this is not the preferred way to go.


3. Remove UnifiedNlp. In case you installed it before. You can keep your backend modules installed, microG Services will be able to use them later and provide the same feature set (to be precise, microG Services includes UnifiedNlp.

Installation:
The installation does not require any modification of the /system partition. All installations should be done using the default app installer included with Android or using `adb install`. This means you need to enable third-party sources or developer mode first.

1. Install GmsCore.apk as provided in the download section below.


2. If you want to use Google Cloud Messaging ("Push-Notifications"), Install GsfProxy.apk as provided in the download section below. The GsfProxy version does not need to match the GmsCore.apk version.


3. 1. If you have BlankStore installed, continue with the next step.
   
   
   2. If you want to be able to access the Play Store, install BlankStore from its thread. It is not a requirement that you set it up correctly and this is not covered by this instructions. If you need help ask in the original thread.
   
   
   3. If you don't care about Play Store access, Install FakeStore.apk as provided in the download section below.
   
   


4. Open the microG Settings, which are available in the launcher now. If you want to use any Google services (Log-In, Cloud Messaging), tick both checkboxes for background services. This is the only supported setup, but you are free to disable them if you like playing with fire. You can also open the UnifiedNlp settings to enable the location backends of your choice. If you don't have any yet, check out F-Droid. For further questions and concerns regarding UnifiedNlp, use its corresponding thread.


5. Reboot your device. If you skip this step, everything unwanted is possible.

Using it:

• You can test Google Cloud Messaging using this test application. Push notifications do not require account registration.


• You can add an account through the system settings. Some applications might ask you to do so, if you don't.


• Use your applications as you like. Some hint of applications that can run due to microG GmsCore: TextSecure/Signal, Play Music, YouTube

XDA:DevDB Information
microG GmsCore, App for all devices (see above for details)

Contributors
MaR-V-iN
Source Code: https://github.com/microg/android_packages_apps_GmsCore


Version Information
Status: Alpha
Current Beta Version: v0.01
Beta Release Date: 2015-10-04

Created 2015-10-04
Last Updated 2015-10-04