- What nikgapps.config is and how it works
- List of nikgapps.config location preferences
- How to setup nikgapps.config for first time users
- Understanding nikgapps.config and using it to configure your installation
- How to control addon.d execution with NikGapps
- Introduction to InstallPartition config
Ever since the aroma installer started to be incompatible with newer versions of recovery, the convenience of customizing the installation has been almost impossible for the users. nikgapps.config offers a solution to the same problem so you can completely control the installation as per your needs. You can choose which package to install, which package to skip, which package to replace corresponding AOSP app with google app, which partition to install the gapps in. Keep reading if you’re looking for a way to setup your own custom variant of google apps.
What nikgapps.config is and how it works
nikgapps.config is a configuration file which allows you to completely configure your installation. It also allows you to create custom gapps builds (more on that later)
Any NikGapps package that you flash reads a config file named
nikgapps.config which is located inside
/sdcard/NikGapps folder to perform the installation. To make it convenient for users,
nikgapps.config can also be located at different locations, the location preference is listed below.
List of nikgapps.config location preferences
Following are the list of locations preferred in ascending order which means if the config file is present in two locations
/sdcard1/nikgapps.config the one from
/tmp will be picked up.
- “$ZIPDIR/nikgapps.config” where ZIPDIR is the directory NikGapps package is located
If the installer doesn’t find nikgapps.config, it automatically creates the file for you so you can configure it the way you want.
How to setup nikgapps.config for first time users
You can download nikgapps.config from here and place it in
/sdcard/NikGapps folder (you can create this folder manually) and then start configuring. Alternatively, you can also extract nikgapps.config from the gapps zip and place it in
Understanding nikgapps.config and using it to configure your installation
nikgapps.config is a LF based (more info on LF here) configuration file. By editing nikgapps.config, you can skip any Package that you don’t want to be part of your installation.
nikgapps.config is built with list of AppSets, Packages and comments.
All the lines starting with # are comments. All the lines starting with
>> are Packages inside of AppSet above them.
SetupWizard is an
AppSet that contains set of Apps that are combined to define a Package. Skipping an AppSet skips all the packages that defines an AppSet.
SetupWizard=0 >>SetupWizard=1 >>GoogleRestore=1 >>GoogleOneTimeInitializer=1
NikGapps installer skips the commented lines and reads the uncommented lines to performs the installation based on the config value.
NikGapps installer recognizes 4 config values for every package that it installs.
|-1||Uninstall the package|
|0||Skip the package|
|1||Install the package and delete corresponding aosp app|
|2||Install the package and do not delete corresponding aosp app|
In addition to controlling how individual package behaves, you can also control how the installer behaves.
nikgapps.config allows you to control which partiton you want to install your gapps in (handy when you’re storage space for system or product partition is full), whether or not you want to wipe dalvik/cache during your installation and simply uninstall a package that you accidentally installed.
First things first, let’s find out how to skip installing a package or a set of apps also called
How to skip installing a Package/AppSet
For instance, if you want to skip installing
Google Contacts, all you need to do is open nikgapps.config and find an entry of Google Contacts (usually the spaces are trimmed and the entry you will find will be GoogleContacts). In order to skip installing the package, the config should read
<Name>=0 ; where
<Name> is package name. Which means, in our case
How to remove AOSP counterpart of google app you’re installing
If you want to install GoogleContacts and remove Aosp Contacts, config should read
GoogleContacts=1. This is the default setting and unless you want to keep the aosp counterpart, you don’t need to make any changes. Flash the gapps package after setting the config value.
How to keep AOSP counterpart of google app you’re installing
If you want to install GoogleContacts and keep Aosp Contacts, config should read
GoogleContacts=2 before you flash gapps or addon package.
How to remove installed AppSet/Package or Addon
Often, we run into issues after installing a particular google app and wish there was an easy way to uninstall them. Well there is! if for any reason, you wish to uninstall the installed package, there are two ways you can do it
If you don’t want AOSP counterpart back
- Edit nikgapps.config and set
=-1 (e.g. GoogleContacts=-1)
- Reflash the zip you flashed in first place to install the addon (for e.g. basic package since it contains GoogleContacts or GoogleContacts addon)
If you want AOSP counterpack back
- Uninstall any playstore updates you have for the addon
- Delete the <50-addon>.sh file from /system/addon.d folder (e.g. 50-GoogleContacts.sh)
- Reflash the rom
How to control addon.d execution with NikGapps
nikgapps.config comes with 2 more config entries that allows you to control the addon.d execution.
|execute.d||1 (enabled by default), set to 0 if you want the installer to skip restoring NikGapps upon dirty flashing the rom|
|addon_version.d||3 (by default which comes with mounting partitions), set to 2 if 3 doesn't work for you|
Introduction to InstallPartition config
InstallPartition, as the name suggests defines the partition you’d like to install gapps to. Often we come across situation where the available space in our device in
/system_ext space is so less that Gapps are not fully installed in your device. NikGapps now comes with a flexibility to install gapps to your desired partition.
NikGapps installer reads
InstallPartition config from nikgapps.config file which by default is set to
default value. Which means, nikgapps installer will install gapps to appropriate partition depending on the android version you’re installing on.
if you want to install the gapps in any partition, set the config value to
<partition> is your desired partition. For e.g.
if you specifically want to install the gapps in
/system partition, set below config value to
if you want to install the gapps in
/product partition, set the config value to
Similarly, if you want to install the gapps in
/system/product partition, set the config value to