README.md

Introduction

NikGapps provides custom GApps packages tailored to individual needs, offering full configurability to install exactly the set of Google apps you want. Available in six variants, NikGapps is a unique GApps solution built from scratch to meet the needs of Android users.

Features

• Android Go Support: Ideal for low-end devices, ensuring smooth performance.
• Custom Architecture: Installs GApps in /product and /system_ext partitions, with fallback to /system if space is limited.
• Full Control: Use nikgapps.config for installation preferences and debloater.config to remove unwanted components.
• Compatibility: Dirty flash support, and can be installed over ROMs with GApps (excluding Pixel-flavored ROMs).
• Addons: Includes useful addon packages, so you don't have to flash the entire GApps package for a single app.
• Addon.d Support: Custom addon.d script allows selective backup and restore of apps during dirty flashes.
• Battery Optimization: Optimize Google Play Services by turning off "Find My Device" (requires ROM support).
• Privileged Permissions: Ensures privileged apps get necessary permissions without disabling Privileged Permission Whitelisting.

Build NikGapps Yourself

Prerequisites

Ensure you have the following tools installed:

• Linux/MacOS: sudo apt-get install -y --no-install-recommends python3 python3-pip aapt git git-lfs apktool
• Windows: Python3, Git, and AAPT.

Steps

1. Configure git user name and email to make Git LFS to work

   git config --global user.name "Example"
   git config --global user.email "[email protected]"
   

2. Set Up the Environment:

   mkdir nikgapps
   cd nikgapps
   

3. Create a virtual environment

   Use python on Linux/MacOS and python3 on Windows (you can figure out which command works for you by running python --version or python3 --version in cmd line)

   • On Linux/MacOS:

     python3 -m venv myvenv
     source myvenv\Scripts\activate
     

   • On Windows:

     python -m venv myvenv
     myvenv\Scripts\activate
     

4. Install builder from pip

   python3 -m pip install NikGapps
   

5. You can now build given gapps variant

   nikgapps --androidVersion (Android Version) --packageList (gapps variant)

   Example:

   nikgapps --androidVersion 13 --packageList basic
   

Your gapps package will be in Releases directory above nikgapps directory

Total Downloads