Skip to main content

android test framework using adb connection and template matching in opencv

Project description


The package is for android auto test, based on Python enviroment.

Basic thought is using ADB (Android Debug Bridge) to send command to Android test Phone connected with the PC and match picture by match template algorithm in opencv-python.


1.ADB (Android Debug Bridge)

2.ASM (Android Screen Monitor)

Use to capture partial picture, and you need to install JDK in your computer before running it.

Then adjust zoom to 50%, you can also set zoom to other size, but need to add some code in your case source file after your create your case file:

# adjust asm zoom to other size, 25% 

3.Tesseract (Tesseract-OCR)

If you want to use the mechod 'image_to_string' in the 'androidautotest.api' which can recognize text in pictures, you need to install Tesseract and install testdata necessary like chinese 'chi_sim'.

Installation & Usage

1.Install androidautotest

pip install androidautotest 

Follow information indicate you have installed androidautotest successfully.

> python -m androidautotest
  androidautotest --installdep
  androidautotest --startasm
  androidautotest --newcase <NEWCASE> --savedir <SAVEDIR>
  androidautotest --casedir <CASEDIR> --device <DEVICE> --times <TIMES>

A framework to run test case for android automated test

optional arguments:
  -V, --version        Print version and exit
  -h, --help           Print this help message and exit

install dependency:
  --installdep         install dependency of androidautotest

start asm:
  --startasm           start Android Screen Monitor

create case:
  --newcase <NEWCASE>  New case name to create
  --savedir <SAVEDIR>  Path to save new case

run case:
  --casedir <CASEDIR>  Case path to run
  --device <DEVICE>    Device to switch
  --times <TIMES>      Times of case running

2.install requirements

python -m androidautotest --installdep

3.start Android Screen Monitor(First, connect your Android Phone with PC, and open adb debug mode), then run follow command:

python -m androidautotest --startasm

4.create a new case to start your test task with Android Phone(For example: to create a new case named 'case001').

python -m androidautotest --newcase case001 --savedir E:\AndroidTest\workspace


You can find the complete AndroidTest API documentation on readthedocs.


# -*- coding: UTF-8 -*-
from androidautotest.api import *

# to home

# to FileBrowser
while not exists(Template(r'pic\20191215121636.png')):

# not in top screen of FileBrowser
if exists(Template(r'pic\20191215143440.png')):

# 15045120 is in screen


Once you finish your code writing, you can run your case. 1.If you connect one Android Phone with your PC, and run for once time, simple wirte as following

python -m androidautotest --casedir E:\AndroidTest\workspace\case001.air --device HMKNW17421063974 --times 5

2.If you connect more than one Android Phone with your PC, run case with Android Phone which's serial number is 'HMKNW17421063974' for 5 times, you can write as following.

python -m androidautotest --casedir E:\AndroidTest\workspace\case001.air --device HMKNW17421063974 --times 5

And there are three log files you can use to analyze your test plan after run your case.

In case001.air\log\case001.log.XXX

File NameDescription
log_case001_XXX.txtall log output
serial_log_case001_XXX.txtadb log output
report_case001_XXX.htmlreport of case run

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

androidautotest- (14.0 kB view hashes)

Uploaded Source

Built Distribution

androidautotest- (17.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page