Merge branch '448-add-a-simple-microg-guide' into 'master'

## What is microG

A basic guide to understand all about microG can be found [here](/support-topics/guide-micro-g)

## Development status of microG

The development on microG is an ongoing project. We discuss with its maintainer regularly and also support the microG project financially.

## Introduction

<div class="text-center">

  <img src="/images/microg/microg_logo.jpg" alt="microg logo">

</div>

 

microG is a free and open-source implementation of Google Play Services. It aims to provide a functional replacement for proprietary Google services on Android devices. It allows users to run applications that depend on Google Play Services without having to authenticate with a personal Google user account, thus adding an anonymisation layer between users and the Google Play Services infrastructure.

/e/OS our privacy-focused, open-source mobile operating system comes pre-installed with microG. /e/OS users who want to enjoy using popular mobile applications can do so, while being protected from the data mining of big tech. 

This guide will help you understand the basics of microG and also covers at a high level its integration in the /e/OS. This guide will also share some steps to help you ensure it is set up correctly for optimal functionality.

### Core Component of microG

**GmsCore**: The main framework providing Google Play Services functionalities. GmsCore includes the Unified Network Location Provider module (UnifiedNlp) which handles application calls to Google's network location provider. You can find more details about GmsCore from its [dedicated page on GitHub](https://github.com/microg/GmsCore/wiki) 

### During the OS Setup

As mentioned in the introduction section, /e/OS comes with microG preinstalled. The user does not have to separately install microG on the /e/OS ROM.

1. **First Boot**: When your device first boots into /e/OS, you'll be guided through the initial setup process, including connecting to Wi-Fi, setting up security options, and more.

2. **microG Configuration**: /e/OS comes with microG pre-installed and pre-configured. However, it’s good to check and ensure everything is working correctly. 

1. **microG Setup Validation**

- Tap on the `Settings` icon

<div class="text-center">

<img src="/images/microg/microg_1_settings_icon.png" alt="Main screen of /e/OS">

</div>

 

- Navigate to `System` inside `Settings`

<div class="text-center">

<img src="/images/microg/microg_2_under_settings_system.png" alt="Setting screen">

</div>

    

- Under `System` scroll to `microG`

<div class="text-center">

<img src="/images/microg/microg_3_system_settings.png" alt="System Screen">

</div>

 

- On the `microg` main screen select `Self Check`

<div class="text-center">

<img src="/images/microg/microg_4_microg_services.png" alt="microG Setting screen">

</div>

 

- Ensure that all the check boxes are checked under

     - `Signature Spoofing Support`

     - `Installed packages`

     - `Permissions granted`

     - `System`

     The check boxes are checked by default.

<div class="text-center">

<img src="/images/microg/microg_5_selfcheck.png" alt="microG Self-check screen">

</div>

### Usage

1. **Verifying Functionality**

   - Install an app that depends on Google Play Services (e.g., Google Maps).

   - Open the app and check if it functions correctly without errors related to Google Play Services.

2. **Using Google Account with microG**

   - Open the microG Settings app.

   - Navigate to the Accounts section and add your Google account.

   - Ensure synchronization options are enabled as needed.

## Troubleshooting

1. **App Crashes or Errors**

   - Re-check the microG Self-Check section for any missed configurations.

   - Ensure all necessary permissions are granted.

   - Clear the app cache and data for the affected app.

## Extra benefits of microG

1. **Signature Spoofing**

   - Some apps require signature spoofing to function correctly with microG.

2. **Google Safetynet**

   - Safetynet is a device certification system that ensures the device is properly secured and compatible with Android CTS.

## Conclusion

microG is a powerful tool for users who want to minimize their reliance on proprietary Google services while maintaining app functionality. By following this guide, you can understand more about microG installed on your Android device. For more advanced support and community discussions, consider visiting the microG [GitHub page](https://github.com/microg) or joining relevant forums and discussion groups.

/e/OS is proud to support the development of [microG project](https://microg.org/) since 2020.

 No newline at end of file