Files
Install APKs to a Virtual Device
Install Android apps onto your xCloudPhone virtual devices, either from storage or directly from your computer. Install on one device or many at once.
4 min read
Installing an APK on an xCloudPhone virtual device is the same idea as installing an app on a real phone — you just do it through a browser. Save the APK to Files Manager once and install it on any device fast, or drag it straight from your computer into the viewer when you're in a hurry.
The flow at a glance
Have your APK ready in Files Manager (or on your computer).
Open the viewer for the target virtual device.
Start the install from inside the viewer.
Wait for the device to receive the file, install, and launch the app.
Step 1 — Prepare the APK
If the APK isn't in storage yet, upload it first. See Upload files to your storage. This is the right move when:
- You plan to install this app on many devices.
- You want to keep it around for later use.
- The APK is large — upload once and install across devices without re-uploading.
If it's truly a one-off install on a single device, you can skip uploading and drag the APK straight into the viewer in the step below.
Step 2 — Open the device viewer
Go to app.xcloudphone.com/dashboard/devices, find the device you want to install on, and click to open the viewer. Wait for the viewer to connect and show the device screen.
Before installing, check that the device is running normally — screen on, responsive to touch. If it's frozen or disconnected, restart it first, then install.
Step 3 — Start the install
Inside the viewer, you have two common ways:
Find the Install APK button in the viewer toolbar. Click it and a dialog opens to pick the source:
- From storage — browse Files Manager and pick an APK you've uploaded.
- From your computer — opens your OS file picker so you can pick an APK directly.
Drag an APK file from your computer and drop it onto the viewer window. The system recognizes APKs and kicks off the install flow automatically.
Step 4 — Wait for the install to finish
The APK is transferred to the device (a few seconds to a minute depending on size).
The device runs the install.
When done, the app shows up in the device's app drawer — you can launch it right there in the viewer.
Install on multiple devices at once
When you need the same app on many devices (say, 10 devices for a campaign), you have two paths:
Add all the devices to the Sync Control grid, select them all, then perform the install action — it will be replicated to every selected device simultaneously. See the Sync Control guide for details.
Open the viewer for each device and repeat Step 3. If the APK is already in storage, you don't re-upload — just pick it from storage for each device. Slower but more controlled, good when devices need slightly different setups.
Keep your tested APKs in a dedicated folder (something like Tested-APKs/) in storage. When it's time to roll out to a new batch of devices, you don't have to remember which version was stable — just grab from that folder.
Uninstall an app
Open Android Settings in the viewer → Apps → find the app → Uninstall. This is the standard Android way.
Some control panels offer an Apps Picker dialog listing the apps installed on a device. You can select an app and uninstall directly without going into Settings.
Tips for working with APKs
- Name with versions —
MyApp-v1.2.3.apkrather thanMyApp.apkso you know which build is which. - Test on one device first — make sure the APK behaves before rolling out to a batch.
- Keep stable APKs around — don't delete the moment a new build looks good; you may need to roll back.
- Clean old APKs regularly — once a new build is proven stable over time, clear out the old ones to reclaim storage.
Common issues
Install failed
The APK might be corrupted. Re-download from the source and re-upload.
App won't launch
Could be incompatible with the device's Android version. Check the app's minimum requirements.
Device is full
Uninstall old apps on the device, or clear app data to free space for the new one.
Hangs mid-install
Restart the device and try again.
APKs from unknown sources can carry malware, steal data, or turn your virtual device into a tool for attacks. Only install APKs from trusted sources, or ones you've scanned before adding to storage. Be especially careful with modded APKs, cracked APKs, or anything someone sent you in a chat.