Google Git
Sign in
android / platform / external / python / mobly / a09e1116e2473aead659fe8fe6993e982e380613
commita09e1116e2473aead659fe8fe6993e982e380613[log] [tgz]
authorMinghao Li <[email protected]>Tue Feb 25 18:38:34 2025 +0800
committerMinghao Li <[email protected]>Wed Feb 26 16:05:23 2025 +0800
treeea49b65bdc16643e52230798c889ce61dc37cca9
parentfd25b1988dae00533f7d5098355231a1971e7b49 [diff]
parenta489d904870e349ce47cc972d0f20c4723316cce [diff]
Upgrade mobly to a489d904870e349ce47cc972d0f20c4723316cce

This project was upgraded with external_updater.
Usage: tools/external_updater/updater.sh update external/python/mobly
For more info, check https://cs.android.com/android/platform/superproject/main/+/main:tools/external_updater/README.md

Test: http://sponge2/13621805-ae77-44fd-9262-c7ae6930c069 (passed)
Change-Id: Ib9fe4462ce8cfcfa13450be3e49b0d8b221d2779
tree: ea49b65bdc16643e52230798c889ce61dc37cca9
  1. .github/
  2. docs/
  3. mobly/
  4. tests/
  5. tools/
  6. .gitignore
  7. .readthedocs.yml
  8. Android.bp
  9. CHANGELOG.md
  10. CONTRIBUTING.md
  11. LICENSE
  12. METADATA
  13. MODULE_LICENSE_APACHE2
  14. OWNERS
  15. pyproject.toml
  16. README.md
  17. tox.ini
README.md

Welcome to Mobly

Latest release Build Status

Mobly is a Python-based test framework that specializes in supporting test cases that require multiple devices, complex environments, or custom hardware setups.

Here are some example use cases:

  • P2P data transfer between two devices
  • Conference calls across three phones
  • Wearable device interacting with a phone
  • Internet-Of-Things devices interacting with each other
  • Testing RF characteristics of devices with special equipment
  • Testing LTE network by controlling phones, base stations, and eNBs

Mobly can support many different types of devices and equipment, and it's easy to plug your own device or custom equipment/service into Mobly.

Mobly comes with a set of libs to control common devices like Android devices.

While developed by Googlers, Mobly is not an official Google product.

Compatibility

Mobly requires python 3.11 or newer.

Mobly tests could run on the following platforms:

  • Ubuntu 14.04+
  • MacOS 10.6+
  • Windows 7+

System dependencies

  • adb (1.0.40+ recommended)
  • python3.11+

Installation

You can install the released package from pip

pip install mobly

or install from the source to use the bleeding edge:

git clone https://github.com/google/mobly.git
cd mobly
pip install -e .

You may need sudo for the above commands if your system has certain permission restrictions.

Tutorials

Mobly Snippet

The Mobly Snippet projects let users better control Android devices.

  • Mobly Snippet Lib: used for triggering custom device-side code from host-side Mobly tests. You could use existing Android libraries like UI Automator and Espresso.
  • Mobly Bundled Snippets: a set of Snippets to allow Mobly tests to control Android devices by exposing a simplified version of the public Android API suitable for testing.