html2app docs

    Installing Your Android APK

    Congratulations on building your app! Since you've downloaded your APK from html2app.dev, you're just a few taps away from seeing your project live on your Android device.

    How to Install Your Android APK

    Installing an APK (Android Package) is a bit different from the Play Store, but it's very straightforward. Follow these three steps:

    1. Download: Locate the APK file in your Android device's Downloads folder or notification bar.
    2. Enable Permissions: When you tap the file, Android may ask for permission to "Install Unknown Apps." Tap Settings in the popup and toggle the switch to Allow from this source.
    3. Launch: Return to the installation screen and tap Install. Once finished, tap Open to launch your app!

    Dealing with "Google Play Protect" Warnings

    During installation of your APK, you might see a scary-looking "Blocked by Play Protect" or "Unsafe App Blocked" warning.

    Why is this happening?

    Because your build is a custom build and hasn't been published to the Google Play Store yet, Google's automated systems don't "recognize" it.

    How to proceed

    1. Tap "More Details" (usually a small dropdown arrow).
    2. Select "Install Anyway."
    3. If prompted to "Send app for scanning," you can select "Don't Send" to speed up the process.

    Troubleshooting: "App Not Installed"

    If you see a vague "App not installed" error, don't worry—your APK file isn't broken! This is almost always caused by a Package Conflict.

    The Cause

    Android won't allow two different apps to share the same Bundle ID (e.g., com.yourname.myapp) unless the new one is a direct "upgrade." This commonly happens when you're installing a new version over an existing app.

    The Fix

    • Uninstall the old version: If you previously installed a version of this app on your Android device, delete it from your phone entirely before installing the new APK.
    • Check the Build Number: If you want to install the APK over the old version without deleting it, you must ensure the Build Number in your html2app settings is higher than the one currently on your phone.