Google Git
Sign in
android / platform / external / mobly-snippet-lib / 0b65e00
commit0b65e00993ebb751edb07f3c510f564c814fab9f[log] [tgz]
authorAng Li <angli@google.com>Thu Feb 23 18:42:57 2017 -0800
committerGitHub <noreply@github.com>Thu Feb 23 18:42:57 2017 -0800
tree89976d57bef20df0b5e58535c0803919dff8870b
parent03f59812e047af19f365288940160bf3dbea5b71 [diff]
Remove an unused var. (#46)
1 file changed
tree: 89976d57bef20df0b5e58535c0803919dff8870b
  1. examples/
  2. gradle/
  3. third_party/
  4. .gitignore
  5. build.gradle
  6. CHANGELOG
  7. CONTRIBUTING
  8. gradle.properties
  9. gradlew
  10. gradlew.bat
  11. LICENSE
  12. README.md
  13. 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 corrsponding 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.