vendor/opengapps/sources/all/product/overlay/README.md

28 lines
1.1 KiB
Markdown
Raw Normal View History

2025-08-25 08:12:20 +08:00
# OpenGApps overlays
These overlays are required since SDK28 to support some of the Google features like setting the default Dialer or making PixelLauncher work as it dose on Pixel devices.
## Contents
This folder contains both overlay APKs and their sources in the respective folders. You're free to browse them to see what's inside each of the overlay.
## Creation process
The process is pretty basic and includes these 5 steps:
1. Set up the folder structure with the required resources
2. Set up the `AndroidManifest.xml` to target proper Android version
3. Build the overlay's APK file by calling `aapt`:
```shell
aapt p -M AndroidManifest.xml -S res -I $ANDROID_SDK_ROOT/platforms/android-VERSION/android.jar -F overlay.apk.un
```
where:
- `VERSION` is the targeted Android version number (e.g. `30`)
- `.un` suffix stands for **unaligned** (we will zipalign it later)
4. Sign the unaligned APK: `jarsigner -keystore PATH/TO/YOUR/keystore.jks overlay.apk.un YOUR_KEY_NAME`
You'll be asked for the keystore password and the key password, if required
5. Zipalign the APK: `zipalign 4 overlay.apk.un overlay.apk`