# Android APK Installation Guide

Unlike Apple, Android allows you to **install your app directly in your phone** by using an APK file. You can use this method for you or your team to test your final app without needing to follow the publishing method.

## Install Debug APK on your phone

1. **From your Android device**, download the APK you received in your email, which will look like this:

   <img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgnoxrL_MqLJPfO%2FScreenshot_20200721_154716_com.google.android.gm.jpg?generation=1629369728716643&#x26;alt=media" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d92fb196-548f-4534-8a19-d3a321a98812/Screenshot_20200721_154716_com.google.android.gm.jpg" data-size="original">
2. You might see a warning message, don't worry, it's just a default message for apps downloaded outside of Google Play. Press `Ok` to proceed with the download.

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6a5564a2-4106-48b5-8ec3-34db45e6072b/Screenshot\_20200721\_154731\_com.android.chrome.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-Egojbrv20wEDzZg%2FScreenshot_20200721_154731_com.android.chrome.jpg?generation=1629369728728944\&alt=media)
3. Once the download finishes, click on `Open`**.**

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/79f50727-3ad1-4c82-8bca-4fc57472a6d1/Screenshot\_20200721\_154737\_com.android.chrome.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgpfRmyhtGiHMM8%2FScreenshot_20200721_154737_com.android.chrome.jpg?generation=1629369728706255\&alt=media)
4. \*If you didn't allow installation of unknown apps, you will see the following alert. Proceed to [Step 7](https://www.notion.so/Android-APK-Installation-Guide-93a4ed9d8c394150a0afffcb947c70a3) otherwise.

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/636ec807-35b1-41cd-91d8-37e7807bdb9a/Screenshot\_20200721\_154743\_com.google.android.packageinstaller.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgqYTSfmxZ9B2Fn%2FScreenshot_20200721_154743_com.google.android.packageinstaller.jpg?generation=1629369728711136\&alt=media)
5. Click on **SETTINGS** and enable **Allow app installs** checkbox

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d6a93766-b919-44ca-9490-5d7d5215711e/Screenshot\_20200721\_154755\_com.android.settings.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgrNKN9j4Q3DT5Q%2FScreenshot_20200721_154755_com.android.settings.jpg?generation=1629369728719530\&alt=media)
6. Go back and you should see the install popup now. In case you don't see the below screenshot, locate `app-debug.apk` you downloaded in the previous step and open it. By default, this file will be downloaded into a "Downloads" folder. Use your file explorer preferred app to locate it. If you are not able to find it, you can just download it from Bravo email again

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/f72a26f8-4e4c-4c64-b184-a02e66468485/Screenshot\_20200721\_154810\_com.google.android.packageinstaller.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgscRFTMGRjXxo9%2FScreenshot_20200721_154810_com.google.android.packageinstaller.jpg?generation=1629369728714792\&alt=media)
7. Click on `INSTALL` and wait until the installation completes.

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2783f83f-cb3c-478d-a2e1-7f454b21d50f/Screenshot\_20200721\_155621\_com.google.android.packageinstaller.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgvSQ4yWzCbtYbY%2FScreenshot_20200721_155621_com.google.android.packageinstaller.jpg?generation=1629369728713583\&alt=media)
8. You might see an alert titled **Blocked by Play Protect**. Don't worry, this is just an informative message that appears when trying to install apps outside of Google Play. Click `INSTALL ANYWAY`**.**

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/3adab265-0660-4874-9bb7-9db33379bef9/Screenshot\_20200721\_154944\_com.android.vending.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-Egt89HmEloKwS5J%2FScreenshot_20200721_154944_com.android.vending.jpg?generation=1629369728906172\&alt=media)
9. You might see a popup titled **Send app for scanning?** - Click **SEND** or **DON'T SEND** to close this window, it's irrelevant

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/b43ed91b-5bce-44e5-9090-3bbcf5bfe8a5/Screenshot\_20200721\_154954\_com.android.vending.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EguFZpA5w0qTUwp%2FScreenshot_20200721_154954_com.android.vending.jpg?generation=1629369728762952\&alt=media)
10. Your app has been installed. Click `OPEN` and enjoy!

    ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/1c9a608d-3022-4f4d-a352-bd71bccacdbb/Screenshot\_20200721\_155841\_com.google.android.packageinstaller.jpg](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgwJrl3sy1Zr2oT%2FScreenshot_20200721_155841_com.google.android.packageinstaller.jpg?generation=1629369728818970\&alt=media)

{% hint style="warning" %}
For Android versions below 8.0, you have to enable **Unknown Sources** inside phone settings.
{% endhint %}

1. Go to your phone’s **Settings**.
2. Tap **Security**.
3. Scroll down to the **Device Administration** section, and enable **Unknown Sources**.

## Install Debug APK on Emulator

{% hint style="success" %}
This guide assumes you have an Android Studio installed. Otherwise, please do it before starting: <https://developer.android.com/studio>
{% endhint %}

1. Open **AVD Monitor**, from any of these places, whether or not you have an Android project opened.

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/a41c24ab-3e4f-48d6-905b-67edab5bdad4/Screenshot\_2020-07-21\_at\_16.22.41.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-Eg_KUFpgMRSJQ22%2FScreenshot_2020-07-21_at_16.22.41.png?generation=1629369728909514\&alt=media)

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/8ff3271c-db95-4fdc-a751-bb8135590c1f/Screenshot\_2020-07-21\_at\_16.21.43.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgZ6yv-wihbHgFL%2FScreenshot_2020-07-21_at_16.21.43.png?generation=1629369728644829\&alt=media)
2. Click on `+ Create Virtual Device`

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/bea79c49-ee8d-4f7a-a79e-06dcf067e188/Screenshot\_2020-07-21\_at\_17.04.09.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgmNg0W4E5idIPV%2FScreenshot_2020-07-21_at_17.04.09.png?generation=1629369728722484\&alt=media)
3. Choose a device definition that includes Play Store. For example, **Pixel 3a**. Click `Next`.

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/083fa6c2-537d-4aba-aaf0-c93a95acd37e/Screenshot\_2020-07-21\_at\_16.30.00.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-Egakb4Je_3KNyk-%2FScreenshot_2020-07-21_at_16.30.00.png?generation=1629369728714482\&alt=media)
4. Select a system image of your choice. Make sure is version 7 and up. For example, let's go with **Android Pie**. Click `Next`.

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2c44e47f-7cac-4175-a1eb-ccbd471581e4/Screenshot\_2020-07-21\_at\_16.31.30.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgbPTp_XeTWYP32%2FScreenshot_2020-07-21_at_16.31.30.png?generation=1629369728767088\&alt=media)
5. In the final screen you can change the name of your created emulator, if you wish. Click `Finish`.

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/199b517c-25ef-4c7c-8a8a-b73e04ee9ad4/Screenshot\_2020-07-21\_at\_16.32.23.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgcE2A6j4Vh-lCs%2FScreenshot_2020-07-21_at_16.32.23.png?generation=1629369728752521\&alt=media)
6. Click the green triangle on the right side of your created emulator to launch it

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6f11a3ca-6111-47b6-a096-e037414c2320/Screenshot\_2020-07-21\_at\_16.33.15.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgdTJ7oHhT0dIv5%2FScreenshot_2020-07-21_at_16.33.15.png?generation=1629369728713417\&alt=media)
7. Your emulator is ready to use.

   ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/623d9c3b-a8d8-45be-a766-2d398742fa26/Screenshot\_2020-07-21\_at\_16.34.01.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-Egez0w-Dc1IhnHO%2FScreenshot_2020-07-21_at_16.34.01.png?generation=1629369728969802\&alt=media)
8. The easiest way to install your debug APK is to set up the same email account where you received it, and then download it. Once downloaded, open the file and skip to [step 16](https://www.notion.so/Android-APK-Installation-Guide-93a4ed9d8c394150a0afffcb947c70a3).
9. Another option is by sending the APK file to your emulator. First, download `app-debug.apk` file from your email to your computer.
10. In Android Studio, open **Device File Explorer** (check screenshot, it's located on the bottom right side, placed vertically)

    ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6214234b-5b95-4565-bb52-04ac594c0baf/Screenshot\_2020-07-21\_at\_16.38.08.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgfPp8wG2GtgwMV%2FScreenshot_2020-07-21_at_16.38.08.png?generation=1629369728745976\&alt=media)
11. Go to the folder where you want to place the file, for example, **sdcard/Download** folder. Right-click on it and select `Upload...`

    ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6217bfca-8067-46bf-bdeb-4eb7718cca89/Screenshot\_2020-07-21\_at\_16.41.59.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EggXfCJrfuPrEu4%2FScreenshot_2020-07-21_at_16.41.59.png?generation=1629369728824009\&alt=media)
12. Select the app-debug.apk from your computer, the one downloaded on step 9, and click `Open`**.**
13. APK file should be copied into your emulator

    ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/26f50897-6e2e-4895-ad46-a77fd7fbb13d/Screenshot\_2020-07-21\_at\_16.44.49.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-Eghm5I2FKA1PSk6%2FScreenshot_2020-07-21_at_16.44.49.png?generation=1629369728917149\&alt=media)
14. In your emulator, swipe up from the bottom of the screen and open **Files** app
15. Locate `app-debug.apk` inside **Downloads** folder \*\*\*\*and double click on it.
16. You might see a warning related to installing unknown apps. Click `CONTINUE`.

    ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6ae79dc9-eb4a-4c33-b945-4b5bdca9c9b2/Screenshot\_2020-07-21\_at\_16.49.30.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-Egihr8aj0-yBtjJ%2FScreenshot_2020-07-21_at_16.49.30.png?generation=1629369729019615\&alt=media)
17. Click `INSTALL`

    ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/c2034b90-d569-41d6-bbb4-3301a2d8f4bf/Screenshot\_2020-07-21\_at\_16.50.30.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgjaKHvLqDE9eMa%2FScreenshot_2020-07-21_at_16.50.30.png?generation=1629369728975144\&alt=media)
18. Click `INSTALL ANYWAY` if a **Blocked by Play Protect** popup appears

    ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/a8003d7d-0003-4aee-b9b0-85ce589d49ce/Screenshot\_2020-07-21\_at\_16.50.43.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EgkB9L1UJ72gxWi%2FScreenshot_2020-07-21_at_16.50.43.png?generation=1629369728925383\&alt=media)
19. Your app has been installed in the emulator. Click `OPEN` \*\*\*\*and enjoy!

    ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/3b2329c5-00c2-43b5-a449-6ecb8b3d534a/Screenshot\_2020-07-21\_at\_16.51.23.png](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhSzyjmOORWasH-dQjZ%2F-MhT-EglKc6_e-i3DKBl%2FScreenshot_2020-07-21_at_16.51.23.png?generation=1629369728870797\&alt=media)

## Install Publishable APK

{% hint style="info" %}
You need Android SDK to be able to run **adb install**. Find the steps [here](https://www.notion.so/Android-Publication-Complete-Process-631663c251d84fe4988104b4bc9e8e9b).
{% endhint %}

That's it! 🎉


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bravostudio.app/app-publication/publishing-your-app/android-apk-installation-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
