3
0
Fork 0

gms: add readme

This commit is contained in:
Akhil Narang 2021-10-21 18:35:21 +05:30 committed by AdarshGrewal
parent afe58dfd6f
commit 089e7c34fe
1 changed files with 33 additions and 0 deletions

33
README.md Normal file
View File

@ -0,0 +1,33 @@
# vendor_gms
## Basic usage
- If you just wanna use this repository, then you just need to include `products/gms.mk`
- This is as simple as: `$(call inherit-product-if-exists, vendor/gms/products/gms.mk)`
## Advanced usage
### Initial setup
- Install `xmlstarlet`
- `sudo apt install xmlstarlet`, `sudo pacman -S xmlstarlet`, etc. depending on your distribution.
- Install `apktool`, make sure its available in PATH
- https://ibotpeaches.github.io/Apktool/install/
- Run `apktool if framework-res.apk` to install framework for apktool this is necessary for proper extracting
(generally found in /system/framework/)
### Extracting / updating extracted overlays
Basically the same as regular extract-files
```sh
./extract-files.sh /path/to/a/dump
```
### Removing certain overlays
- If certain overlays are not required, you can simply add them to `exclude-tag.txt`, those will be removed from the extracted overlays.
### Miscellaneous information
- The main changes here are the addition of `apktool` and `xmlstarlet`, to allow us to extract the necessary overlays from some RROs.
- Since the process does take a while, to speed it up, all extraction is done in the background. This might not be suitable for weaker systems if there is a very high number of overlays to be extracted.