Here is a README.md and a repository description you can use:

---

📘 README.md

APK Builder

A powerful and flexible Python-based tool to rebuild APKs from unpacked or apktool-decoded folders. Supports rebuilding, aligning, and signing APKs using either the apktool build process or a raw ZIP reconstruction method.

This tool is ideal for developers, reverse engineers, and Android modders who need a clean and automated workflow for rebuilding modified APKs.

---

🚀 Features

• ✔️ Build APKs using apktool (if apktool.yml is present)
• ✔️ Build APKs using raw ZIP method (for simple unpacked APK folders)
• ✔️ Automatically generates a keystore if none is provided
• ✔️ Supports zipalign optimization
• ✔️ Supports apksigner signing
• ✔️ Verbose output and fallback build attempts
• ✔️ Supports unsigned/unaligned output for advanced workflows

📦 Installation

git clone https://github.com/N1LL404/Build-Android-App
cd Build-Android-App

Run:

python3 build_apk.py -h

---

📂 Usage

Basic Build

python build_apk.py -i ./unpacked_app -o rebuilt.apk

Build apktool-decoded project

python build_apk.py -i ./decoded_app -o rebuilt.apk

Use custom keystore

python build_apk.py -i ./app -o app_signed.apk --keystore my.keystore --keyalias mykey --storepass pass123

Skip signing

python build_apk.py -i ./app -o unsigned.apk --no-sign

Skip zipalign

python build_apk.py -i ./app -o noalign.apk --no-align

Force raw ZIP build

python build_apk.py -i ./app_folder -o rebuilt.apk --force-zip

---

📁 Output

The script produces:

• output.apk (default output)
• Temporary build files in apk_build_temp (automatically cleaned)

---

📝 Notes

• If apktool.yml is detected and --force-zip is not used, apktool mode is enabled automatically.
• Signing uses a temporary keystore unless a custom one is supplied.
• Raw ZIP builds skip resource compilation and are suitable for simple modifications only.

🧑‍💻 Author

Created to simplify APK rebuilding for developers and reverse engineers.