🌟 Wilson Goal's AAB Converter Tool

A powerful, Linux-optimized command-line tool for converting Android App Bundle (.aab) files to APK format with automatic dependency management and user-friendly features.

🚀 Features

🔄 One-Click Conversion - Convert multiple AAB files to APK format instantly
✅ Bundle Validation - Verify AAB file integrity before conversion
📋 File Information - Display detailed AAB bundle metadata
🔧 Auto Dependency Management - Automatically detect and install missing dependencies
💻 Linux Optimized - Built specifically for Ubuntu/Debian systems
🎨 Colored Output - Beautiful, informative terminal output with emojis
📝 Verbose Logging - Detailed progress information and error reporting
🔐 Keystore Support - Custom signing configuration for APK generation
📁 Flexible Output - Custom output directory support

📋 Requirements

System Requirements

OS: Ubuntu/Debian-based Linux distribution
Architecture: x86_64 or ARM64
Internet: Required for bundletool download

Automatic Dependencies

The tool will automatically detect and install:

Java Runtime Environment (JRE 8+)
curl (for downloads)
findutils (file searching)
coreutils (system utilities)
Bundletool (Google's AAB conversion tool)

🛠️ Installation

Quick Start

# Clone the repository
git clone https://github.com/yourusername/apk_builder.git
cd apk_builder

# Make the script executable
chmod +x builder.sh

# Run the script (dependencies will be auto-installed)
./builder.sh

Manual Setup

# Download the script
wget https://raw.githubusercontent.com/yourusername/apk_builder/main/builder.sh

# Make executable
chmod +x builder.sh

# Run
./builder.sh

📖 Usage

Basic Commands

# Interactive conversion (default)
./builder.sh

# Silent conversion (no verbose output)
./builder.sh --quiet

# Batch conversion (non-interactive)
./builder.sh --non-interactive

# Custom output directory
./builder.sh --output ./apks --verbose

# Validate AAB files
./builder.sh validate

# Show AAB file information
./builder.sh info

# Show help
./builder.sh --help

# Show version
./builder.sh --version

Advanced Options

# Custom keystore configuration
./builder.sh --keystore my-key.keystore --alias my-alias --password mypassword

# Different build modes
./builder.sh --mode universal    # Default: single APK for all devices
./builder.sh --mode system       # System-signed APK
./builder.sh --mode persistent   # Persistent APK

# Enable logging to file
./builder.sh --log conversion.log

🎯 Command Reference

Commands

Command	Description
`convert`	Convert AAB files to APKs (default)
`validate`	Validate AAB bundle integrity
`info`	Show detailed AAB file information
`help`	Display help message

Options

Option	Description	Default
`-h, --help`	Show help message
`-v, --verbose`	Enable verbose output	✅ Enabled
`--quiet`	Disable verbose output
`-i, --interactive`	Interactive mode	✅ Enabled
`-n, --non-interactive`	Non-interactive mode
`-o, --output DIR`	Output directory	Current directory
`-k, --keystore PATH`	Keystore file path	`my-release-key.keystore`
`-a, --alias ALIAS`	Keystore alias	`my-key-alias`
`-p, --password PASS`	Keystore password	`123456`
`-m, --mode MODE`	Build mode	`universal`
`-l, --log FILE`	Log output to file
`-V, --version`	Show version information

🔄 Workflow Examples

1. First Time Setup

# Initial run - will detect and install dependencies
./builder.sh

# Output:
# 🔍 Checking Dependencies...
#   • Java Runtime Environment... ✅ Found (11.0.16)
#   • curl... ✅ Found (7.81.0)
#   • find utility... ✅ Found
#   • disk utility (du)... ✅ Found
#   • Bundletool jar... ❌ Missing
# 
# ⚠️  Missing Dependencies Detected:
#   - Bundletool 1.18.2
# 
# 📋 Actions to be taken:
#   - Download Bundletool 1.18.2 from GitHub
# 
# 🤔 Would you like me to automatically install/download these missing dependencies? [y/N]: y
# 
# 🔧 Installing missing dependencies...
# 
# ➤ Processing: Bundletool 1.18.2
# 🌐 Downloading bundletool 1.18.2...
# 📡 URL: https://github.com/google/bundletool/releases/download/1.18.2/bundletool-all-1.18.2.jar
# 💾 Target: ./bundletool-all-1.18.2.jar
# ✅ Download completed (3.2M)
# 
# 🎉 All dependencies installed successfully!

2. Converting Multiple AAB Files

# Place your .aab files in the directory
ls *.aab
# app-release.aab  game-debug.aab  tools-prod.aab

# Convert all files
./builder.sh --output ./converted_apks

# Output:
# 🔍 Checking AAB files...
# 📁 Found 3 AAB file(s):
# -rw-r--r-- 1 user user 12M Oct 28 07:15 app-release.aab
# -rw-r--r-- 1 user user 8.5M Oct 28 07:15 game-debug.aab
# -rw-r--r-- 1 user user 15M Oct 28 07:15 tools-prod.aab
# 
# 📦 Processing: app-release.aab
# 🔄 Converting to ./converted_apks/app-release.apks...
# 🎉 Created: ./converted_apks/app-release.apks
# 
# 📦 Processing: game-debug.aab
# 🔄 Converting to ./converted_apks/game-debug.apks...
# 🎉 Created: ./converted_apks/game-debug.apks
# 
# 📦 Processing: tools-prod.aab
# 🔄 Converting to ./converted_apks/tools-prod.apks...
# 🎉 Created: ./converted_apks/tools-prod.apks
# 
# 🎊 All conversions completed successfully!

3. Validation Mode

./builder.sh validate

# Output:
# 🔍 Checking AAB files for validation...
# 📁 Found 2 AAB file(s):
# 
# 🔍 Validating: app-release.aab
# ✅ Valid AAB: app-release.aab
# Bundle validation successful
# 
# 🔍 Validating: corrupted-bundle.aab
# ❌ Validation failed for corrupted-bundle.aab
# ERROR: Invalid bundle file
# 
# ⚠️  Validation completed with 1 invalid file(s)

🐛 Troubleshooting

Common Issues

1. Permission Denied

chmod +x builder.sh

2. Java Not Found

# The tool will automatically offer to install Java
sudo apt update
sudo apt install -y openjdk-21-jre

3. Bundletool Download Failed

# Check internet connection
curl -I https://github.com/google/bundletool/releases/latest

# Manual download if needed
wget https://github.com/google/bundletool/releases/download/1.18.2/bundletool-all-1.18.2.jar

4. Keystore Issues

# Generate a new keystore
keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
                                                                                    
# Use custom keystore
./builder.sh --keystore my-release-key.keystore --alias my-key-alias --password yourpassword

Error Messages

Error	Cause	Solution
`🚫 No AAB files found`	No .aab files in directory	Place .aab files in current directory
`❌ Java is required`	Java not installed	Allow auto-install or install manually
`❌ Failed to download bundletool`	Network issues	Check internet connection or download manually
`💥 Conversion failed`	Invalid AAB file	Use `validate` command to check file integrity

📁 File Structure

apk_builder/
├── builder.sh           # Main script
├── README.md           # This documentation
├── .gitignore          # Git ignore file
├── examples/           # Example AAB files (optional)
└── logs/              # Log files directory (auto-created)

Generated Files

After conversion, you'll find:

*.apks - APK bundle files (can be installed directly)
conversion.log - Detailed conversion log (if logging enabled)

🔧 Configuration

Environment Variables

# Set custom output directory
export APK_BUILDER_OUTPUT="./my_apks"

# Set custom keystore
export APK_BUILDER_KEYSTORE="./keys/release.keystore"
export APK_BUILDER_ALIAS="release"
export APK_BUILDER_PASSWORD="mypass123"

Default Keystore

The tool includes a default keystore for testing:

File: my-release-key.keystore
Alias: my-key-alias
Password: 123456

⚠️ Warning: Use the default keystore only for testing. Generate your own keystore for production apps.

🤝 Contributing

Fork the repository
Create a feature branch: git checkout -b feature-name
Make your changes and test thoroughly
Commit your changes: git commit -m 'Add feature'
Push to the branch: git push origin feature-name
Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
src		src
.gitignore		.gitignore
README.md		README.md
main.sh		main.sh

Folders and files

Latest commit

History

Repository files navigation

🌟 Wilson Goal's AAB Converter Tool

🚀 Features

📋 Requirements

System Requirements

Automatic Dependencies

🛠️ Installation

Quick Start

Manual Setup

📖 Usage

Basic Commands

Advanced Options

🎯 Command Reference

Commands

Options

🔄 Workflow Examples

1. First Time Setup

2. Converting Multiple AAB Files

3. Validation Mode

🐛 Troubleshooting

Common Issues

1. Permission Denied

2. Java Not Found

3. Bundletool Download Failed

4. Keystore Issues

Error Messages

📁 File Structure

Generated Files

🔧 Configuration

Environment Variables

Default Keystore

🤝 Contributing

📄 License

🙏 Acknowledgments

📞 Support

🔗 Related Links

Created with ❤️ by Wilson Goal - 2025

apk_builder

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages