Welcome to pyatool’s documentation!¶
Usage¶
使用方法如下
from pyatool import PYAToolkit
# 初始化
device = PYAToolkit('123456F')
# 1. 直接调用
package_list = device.show_package()
# 2. 或者 通过标准库(有自动补全,能够看到真实的方法实现)
package_list = device.std.show_package(toolkit=device)
# 具体返回内容与调用的方法实现有关
print(package_list)
要调用其他的API,将 show_package 替换成API名称即可!
API¶
-
pyatool.extras.
install_from
(url: str = None, path: str = None, toolkit=None)[source]¶ 根据url或path安装指定apk
Parameters: - url – apk对应的下载url
- path – apk的本地路径
- toolkit –
Returns:
-
pyatool.extras.
get_current_activity
(toolkit=None)[source]¶ 获取设备的当前栈顶activity名称
Parameters: toolkit – Returns:
-
pyatool.extras.
is_installed
(package_name: str, toolkit=None)[source]¶ 检测包是否已被安装到设备上
Parameters: - package_name – 待检测的包名
- toolkit –
Returns:
-
pyatool.extras.
clean_cache
(package_name: str, toolkit=None)[source]¶ 清理对应包的缓存
Parameters: - package_name – 对应包名
- toolkit –
Returns:
-
pyatool.extras.
uninstall
(package_name: str, toolkit=None, save_data: bool = None)[source]¶ 卸载指定包
Parameters: - package_name – 对应包名
- toolkit –
- save_data – 是否保留data
Returns:
-
pyatool.extras.
switch_airplane
(status: bool, toolkit=None)[source]¶ 切换飞行模式的开关
Parameters: - status – true or false
- toolkit –
Returns:
-
pyatool.extras.
switch_wifi
(status: bool, toolkit=None)[source]¶ 切换wifi开关
Parameters: - status – true or false
- toolkit –
Returns:
-
pyatool.extras.
input_text
(content: str, toolkit=None)[source]¶ 输入文字(不支持中文)。中文输入可以利用ADBKeyBoard (https://github.com/senzhk/ADBKeyBoard)
Parameters: - content – 期望的输入内容
- toolkit –
Returns:
-
pyatool.extras.
start_activity
(package_name: str, activity_name: str = None, toolkit=None)[source]¶ 根据包名/活动名 启动应用/活动 (更复杂场景请使用 start_activity_with_command)
Parameters: - package_name – 包名
- activity_name – 活动名
- toolkit –
Returns:
-
pyatool.extras.
start_activity_with_command
(command: str, toolkit=None)[source]¶ 更灵活的 start_activity,实际上是运行 adb shell am start <command>
Parameters: - command – adb shell am start <command>
- toolkit –
Returns:
-
pyatool.extras.
set_ime
(ime_name, toolkit=None)[source]¶ 设置输入法(需要使用adb shell ime list -a 获取输入法包名)
Parameters: - ime_name – 输入法包名 eg:com.android.inputmethod.pinyin/.PinyinIME
- toolkit –
Returns:
-
pyatool.extras.
push
(src, target, toolkit=None)[source]¶ adb push <src> <target>
Parameters: - src –
- target –
- toolkit –
Returns:
-
pyatool.extras.
pull
(src, target, toolkit=None)[source]¶ adb pull <src> <target>
Parameters: - src –
- target –
- toolkit –
Returns:
-
pyatool.extras.
send_broadcast
(command: str, toolkit=None)[source]¶ 发送广播,实际上是 adb shell am broadcast <command>
Parameters: - command – 在 am broadcast 后的命令
- toolkit –
Returns:
-
pyatool.extras.
force_stop
(package_name: str, toolkit=None)[source]¶ 根据包名/活动名 停止应用
Parameters: - package_name – 包名
- toolkit –
Returns:
-
pyatool.extras.
input_key_event
(key_code, toolkit=None)[source]¶ send key event
Parameters: - key_code – 按钮对应的 keycode, 例如home键是3。参考https://developer.android.com/reference/kotlin/android/view/KeyEvent
- toolkit –
Returns:
-
pyatool.extras.
swipe
(x1, y1, x2, y2, toolkit=None)[source]¶ swipe from (x1, y1) to (x2, y2)
Parameters: - x1 –
- y1 –
- x2 –
- y2 –
- toolkit –
Returns:
-
pyatool.extras.
is_connected
(toolkit=None)[source]¶ check if device is connected
Parameters: toolkit – Returns:
\ Sort by:\ best rated\ newest\ oldest\
\\
Add a comment\ (markup):
\``code``
, \ code blocks:::
and an indented block after blank line