tag | d5bd2b8fbf731b3ffce8db658621b54b871160c8 | |
---|---|---|
tagger | The Android Open Source Project <initial-contribution@android.com> | Mon May 06 21:48:00 2024 -0700 |
object | 16ff77d747aa5510dc6579083490771b6c6765fc |
Android platform 14.0.0 release 7
commit | 16ff77d747aa5510dc6579083490771b6c6765fc | [log] [tgz] |
---|---|---|
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Wed May 31 23:09:39 2023 +0000 |
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Wed May 31 23:09:39 2023 +0000 |
tree | b9ba7847f42e87d5f75664f149ab3713c0e89267 | |
parent | af56764eaadbff690c1c271b72304b2f961bd3ef [diff] | |
parent | a7badbfa0cb93fdf28aaed1cf451a3cd7438bb60 [diff] |
Snap for 10233678 from a7badbfa0cb93fdf28aaed1cf451a3cd7438bb60 to udc-release Change-Id: I59d371de423258d53dbfc7d030a139aefb64ebc9
Mobly Snippet Lib is a library for triggering device-side code from host-side Mobly tests. This tutorial teaches you how to use the snippet lib to trigger custom device-side actions.
Note: Mobly and the snippet lib are not official Google products.
The Mobly Snippet Lib allows you to write Java methods that run on Android devices, and trigger the methods from inside a Mobly test case. The Java methods invoked this way are called snippets
.
The snippet
code can either be written in its own standalone apk, or as a product flavor of an existing apk. This allows you to write snippets that instrument or automate another app.
A snippet is launched by an am instrument
call. Snippets use a custom InstrumentationTestRunner
derived from AndroidJUnitRunner
. This allows for snippets that interact with a main app‘s classes, such as Espresso snippets, and allows you to get either the test app’s or the main app's context from InstrumentationRegistry
.
Once started, the special runner starts a web server which listens for requests to trigger snippets. The server's handler locates the corresponding methods by reflection, runs them, and returns results over the TCP socket. All common built-in variable types are supported as arguments.
The examples/ folder contains examples of how to use the mobly snippet lib along with detailed tutorials.