Metadata-Version: 2.1
Name: androidautotest
Version: 0.0.2.16
Summary: android test framework using adb connection and template matching in opencv
Home-page: https://github.com/15045120/AndroidTest
Author: 15045120
Author-email: 1337078409@qq.com
License: UNKNOWN
Description: # AndroidTest
        
        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.
        
        ## Installation
         1.Install ADB ([Android Debug Bridge](https://github.com/15045120/AndroidTest/tree/master/dependency/adb)), and add it to path.
         
         2.Use ASM ([Android Screen Monitor](https://github.com/15045120/AndroidTest/blob/master/dependency/asm.jar)) to capture partial picture, and you need to install JDK in your computer first to run it.
        
         - Simple to use:
        ```bash
        java -jar asm.jar
        ``` 
         - Then adjust zoom to 50%, you also can set to other size, but need to add some code in your case source file after your create your case file:
        ```python
        # if adjust asm zoom to 25% 
        ASM.ZOOM_SIZE = 25
        ``` 
        3.Install androidautotest
        ```bash
        pip install androidautotest 
        ``` 
        4.If you cannot install dependency of androidautotest using 'pip install androidautotest', you can use [tools\install.py](https://github.com/15045120/AndroidTest/blob/master/tools/install.py)
        ```bash
        python install.py
        ``` 
         5.Use [tools\newCase.py](https://github.com/15045120/AndroidTest/blob/master/tools/newCase.py) to create a new case to start your test task with Android Phone.
        
        ```bash
        python newCase.py <caseName> <savePath>
        ``` 
        ## Documentation
        You can find the complete AndroidTest API documentation on  [readthedocs](http://androidtest.readthedocs.io/).
        ## Examples
        ```python
        # -*- coding: UTF-8 -*-
        from androidautotest.api import *
        
        # to home
        keyevent(HOME)
        keyevent(HOME,device='HMKNW17421063974')
        
        # to FileBrowser
        while not exists(Template(r'pic\20191215121636.png')):
        	flick((400,400),DIR_LEFT,step=2)
        touch(Template(r'pic\20191215121636.png'))
        touch(Template(r'pic\20191215134814.png'))
        
        # not in top screen of FileBrowser
        if exists(Template(r'pic\20191215143440.png')):
        	touch(Template(r'pic\20191215142057.png'))
        	text('15045120')
        else:
        	touch([530,142])
        	text('15045120')
        
        # 15045120 is in screen
        assert_exists(Template(r'pic\20191215142425.png'))
        
        end()
        ```
        Once you finish your code writing, you can run your case(for example: you create a case named 'case001'):
        ```bash
        cd case001.air
        python case001.py
        ``` 
        And there are three log files you can use to analyze your test plan after run your case.
        
         - case001.air\case001.log.20191222010717_540637\log_case001_20191222010717_540637.txt
         - case001.air\case001.log.20191222010717_540637\serial_log_case001_20191222010717_540637.txt
         - case001.air\case001.log.20191222010717_540637\report_case001_20191222010717_540637.html
         -----------
        
         - log_case001_XXX: all log output
         - serial_log_case001_XXX: adb log output
         - serial_log_case001_XXX: report of case run
         
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
