API ReferencePythonMobile
Mobile
Android automation over adb — no Appium, no separate driver server. Reached through the mobile singleton; iOS has no runtime yet.
mobile.android.connect
Connects to a device or emulator over adb (by serial, or the first one available) and returns a device handle.
def connect(self, options: MobileAndroidConnectOptions | None = None) -> AndroidDeviceExample
from allwright import mobile
device = mobile.android.connect(MobileAndroidConnectOptions(device="emulator-5554"))AndroidDevice.launch
Installs (from a local APK path or a URL) and launches an app, resolving the package from app_id or the APK's own metadata.
def launch(self, options: MobileAndroidLaunchOptions | None = None) -> AndroidAppExample
app = device.launch(MobileAndroidLaunchOptions(app_id="com.example.airticket"))AndroidApp.click
Taps the matching element.
def click(self, selector: str, options: CommandOptions | None = None) -> ClickResultExample
app.click("Id=com.example.airticket:id/bottom_nav_account")AndroidApp.fill
Sets a matching field's value.
def fill(self, selector: str, value: str, options: CommandOptions | None = None) -> FillResultAndroidApp.focus / press
Focuses a matching element, or sends it a key event.
def focus(self, selector: str, options: CommandOptions | None = None) -> ElementResult
def press(self, selector: str, key: str, options: PressOptions | None = None) -> PressResultAndroidApp.count
Counts matching elements.
def count(self, selector: str, options: CommandOptions | None = None) -> CountResultAndroidApp.text_content / inner_text
Reads text from a matching element.
def text_content(self, selector: str, options: CommandOptions | None = None) -> TextResultAndroidApp.wait_for_selector
Waits, retrying, for an element to appear.
def wait_for_selector(self, selector: str, options: WaitForSelectorOptions | None = None) -> WaitForSelectorResultAndroidApp.screenshot
Captures the app UI as a PNG; a full-page capture stitches several scrolled captures into one image.
def screenshot(self, options: ScreenshotOptions | None = None) -> ScreenshotResultAndroidApp.accessibility_snapshot
Captures a structured accessibility snapshot of the app UI — the same versioned JSON/YAML document shape as the web surface's snapshot.
def accessibility_snapshot(self, options: AccessibilitySnapshotOptions | None = None) -> strAndroidApp.locator
Builds a chainable locator scoped to the app. Android has no get_by_role-style semantic builders — only raw CSS/XPath/UiAutomator selectors.
def locator(self, selector: str) -> AndroidLocator