Coder Social home page Coder Social logo

mocobk / android-debug-keyboard Goto Github PK

View Code? Open in Web Editor NEW
46.0 1.0 14.0 1.04 MB

安卓 APP 测试辅助工具,可快速截图、录屏、查看信息、查看日志、安装、卸载、monkey测试等功能

License: GNU General Public License v3.0

Python 99.99% Batchfile 0.01%

android-debug-keyboard's Introduction

Android Debug Keyboard

Android Debug Keyboard(下面简称ADK)是一款安卓 APP 测试辅助工具,可快速截图、录屏、查看设备信息、应用信息、日志及安装、卸载、monkey测试等功能,主要是方便做安卓软件测试的同学,发现Bug、更快地提交Bug。 工具下载

工具预览

image

功能简介

  1. 支持多设备连接,查看设备信息、应用信息;
  2. 支持命令自动补全、类Linux命令输入;
  3. 快速安装apk包,安装后自动启动应用;
  4. 快速启动应用、停止应用、重启应用、清理数据、卸载应用;
  5. 全局截屏并在windows中使用默认图片查看器打开;
  6. 一键录屏,并获取;
  7. 实时查看指定应用的logcat日志,并高亮显示Warning、Error级别日志;
  8. 完整的Monkey测试,并生成日志及Excel图表报告;
  9. 更多功能待续...

使用方法

使用前请确保安装好adb工具,并配置好环境变量,这个不懂的同学自行google、百度了,这里也扔个链接吧,传送门

连接设备

打开ADK工具,未插入设备前是处理等待设备连接状态 插入设备后工具会自动连接,当前只有一个设备时会直接进入命令行模式,有多个设备时会显示设备列表并提供选择设备 image

查看帮助

进入命令行模式后会显示常用的快捷键,按F1或在命令行中输入help命令显示所有帮助

>help
-------------------------------------------------------------------------------
  Android Debug Keyboard V1.1   @mocobk
-------------------------------------------------------------------------------
  F1                      常用快捷键帮助
  F2                      显示设备信息 -机型 -系统版本 -分辨率 -IP
  F3                      快速启动指定的APP
  F4                      重启APP
  F5                      重启并刷新设备列表
  F6                      结束APP进程
  F7                      卸载APP
  F8                      清除APP数据、缓存
  F9                      查看APP实时日志
  F10                     录屏
  F11                     查看当前app信息
  F12                     打开文件保存目录
  Shift+Tab               按顺序切换已连接的设备
  Ctrl+A                  显示当前APP信息
  Ctrl+W                  切换设备连接方式,USB | WIFI
  Ctrl+P                  显示APP包名,未指定时默认显示当前APP
  命令模式:
  adb                     运行adb命令
  apk_path.apk            安装apk,支持http、ftp、samba
  app clear               清除APP数据、缓存
  app info                显示APP信息 -包名 -版本号 -包路径
  app logcat              查看APP实时日志,加参数 -l 高亮显示
  app restart             重启APP
  app start               快速启动指定的APP
  app stop                结束APP进程
  app uninstall           卸载APP
  cls                     清屏
  device info             显示设备信息 -机型 -系统版本 -分辨率 -IP -设备序列号
  exit                    退出程序
  help                    显示所有帮助
  history                 显示历史记录, !+序号可再次调用该命令,如!12
  input                   输入文本内容到设备,暂不支持中文
  monkey                  运行monkey测试,加参数 -r 重复上一次的monkey测试
  open dir                打开文件保存的目录
  package name            显示APP包名,未指定时默认显示当前APP
  refresh                 重启并刷新设备列表
  screencap               截图
  screenrecord            录屏
  set app[ package_name]  指定调试APP包名,不填包名,默认为当前APP
  set hotkey              设置截图全局热键 set hotkey CTRL+Q; set hotkey ALT+Q
  switch connect          切换设备连接方式,USB | WIFI
-------------------------------------------------------------------------------

安装应用

直接输入apk的存放路径或拖拽apk包到工具中,按回车即可安装,支持从http、ftp、samba共享文件夹地址中安装,安装后应用会自动打开。

调试应用

设置需要调试/测试的应用包名,不输入包名时会自动设置为当前打开的应用

>set app com.mpr.mprepubreader

启动应用、停止应用、重启应用、清理数据、卸载应用,也可以使用相应的快捷键操作

>app start
>app stop
>app restart
>app clear
>app uninstall

快速截图

ADK默认使用ALT + S全局热键截图,若与其他程序热键冲突可使用set hotkey命令重置

快速录屏

按F10可快速对设备屏幕进行录屏,按Ctrl + S结束录屏后,可按F12打开视频文件所有目录 image

查看应用日志

按F9可实时查看已设置的应用或当前应用的运行日志,测试时当应用出现崩溃时可输入 app logcat -l 高亮显示崩溃日志信息 image

运行monkey测试

image 设置monkey命令并运行monkey测试

>monkey

重复上一次的monkey测试

>monkey -r

测试结束后可按F12打开报告所在的文件夹

小技巧

  1. 输入命令时按上、下键选择历史命令
  2. ctrl+u/ctrl+k 分别从光标处向前或向后批量删除命令字符串
  3. ctrl+a/ctrl+e 分别将光标移动到命令最前或最后
  4. 多个设备时可按Shift + Tab来回切换
  5. Ctrl + W 可切换使用USB连接或WIFI连接设备,默认使用USB连接,截图速度更快

目前还有一些异常没考虑到或某些系统版本未兼容,欢迎提交Issues,希望能为安卓测试带来更多便捷!

联系作者:[email protected]

android-debug-keyboard's People

Contributors

mocobk avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

android-debug-keyboard's Issues

Unhandled exception in event loop:

终端每次输入内容时,都会报错,如下:

Unhandled exception in event loop:
File "D:\D盘_demo\Android-Debug-Keyboard-master\src\prompt_toolkit\eventloop\coroutine.py", line 90, in step_next
new_f = coroutine.throw(exc)
File "D:\D盘_demo\Android-Debug-Keyboard-master\src\prompt_toolkit\buffer.py", line 1614, in new_coroutine
yield From(coroutine(*a, **kw))
File "D:\D盘_demo\Android-Debug-Keyboard-master\src\prompt_toolkit\eventloop\coroutine.py", line 90, in step_next
new_f = coroutine.throw(exc)
File "D:\D盘_demo\Android-Debug-Keyboard-master\src\prompt_toolkit\buffer.py", line 1472, in async_completer
cancel=lambda: not proceed()))
File "D:\D盘_demo\Android-Debug-Keyboard-master\src\prompt_toolkit\eventloop\coroutine.py", line 86, in step_next
new_f = coroutine.send(None)

Exception generator raised StopIteration
Press ENTER to continue...

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.