Google Git
Sign in
android / platform / external / python / mobly / refs/heads/android14-qpr3-d1-s2-release
commitdb25eb070b991dd8e1cde4155f14330521d63fb8[log] [tgz]
authorAndroid Build Coastguard Worker <[email protected]>Fri Oct 06 01:09:02 2023 +0000
committerAndroid Build Coastguard Worker <[email protected]>Fri Oct 06 01:09:02 2023 +0000
tree22c90a7f799b736bb1fb9f8972eb39d2fd4418e4
parent5dfbe3bf899f0de2da94446f42875851d7cb7d56 [diff]
parenta529b98b550f5d2cdb797699d6528ca5454759a6 [diff]
Snap for 10909147 from a529b98b550f5d2cdb797699d6528ca5454759a6 to 24D1-release

Change-Id: I9e3c054115ca5e1a866c7067af6717ddcf040c86
tree: 22c90a7f799b736bb1fb9f8972eb39d2fd4418e4
  1. .github/
  2. docs/
  3. mobly/
  4. tests/
  5. tools/
  6. .gitignore
  7. .readthedocs.yml
  8. .style.yapf
  9. Android.bp
  10. CHANGELOG.md
  11. CONTRIBUTING.md
  12. LICENSE
  13. METADATA
  14. MODULE_LICENSE_APACHE2
  15. OWNERS
  16. README.md
  17. setup.cfg
  18. setup.py
  19. tox.ini
README.md

Welcome to Mobly

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.6 or newer.

Mobly tests could run on the following platforms:

  • Ubuntu 14.04+
  • MacOS 10.6+
  • Windows 7+
PlatformBuild Status
LinuxLinux Build Status
WindowsWindows Build Status

System dependencies

  • adb (1.0.40+ recommended)
  • python3.7+
  • python-setuptools

To use Python3, use pip3 and python3 (or python3.x) accordingly.

Installation

You can install the released package from pip

pip install mobly

or download the source then run setup.py to use the bleeding edge:

git clone https://github.com/google/mobly.git
cd mobly
python setup.py install

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.