solana-mobile device - Solana Mobile Docs

Work with Android devices and emulators connected over adb.

device install

Install APKs from local files, directories, or the built-in APK catalog. Run it without arguments to pick from the catalog, which includes tools like the Mobile Wallet Adapter test wallet (fakewallet):

npx solana-mobile@latest device install

pnpm dlx solana-mobile@latest device install

bunx solana-mobile@latest device install

Or pass one or more APK files or directories:

npx solana-mobile@latest device install ./app-release.apk --all

pnpm dlx solana-mobile@latest device install ./app-release.apk --all

bunx solana-mobile@latest device install ./app-release.apk --all

Option	Description
`--all`	Install on every connected device
`--device <serial>`	Target a device serial
`--downgrade`	Allow version downgrades (`adb install -d`)
`--force`	Re-download catalog APKs even when cached
`--grant`	Grant all runtime permissions (`adb install -g`)
`--list`	List the APKs available in the catalog
`-v, --verbose`	Verbose output

device list

List connected devices and emulators:

npx solana-mobile@latest device list

pnpm dlx solana-mobile@latest device list

bunx solana-mobile@latest device list

Option	Description
`--json`	Print a stable JSON report

device open

Open a URL, port, or deep link on a connected device. For localhost URLs with an explicit port, the CLI creates an adb reverse (unless --no-forward is set) so the device can reach servers running on your machine:

npx solana-mobile@latest device open http://localhost:3000

pnpm dlx solana-mobile@latest device open http://localhost:3000

bunx solana-mobile@latest device open http://localhost:3000

Option	Description
`--device <serial>`	Target a device serial
`--no-forward`	Do not create an adb reverse for localhost URLs
`-v, --verbose`	Explain URL and port forwarding decisions

device tune

Apply agent-friendly tweaks to a connected device or emulator — the animations, first-run dialogs, lock screen, and notifications that get in the way of automation. With no target it picks the only connected device, or prompts when several are connected:

npx solana-mobile@latest device tune

pnpm dlx solana-mobile@latest device tune

bunx solana-mobile@latest device tune

Every tweak starts selected in the picker, so Enter applies the lot. Pass -y to skip the picker for unattended runs, and --all to tune every connected device:

npx solana-mobile@latest device tune --all --yes

pnpm dlx solana-mobile@latest device tune --all --yes

bunx solana-mobile@latest device tune --all --yes

Physical devices are accepted as well as emulators. A device or Android version that rejects a tweak — a phone with a screen lock keeps its lock screen, for instance — is reported as skipped instead of failing the run.

Tweaks

Tweak	Description
`animations-off`	Disable window, transition, and animator animations
`autofill-off`	Disable the autofill service and its prompts
`chrome-notifications-off`	Silence Chrome notifications and its permission prompt
`chrome-quiet`	Skip Chrome first-run sign-in and disable the new-tab feed and shortcuts
`keyboard-feedback-off`	Disable touch sounds and haptic feedback
`lockscreen-off`	Disable the lock screen
`provisioning-complete`	Mark device setup and provisioning as complete
`screen-awake`	Keep the screen on while charging and extend the screen timeout
`stylus-handwriting`	Disable stylus handwriting and its onboarding popup
`system-notifications-off`	Silence system, Play Store, and Play services notifications

Options

Option	Description
`--all`	Tune every connected device
`--device <serial>`	Target a device serial
`-y, --yes`	Apply every tweak without prompting

Code samples on this page are subject to the Apache 2.0 license.

​device install

​device list

​device open

​device tune

​Tweaks

​Options