Skip to main content

uiautodev

codecov PyPI version

https://web.uiauto.dev

In China visit: https://uiauto.devsleep.com

UI Inspector for Android, iOS and Harmony help inspector element properties, and auto generate XPath, script.

Install

pip install uiautodev

# or with Harmony support
pip install "uiautodev[harmony]"
# ref
# https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hypium-python-guidelines

Usage

Usage: uiauto.dev [OPTIONS] COMMAND [ARGS]...

Options:
  -v, --verbose  verbose mode
  --debug        enable debug output
  --version TEXT server binary version (default: latest)
  -f, --force    force re-download even if cached
  -h, --help     Show this message and exit.

Commands:
  run          download (if needed) and run the server binary [Default]
  download     download the server binary only and print its path
  path         print the path to the server binary without downloading
  server       start uiauto.dev local server (deprecated)
  self-update  Update uiautodev to latest version
  version      Print version
  shutdown     Shutdown server (deprecated)
# download the latest server binary and run it (opens the browser)
uiauto.dev

# start the local Python server instead (deprecated, old default)
uiauto.dev server

Run prebuilt server binary

Running uiauto.dev without a command downloads the prebuilt server binary for the current platform and executes it as run -open. The binary is cached at ~/.cache/uiautodev/<version>/ (override with UIAUTODEV_CACHE_DIR), and everything after run is passed through to the binary as-is.

Note: the old local-server default is now the explicit uiauto.dev server command.

uiauto.dev                          # download latest binary and run it (open browser)
uiauto.dev run                      # same as above, without opening the browser
uiauto.dev run -addr :8000          # pass args through to the binary
uiauto.dev --version 0.10.5 run     # use a specific version
uiauto.dev download                 # only download, print the binary path
uiauto.dev download --force         # force re-download
uiauto.dev path                     # only print the binary path, no download
uiauto.dev --debug download         # debug logging (request/redirect info)

Environment

# Default driver is uiautomator2
# Set the environment variable below to switch to adb driver
export UIAUTODEV_USE_ADB_DRIVER=1

Offline mode

Start with

uiautodev server --offline

# Specify server url (optional)
uiautodev server --offline --server-url https://web.uiauto.dev

Visit http://localhost:20242 once, and then disconnecting from the internet will not affect usage.

All frontend resources will be saved to cache/ dir.

DEVELOP

see DEVELOP.md

Links

LICENSE

MIT

Metadata

Release files for uiautodev 0.15.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for uiautodev 0.15.0
File Size Uploaded
uiautodev-0.15.0.tar.gz 3.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for uiautodev 0.15.0
File Interpreter ABI Platform
uiautodev-0.15.0-py3-none-any.whl Python 3 none any Details

Total release size: 7.7 MB

Release files / uiautodev-0.15.0.tar.gz

Download URL uiautodev-0.15.0.tar.gz
Size 3.8 MB
Tags Source
SHA-256 checksum
How to use checksums
22aa2cb441fdb3ae520501a547cb1f200f2de7fbc9cf981a7cb1e17e4b9bd5ee
BLAKE2b-256 checksum
How to use checksums
7222d104f90557e49d52ba5eb118d03aefa6c35565643979b79946f5b9acc2ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / uiautodev-0.15.0-py3-none-any.whl

Download URL uiautodev-0.15.0-py3-none-any.whl
Size 3.8 MB
Tags Python 3
SHA-256 checksum
How to use checksums
119889d958af4e211ac4bb6f53776cb560deedf3d0c3ab4a67a32e4b651e9d19
BLAKE2b-256 checksum
How to use checksums
36548590c9abb89a131d0721ec3b5828286eb7249cdddca8f8afbf2b8ca22419
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

0.15.0 This release

2 release files

0.14.1

2 release files

0.14.0

2 release files

0.13.5

2 release files

0.13.4

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.12.0

2 release files

0.11.1

2 release files

0.10.0

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page