https://github.com/dtmilano/androidviewclient

Android ViewServer and ADB client
https://github.com/dtmilano/androidviewclient

adb android androidviewclient automation culebra monkeyrunner python testing ui

Last synced: about 2 months ago
JSON representation

Android ViewServer and ADB client

• Host: GitHub
• URL: https://github.com/dtmilano/androidviewclient
• Owner: dtmilano
• License: apache-2.0
• Created: 2012-02-02T06:04:40.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2024-11-30T01:08:40.000Z (7 months ago)
• Last Synced: 2025-04-25T15:48:44.109Z (2 months ago)
• Topics: adb, android, androidviewclient, automation, culebra, monkeyrunner, python, testing, ui
• Language: Python
• Homepage:
• Size: 26 MB
• Stars: 1,656
• Watchers: 75
• Forks: 346
• Open Issues: 53
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
AndroidViewClient

=================



**AndroidViewClient/culebra** was initially conceived as an extension to [monkeyrunner](http://developer.android.com/tools/help/monkeyrunner_concepts.html)  but has since evolved

into a versatile pure Python tool.

It streamlines test script creation for Android applications by automating tasks and simplifying interactions. This test framework:



  
Automates the navigation of Android applications.

  
Generates reusable scripts for efficient testing.

  
Offers device-independent UI interaction based on views.

  
Utilizes 'logical' screen comparison (UI Automator Hierarchy based) instead of image comparison, avoiding extraneous detail issues like time or data changes.

  
Supports concurrent operation on multiple devices.

  
Provides straightforward control for high-level operations such as language change and activity start.

  
Fully supports all Android APIs.

  
Written in Python with support for Python 3.6 and above in versions 20.x.y and beyond.



**🛎** |A new Kotlin backend is under development to provide more functionality and improve performance.
Take a look at [CulebraTester2](https://github.com/dtmilano/CulebraTester2-public) and 20.x.y-series prerelease. |

---|----------------------------------------------------------------------------------------------|

[![Latest Version](https://img.shields.io/pypi/v/androidviewclient.svg)](https://pypi.python.org/pypi/androidviewclient/)

![Release](https://img.shields.io/github/v/release/dtmilano/AndroidViewClient?include_prereleases&label=release)

![Upload Python Package](https://github.com/dtmilano/AndroidViewClient/workflows/Upload%20Python%20Package/badge.svg)

[![Downloads](https://static.pepy.tech/badge/androidviewclient)](https://pepy.tech/project/androidviewclient)

**NOTE**: Pypi statistics are broken see [here](https://github.com/aclark4life/vanity/issues/22). The new statistics can be obtained from [BigQuery](https://bigquery.cloud.google.com/queries/culebra-tester).

As of February 2024 we have reached:



  



Thanks to all who made it possible.

# Installation

```

pip3 install androidviewclient --upgrade

```

Or check the wiki for more alternatives.

# Want to learn more?

> 🚀 Check [Examples](https://github.com/dtmilano/AndroidViewClient/wiki/Resources#examples) and [Screencasts and videos](https://github.com/dtmilano/AndroidViewClient/wiki/Resources#screencasts-and-videos) page to see it in action.

> 

Detailed information can be found in the [AndroidViewClient/culebra wiki](https://github.com/dtmilano/AndroidViewClient/wiki)