> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rork.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to test Android apps on your Android device

> Creating an Android .APK with Rork to install and test your app on an Android phone.

export const CtaBanner = () => <div style={{
  display: "flex",
  alignItems: "center",
  justifyContent: "space-between",
  gap: "24px",
  flexWrap: "wrap",
  margin: "40px 0 8px",
  padding: "22px 28px",
  borderRadius: "16px",
  background: "linear-gradient(135deg,rgba(249,115,22,0.10),rgba(255,255,255,0.03),rgba(249,115,22,0.06))",
  border: "1px solid rgba(255,255,255,0.08)"
}}>
    <div>
      <div style={{
  fontSize: "19px",
  fontWeight: 700,
  color: "#fff",
  letterSpacing: "-0.3px",
  lineHeight: 1.3
}}>
        Build your app with Rork today.
      </div>
      <div style={{
  fontSize: "14px",
  color: "rgba(255,255,255,0.6)",
  marginTop: "4px",
  lineHeight: 1.5
}}>
        Ship iOS, Android, and web apps by chatting with AI.
      </div>
    </div>
    <a href="https://rork.com" style={{
  flexShrink: 0,
  display: "inline-block",
  padding: "10px 24px",
  background: "linear-gradient(135deg,#fff,#f0f0f0)",
  color: "#000",
  fontSize: "14px",
  fontWeight: 600,
  borderRadius: "100px",
  textDecoration: "none",
  whiteSpace: "nowrap"
}}>
      Try Rork for Free
    </a>
  </div>;

If you are adding third-party libraries or modules that are outside of Expo Go, you need to use a development build. This development build will allow you to test and make changes on a physical phone with access to native modules and libraries that Expo Go doesn’t support.

**Prerequisites**

You must do this from a desktop/laptop, not the Rork phone app.

Create a free account on [expo.dev](http://expo.dev). If you need to signup go to [https://expo.dev/signup](https://expo.dev/signup)

Print this out or have it up on another screen, as you will want to do this quickly without leaving the terminal or risk having the Rork sandbox reset, and you will have to start over.

Go to your app in Rork and click the brackets icon at the top of the page (next to the preview button) to open the code editor.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/1apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=50f0f31c4e7928963e0ee3eccf8234ed" alt="1apk" width="1068" height="156" data-path="images/apk/1apk.png" />

Next, you should see the code editor. Look at the bottom of the screen and locate the new terminal button.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/2apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=10298c3035a9bf2c6e5ad997372b77c0" alt="2apk" width="1066" height="1148" data-path="images/apk/2apk.png" />

Click the new terminal button to open a terminal screen. Type bun expo install expo-dev-client and hit enter.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/3apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=9a8a96c89ae4583d103790b6602a4f1c" alt="3apk" width="1074" height="310" data-path="images/apk/3apk.png" />

Once that completes, you should get the following:

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/4apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=c614cbd622f597753e79bee221ed7c31" alt="4apk" width="1074" height="378" data-path="images/apk/4apk.png" />

Next type eas init

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/5apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=509ac1c1df3bb0756c23ace8916a2c19" alt="5apk" width="1084" height="152" data-path="images/apk/5apk.png" />

This will bring you a prompt that is asking you for your [expo.dev](http://expo.dev) account that you created earlier. Enter your email and password for [expo.dev](http://expo.dev). If it asks you if you want to link your project type Y.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/6apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=4c827358c02a35325796dc6d49b90294" alt="6apk" width="1062" height="332" data-path="images/apk/6apk.png" />

Next type eas build:configure

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/7apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=2c9e728d84a278c99a3a2d4988e1a5b1" alt="7apk" width="1070" height="228" data-path="images/apk/7apk.png" />

You should get a message like this that asks you if you want Expo to run git init. Select Yes by entering Y on your keyboard.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/8apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=22bbac80971f31429c18e4c009f8ebe9" alt="8apk" width="1068" height="354" data-path="images/apk/8apk.png" />

Enter the email address that you used for your [expo.dev](http://expo.dev) account for the user name and email address.

You can just hit the enter key for the commit message.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/9apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=c2dcad78d348794d837c195a77e6c24e" alt="9apk" width="1054" height="350" data-path="images/apk/9apk.png" />

Next, you should be asked to select which platform you want to build for. Select Android.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/10.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=c793aad64641107f3170562c092ef440" alt="10" width="1084" height="118" data-path="images/apk/10.png" />

Now we'll run the command to start building the .APK file. Copy and paste the command below—it's long and may appear jumbled in the terminal, so cut and paste to ensure accuracy.

```
eas build --platform android  --profile development 
```

Once this command is entered, it will start the build process on [expo.dev](http://expo.dev). You should get a URL to your Expo dashboard that will show you the build process of your APK file. Depending on how busy the Expo dev servers are, this can take a while.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/11.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=d818404eac718c898e1f51213cc78331" alt="11" width="1070" height="458" data-path="images/apk/11.png" />

Navigate to the Expo log URL provided in the terminal, which will take you to your Expo dashboard. Once your build is finished, you should see an install button.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/12apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=a6318ece26802f8d925350c6ff0ab882" alt="12apk" width="1068" height="586" data-path="images/apk/12apk.png" />

Click the "Install" button and use your phone to scan the QR code. If you are unable to scan the QR code, you can use the URL at the bottom of the screen to download the APK file. Download the file to your phone, but don’t open or install it yet. The image below is what you should see when clicking on the blue install button shown above.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/13appk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=cd73082660d0492cb8c9237a8c45ba26" alt="13appk" width="1088" height="1082" data-path="images/apk/13appk.png" />

Now we will go back to our Rork code editor screen and select the terminal window called App Preview at the bottom of the screen. You may need to scroll up a bit in the terminal, but you should see a QR code and a menu like the image below.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/14apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=e92191f6dd6967876ff21bc50c5333e7" alt="14apk" width="1078" height="1124" data-path="images/apk/14apk.png" />

Check whether you're currently running Expo Go or Development mode. The image above shows Expo Go on the fourth line. If it says "Using Development build," skip the next step. If it says "Expo Go," click into the terminal screen and press the S key. This will switch the metro bundler to Development mode (if it doesn't work, you may need to reinstall the dev client). You should now see that the metro bundler is in Development build mode.

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/15apk.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=accb5965a765aac93e6d6d411bf0f7a4" alt="15apk" width="1070" height="1050" data-path="images/apk/15apk.png" />

On your phone, double-click on the .APK file that you downloaded and install it. If the development server is running, it should start bundling your app and then open it just like using Expo Go. If the development server is not running, you will see the following:

<img src="https://mintcdn.com/rork/M6ZDcDALtfZUeC0M/images/apk/16.png?fit=max&auto=format&n=M6ZDcDALtfZUeC0M&q=85&s=2d07a7aae45de53fa2bfc5df7f4ab65a" alt="16" width="570" height="1244" data-path="images/apk/16.png" />

Start the development server in Rork and then select Scan QR Code. Scan the QR Code, and that should load your app, and you should be up and running.

<CtaBanner />
