How to Install Android App Bundles: A Step-by-Step Guide

This guide explains how to install an Android App Bundle (AAB) on your device. App Bundles are the publishing format used by Google Play, but they are not directly installable—they need to be converted to an APK first. Here, you’ll learn the two main methods: using Google’s official bundletool command-line tool, or using an online converter. You’ll need a computer (Windows, macOS, or Linux) and a USB cable or a way to transfer files to your phone.

What You’ll Need

An Android App Bundle file (usually ends in .aab)
A computer with Java installed (for bundletool)
Android Debug Bridge (ADB) installed on your computer (for installing the APK)
A USB cable to connect your Android device, or a file transfer method (like cloud storage)
Enable “Developer options” and “USB debugging” on your Android device

Step-by-Step

Method 1: Using bundletool (Recommended)

Download bundletool: Go to the official Google bundletool releases page on GitHub and download the latest .jar file (e.g., bundletool-all-1.15.6.jar).
Install Java: If you don’t have Java installed, download and install the Java Runtime Environment (JRE) from a trusted source like Oracle or OpenJDK. Verify by running java -version in a terminal.
Open a terminal/command prompt: Navigate to the folder where you saved the bundletool jar and your .aab file.
Generate a universal APK: Run the command:
java -jar bundletool-all-1.15.6.jar build-apks --bundle=your-app.aab --output=app.apks --mode=universal
Replace your-app.aab with your actual file name. This creates a file named app.apks (which is actually a zip archive).
Extract the APK: Rename app.apks to app.zip and extract it. Inside, you’ll find a file named universal.apk.
Install the APK on your device: Connect your Android device via USB, enable USB debugging, and run:
adb install universal.apk
Alternatively, copy the universal.apk to your phone and open it with a file manager (you may need to allow “Install unknown apps”).

Method 2: Using an Online Converter

Find a reputable online converter: Search for “AAB to APK converter” in your browser. Choose a site that seems trustworthy and doesn’t ask for unnecessary permissions.
Upload your .aab file: Follow the website’s instructions to upload your App Bundle.
Download the converted APK: The site will generate a universal APK. Download it to your computer.
Transfer and install: Move the APK to your Android device and install it as you would any APK (open the file and allow unknown sources if prompted).

Common Mistakes

Forgetting to enable USB debugging: ADB will not recognize your device if USB debugging is off. Go to Settings > About phone and tap “Build number” 7 times to unlock Developer options, then enable USB debugging.
Using the wrong Java version: bundletool requires Java 8 or higher. If you get a “UnsupportedClassVersionError”, update Java.
Not extracting the .apks file correctly: The output of bundletool is a zip archive. If you try to install it directly, it will fail. Always extract it first.
Installing a split APK instead of universal: If you don’t use --mode=universal, bundletool generates multiple APKs for different device configurations. Installing just one of them will likely fail. Always use universal mode for a single installable APK.
Signing issues: If the app was signed with a different key than what’s on your device, installation may fail. This is common when testing pre-release builds. You may need to uninstall the existing app first.

Tips

Use the universal APK for testing: Universal APKs work on all devices, but they are larger. For performance testing, consider generating device-specific APKs with --mode=system or --mode=default.
Keep bundletool updated: Google regularly updates bundletool to support new Android versions. Always download the latest version.
Check the app’s signature: If the app is already installed on your device, ensure the signature matches. You can check with apksigner verify (part of Android SDK tools).
Use a file manager with APK support: Some file managers (like Solid Explorer) have built-in APK installers that make the process smoother.

Troubleshooting

“Error: Could not find or load main class” – This means Java is not installed or not in your PATH. Reinstall Java and ensure the java command works in your terminal.

“Device not found” when running adb – Check that USB debugging is enabled, try a different USB port, and run adb devices to see if your device appears. If not, install the proper USB drivers for your device.

“INSTALL_FAILED_UPDATE_INCOMPATIBLE” – This means the app you’re installing has a different signature than the one already installed. Uninstall the existing app first, then install the new APK.

“App not installed” error on phone – This often happens when the APK is corrupted or the device doesn’t allow unknown sources. Go to Settings > Security and enable “Unknown sources” (or “Install unknown apps”) for your file manager or browser.

Online converter fails – Some converters have file size limits or require a login. Try a different converter or use bundletool instead.

Frequently Asked Questions

Can I install an .aab file directly on my phone?

No, Android devices cannot install .aab files directly. They must be converted to an APK first, as described above.

What is the difference between an APK and an AAB?

An APK is the final installable package. An AAB is a publishing format that contains all the code and resources, which Google Play uses to generate optimized APKs for each device.

Will the app receive updates if I install it this way?

No, apps installed manually via APK do not receive updates from the Play Store. You’ll need to manually install new versions.

Is it safe to use an online AAB to APK converter?

It can be risky because you’re uploading your app file to a third-party service. Use only reputable sites, and consider the security implications for proprietary code.

Can I install an AAB on an emulator?

Yes, you can use the same bundletool method to generate a universal APK and install it on an emulator using adb.

Do I need to root my device to install an AAB?

No, rooting is not required. You just need to allow installation from unknown sources.

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →