Google Git
Sign in
android / platform / external / mobly-snippet-lib / 23cff8ec536cad6ee60e68d4cbfa338c20571294
commit23cff8ec536cad6ee60e68d4cbfa338c20571294[log] [tgz]
authorZiwei Zhang <[email protected]>Tue Apr 09 12:49:28 2024 +0800
committerZiwei Zhang <[email protected]>Tue Apr 09 05:01:40 2024 +0000
tree38533c9648bef596a95c5fa85774a4946e992625
parenta3af46165c6d4168bb33d6e97b9959eba531b5bd [diff]
parent3c705915cad43acd88a8815b3f3e3cf9455a60a4 [diff]
Upgrade mobly-snippet-lib to 3c705915cad43acd88a8815b3f3e3cf9455a60a4

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

Test: TreeHugger
Bug: 331669033
Change-Id: I9c9338bbc1bbadf87f96381a366ba1f977965572
tree: 38533c9648bef596a95c5fa85774a4946e992625
  1. examples/
  2. gradle/
  3. third_party/
  4. .gitignore
  5. Android.bp
  6. build.gradle
  7. CHANGELOG
  8. CONTRIBUTING
  9. gradle.properties
  10. gradlew
  11. gradlew.bat
  12. LICENSE
  13. METADATA
  14. MODULE_LICENSE_APACHE2
  15. OWNERS
  16. README.md
  17. settings.gradle
README.md

Getting Started with Snippets for Mobly

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.

Prerequisites

  • These examples and tutorials assume basic familiarity with the Mobly framework, so please follow the Mobly tutorial before doing this one.
  • You should know how to create an Android app and build it with gradle. If not, follow the Android app tutorial.

Overview

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.

Under The Hood

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.

Usage

The examples/ folder contains examples of how to use the mobly snippet lib along with detailed tutorials.

  • ex1_standalone_app: Basic example of a snippet which is compiled into its own standalone apk.
  • ex2_espresso: Example of a snippet which instruments a primary app to drive its UI using Espresso.
  • ex3_async_event: Example of how to use the @AsyncRpc annotation to handle asynchronous callbacks.
  • ex4_uiautomator: Example of how to create snippets that automate the UI actions using UIAutomator. Unlike Espresso UIAutomator works even without access to app source code.
  • ex5_schedule_rpc: Example of how to use the ‘scheduleRpc’ RPC to execute another RPC at a later time, potentially after device disconnection.
  • ex6_complex_type_conversion: Example of how to pass a non-primitive type to the Rpc methods and return non-primitive type from Rpc methods by supplying a type converter.