aboutsummaryrefslogtreecommitdiff
path: root/catapult/devil/README.md
blob: 83f4ba09231d8fd5655ed9fdca1f4d7580765694 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<!-- Copyright 2015 The Chromium Authors. All rights reserved.
     Use of this source code is governed by a BSD-style license that can be
     found in the LICENSE file.
-->
## devil

😈

devil (device interaction layer) is a library used by the Chromium developers to
interact with Android devices. It currently supports SDK level 16 and above.

## Interfaces

devil provides python APIs:
  - [`devil.android.adb_wrapper`](docs/adb_wrapper.md) provides a thin wrapper
    around the adb binary. Most functions and methods have direct analogues on
    the adb command-line.
  - [`devil.android.device_utils`](docs/device_utils.md) provides higher-level
    functionality built on top of `adb_wrapper`. **This is the primary
    mechanism through which chromium's scripts interact with devices.**

## Utilities

devil also provides command-line utilities:
 - [`devil/utils/markdown.py`](docs/markdown.md) generated markdown
   documentation for python modules.

## Constraints and Caveats

devil supports python 2.7. Python 3 compatibility is currently a work in
progress (see https://crbug.com/1007101).

## Contributing

Please see [our contributor's guide](/CONTRIBUTING.md)