You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
36 lines
1.2 KiB
36 lines
1.2 KiB
4 months ago
|
<!-- 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)
|