91e75e620b
CI: cua-driver distro-compat matrix / debian:12 (glibc 2.36) (push) Has been cancelled
CI: SPDX Headers / Check SPDX headers (warn-only) (push) Has been cancelled
CD: Docs MCP Server / build (linux/amd64) (push) Has been cancelled
CD: Docs MCP Server / build (linux/arm64) (push) Has been cancelled
CD: Docs MCP Server / merge (push) Has been cancelled
CI: cua-driver distro-compat matrix / Resolve release version (push) Has been cancelled
CI: cua-driver distro-compat matrix / fedora:41 (glibc 2.40) (push) Has been cancelled
CI: cua-driver distro-compat matrix / rockylinux:9 (glibc 2.34) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:22.04 (glibc 2.35) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:24.04 (glibc 2.39) (push) Has been cancelled
CI: cua-driver distro-compat matrix / Distro compat summary (push) Has been cancelled
CI: Rust Linux unit / Rust Linux unit and compile (push) Has been cancelled
CI: Rust Windows unit / Rust Windows unit and compile (push) Has been cancelled
CI: Nix Linux Rust source / Nix / compositor build (push) Has been cancelled
CI: Nix Linux Rust source / Nix / driver package (push) Has been cancelled
CI: Nix Linux Rust source / Nix / Rust unit tests (push) Has been cancelled
72 lines
2.0 KiB
Python
72 lines
2.0 KiB
Python
"""Run a cloud Android VM in Python with the Cua Sandbox SDK.
|
|
|
|
async with Sandbox.ephemeral(Image.android("14")) as sb:
|
|
screenshot = await sb.screenshot()
|
|
await sb.mobile.tap(540, 960)
|
|
|
|
Sandbox.ephemeral() without local=True provisions an Android VM on the Cua cloud.
|
|
Requires CUA_API_KEY environment variable. No Android SDK or emulator needed.
|
|
|
|
The sb.mobile interface provides touch, gesture, and hardware key controls:
|
|
sb.mobile.tap(x, y)
|
|
sb.mobile.swipe(x1, y1, x2, y2, duration_ms=300)
|
|
sb.mobile.home() / sb.mobile.back() / sb.mobile.recents()
|
|
sb.mobile.type_text("hello")
|
|
|
|
Contrast:
|
|
Image.android("14") + local=False -> Cua cloud Android VM (this file)
|
|
Image.android("14") + local=True -> Android SDK emulator on your machine
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import asyncio
|
|
import os
|
|
|
|
import pytest
|
|
from cua_sandbox import Image, Sandbox
|
|
|
|
pytestmark = pytest.mark.asyncio
|
|
|
|
|
|
def _has_cua_api_key() -> bool:
|
|
return bool(os.environ.get("CUA_API_KEY"))
|
|
|
|
|
|
@pytest.mark.skipif(not _has_cua_api_key(), reason="CUA_API_KEY not set")
|
|
async def test_android_cloud_vm():
|
|
async with Sandbox.ephemeral(
|
|
Image.android("14"),
|
|
name="example-android-cloud-vm",
|
|
) as sb:
|
|
screenshot = await sb.screenshot()
|
|
assert screenshot[:4] == b"\x89PNG"
|
|
assert len(screenshot) > 1000
|
|
|
|
w, h = await sb.screen.size()
|
|
assert w > 0 and h > 0
|
|
|
|
await sb.mobile.home()
|
|
|
|
|
|
async def main():
|
|
async with Sandbox.ephemeral(
|
|
Image.android("14"),
|
|
name="example-android-cloud-vm",
|
|
) as sb:
|
|
screenshot = await sb.screenshot()
|
|
print(f"Screenshot: {len(screenshot)} bytes")
|
|
with open("/tmp/android_cloud_vm.png", "wb") as f:
|
|
f.write(screenshot)
|
|
|
|
w, h = await sb.screen.size()
|
|
print(f"Screen size: {w}x{h}")
|
|
|
|
await sb.mobile.tap(w // 2, h // 2)
|
|
await sb.mobile.home()
|
|
print("Tap + home: OK")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
asyncio.run(main())
|