Android SDK由多个软件包组成,这些包是应用程序开发所必需的。这个页面列出了最重要的命令行工具,这些工具是由它们配送的包组织。
你可以安装和更新每一个软件包,使用Android Studio的SDK Manager 或者 sdkmanager 命令行工具。所有的包都被下载到您的Android SDK目录中,您可以将其定位如下:
位置:android_sdk/tools/bin/
这个包是独立于平台的,无论你正在开发哪个Android平台,都需要它。
apkanalyzer
当apk构建完成之后,提供apk组成成分的分析
avdmanager
允许你使用命令行管理和创建Anroid模拟器
jobb
允许您在不透明的二进制Blob(OBB)表单中构建加密和未加密的APK扩展文件
lint
一种代码扫描工具,它可以帮助您识别和纠正代码结构质量的问题
monkeyrunner
为运行程序提供命令行接口,可以安装一个Android应用或测试包,运行它,发送按键,截屏,等等。
sdkmanager
允许你浏览、安装、更新、卸载Android SDK
位置:android_sdk/build-tools/version/
这个包是构建Android app需要的,这里大多说工具都是构建工具调用的,而不是为你准备的。但是下面的命令行大概是对你有用的:
apksigner
给一个给定的apk签名和确保签名在所有的平台版本上认证成功。
zipalign
通过确保所有未压缩的数据以一个特定的比例开始,相对于文件的开始,用于优化APK文件。
位置:android_sdk/platform-tools/
这个工具随着平台版本的更新会更新新的特性(修复和提高旧的特性),每一次更新都是向后兼容旧的平台版本。
adb
Android调试桥(adb)是一种通用的工具,可以让您管理仿真器实例或Android设备的状态。你也可以用它在设备上安装APK
etc1tool
一个命令行实用程序,它允许你将PNG图像编码到ETC1压缩标准,并将ETC1压缩的图像解码回PNG格式
fastboot
使用平台和其他系统映像来储存设备。对于flash的指令,可以看到
Factory Images for Nexus and Pixel Devices.
logcat
这是一个通过adb调用的工具来查看应用程序和系统日志
这个包是Android模拟器需要的,它包含如下:
emulator
一个基于虚拟操作系统模拟器(QEMU)的设备模拟工具,您可以使用它来调试和测试您在实际的Android运行时环境中的应用程序。
mksdcard
帮你创建你的模拟器创建内存镜像,模拟额外内存卡(SD卡)的存在
在通过 USB 连接的设备上使用 adb,您必须在设备系统设置中启用 USB debugging(位于 Developer options 下)。
在运行 Android 4.2 及更高版本的设备上,Developer options 屏幕默认情况下处于隐藏状态。如需将其显示出来,请转到 Settings > About phone 并点按 Build number 七次。返回上一屏幕,在底部可以找到 Developer options。
在某些设备上,Developer options 屏幕所在的位置或命名方式可能有所不同。
现在,您可以将设备与 USB 连接。可以从 android_sdk/platform-tools/
目录执行 adb devices
来验证设备是否连接。如果已连接,您将看到设备名称以“设备”形式列示。
通过 WLAN 连接到设备注:当您连接运行 Android 4.2.2 或更高版本的设备时,系统将显示一个对话框,询问您是否接受允许在这台计算机上调试的 RSA 密钥。这种安全机制可以保护用户设备,因为它可以确保只有在您能够解锁设备并确认对话框的情况下才能执行 USB 调试和其他 ADB 命令。
一、查找 Android 设备的 IP 地址。例如,在 Nexus 设备上,您可以通过访问 Settings > About tablet(或 About phone) > Status > IP address 查找 IP 地址。或者,在 Android Wear 设备上,您可以通过访问 Settings > Wi-Fi Settings > Advanced > IP address 查找 IP 地址。
adb connect device_ip_address
二、请确认您的主计算机已连接至目标设备:
adb devices
List of devices attached
device_ip_address:5555 device
现在,您可以开始操作了!
如果 adb 连接丢失:
请确保您的主机仍与您的 Android 设备连接到同一个 WLAN 网络。
通过再次执行 adb connect
步骤重新连接。
如果无法连接,则重置 adb 主机:
adb kill-server
然后,从头开始操作。
查询设备在发出 adb 命令之前,知道哪些模拟器/设备实例已连接到 adb 服务器会很有帮助。您可以使用 devices
命令生成已连接的模拟器/设备的列表:
adb devices
在响应时,adb 针对每个实例输出此状态信息:
type-console-port
。下面是一个序列号示例:emulator-5554
offline
— 实例未连接到 adb 或不响应。device
— 实例现在已连接到 adb 服务器。请注意,此状态并不表示 Android 系统已完全启动且可以运行,因为在此实例连接到 adb 时系统仍在启动。不过,在启动后,这将是模拟器/设备实例的正常运行状态。no device
— 未连接模拟器/设备。输出的格式类似如下:
List of devices attached
serial_number state
以下示例向您展示了 devices 命令及其输出:
adb devices
List of devices attached
emulator-5554 device
emulator-5556 device
emulator-5558 device
将命令发送至特定设备
如果多个模拟器/设备实例正在运行,在发出 adb 命令时您必须指定一个目标实例。为此,请在命令中使用 -s
选项。以下是 -s
选项的用法:
adb -s serial_number command
如上所示,您使用由 adb 分配的序列号为命令指定目标实例。您可使用 devices
命令获取正在运行的模拟器/设备实例的序列号。例如:
adb -s emulator-5556 install helloWorld.apk
注意,如果在多个设备可用时您未指定目标模拟器/设备实例就发出命令,那么 adb 将生成一个错误。
如果您有多个设备可用(硬件或模拟设备),但只有一个设备是模拟器,则使用 -e
选项将命令发送至该模拟器。同样,如果有多个设备,但只连接了一个硬件设备,则使用 -d
选项将命令发送至该硬件设备。
您可以使用 adb 从开发计算机复制应用,并将其安装到模拟器/设备实例上。为此,请使用 install
命令。使用此命令,您必须指定您要安装的 APK 文件的路径:
adb install path_to_apk
如需有关如何创建可在模拟器/设备实例上安装的 APK 文件的详细信息,请参阅构建和运行您的应用。
请注意,如果使用 Android Studio,则无需直接使用 adb(或 aapt)在模拟器/设备上安装您的应用。而是由 Android Studio 为您处理应用的打包和安装。
设置端口转发您可以使用 forward 命令设置任意端口转发 — 将对特定主机端口的请求转发到模拟器/设备实例上的其他端口。下面向您介绍如何设置主机端口 6100 到模拟器/设备端口 7100 的转发:
adb forward tcp:6100 tcp:7100
您也可以使用 adb 设置传输到指定的抽象 UNIX 网域套接字的转发,如下所示:
adb forward tcp:6100 local:logd
将文件复制到设备/从设备复制文件
您可以使用 adb 命令 pull
和 push
将文件复制到模拟器/设备实例或从其中复制文件。与 install
命令不同(其仅将 APK 文件复制到特定位置),pull
和 push
命令允许您将任意目录和文件复制到模拟器/设备实例中的任意位置。
要从模拟器或设备复制文件或目录(及其子目录),请使用
adb pull remote local
要将文件文件或目录(及其子目录)复制到模拟器或设备,请使用
adb pull remote local
在上述命令中,local 和 remote 指的是开发计算机(本地)和模拟器/设备实例(远程)上目标文件/目录的路径。例如:
adb push foo.txt /sdcard/foo.txt
停止 adb 服务器
在某些情况下,您可能需要终止 adb 服务器进程,然后重启它以解决问题(例如,如果 adb 不响应命令)。
要停止 adb 服务器,请使用 adb kill-server
命令。然后,您可以通过发出任意其他 adb 命令重启服务器。
您可以在开发计算机上从命令行发出 adb 命令,或通过脚本发出。用法如下:
adb [-d|-e|-s serial_number] command
如果只有一个模拟器在运行或只连接了一个设备,则默认情况下将 adb 命令发送至该设备。如果有多个模拟器在运行和/或连接了多个设备,您需要使用 -d、-e 或 -s 选项指定应向其发送命令的目标设备。
下表列出了所有支持的 adb 命令并解释其含义和用法。
类别 | 命令 | 说明 | 注释 |
---|
-d
将 adb 命令发送至唯一连接的 USB 设备。 如果连接了多个 USB 设备,将返回错误。
-e
将 adb 命令发送至唯一运行的模拟器实例。 如果有多个模拟器实例在运行,将返回错误。
-s serial_number
将 adb 命令发送至以其 adb 分配的序列号命名的特定模拟器/设备实例(如“emulator-5556”)。 请参阅
将命令发送至特定模拟器/设备实例。 常规
devices
输出所有连接的模拟器/设备实例的列表。 如需了解详细信息,请参阅
查询模拟器/设备实例。
help
输出支持的 adb 命令的列表。
version
输出 adb 版本号。 调试
logcat [option] [filter-specs]
将日志数据输出到屏幕。
bugreport
将
dumpsys
、
dumpstate
和
logcat
数据输出到屏幕,以用于报告错误。
jdwp
输出给定设备上可用的 JDWP 进程的列表。 您可以使用
forward jdwp:pid
端口转发规范以连接到特定的 JDWP 进程。例如:
adb forward tcp:8000 jdwp:472
jdb -attach localhost:8000
数据
install path_to_apk
将 Android 应用(使用 APK 文件的完整路径表示)推送到模拟器/设备。
pull remote local
从模拟器/设备实例将指定文件复制到开发计算机。
push local remote
从开发计算机将指定文件复制到模拟器/设备实例。 端口和网络连接
forward local remote
将来自指定本地端口的套接字连接转发到模拟器/设备实例上的指定远程端口。 端口规范可使用以下架构:
tcp:port_number
local:unix_domain_socket_name
dev:character_device_name
jdwp:pid
ppp tty [parm]...
通过 USB 运行 PPP。
tty
— 用于 PPP 流的 tty。例如,dev:/dev/omap_csmi_ttyl
。 [parm]...
— 零个或多个 PPP/PPPD 选项,如 defaultroute
、local
、notty
等。请注意,不得自动启动 PPP 连接。
脚本get-serialno
输出 adb 实例序列号字符串。 如需了解详细信息,请参阅
查询模拟器/设备实例。
get-state
输出模拟器/设备实例的 adb 状态。
wait-for-device
阻止执行,直至设备处于在线状态,即直至此实例状态为
device
。 您可以将此命令附加到其他 adb 命令,在此情况下,adb 在发出其他命令前将处于等待状态,直至模拟器/设备实例已连接。下面是一个示例:
adb wait-for-device shell getprop请注意,此命令 不会使 adb 等待整个系统已完全启动。因此,您不应将其追加到需要系统完全启动的其他命令。例如,
install
需要使用 Android 软件包管理器,其仅在系统完全启动后才可用。如下命令
adb wait-for-device install app.apk在模拟器或设备实例连接到 adb 服务器时立即发出
install
命令,但 Android 系统还未完全启动,因此,它将引发错误。 服务器
start-server
检查 adb 服务器进程是否在运行,如果未运行则启动它。
kill-server
终止 adb 服务器进程。 Shell
shell
在目标模拟器/设备实例中启动远程 shell。 如需了解详细信息,请参阅
发出 shell 命令。
shell shell_command
在目标模拟器/设备实例中发出 shell 命令,然后退出远程 shell。
发出 shell 命令
您可以使用 shell
命令通过 adb 发出设备命令,可以进入或不进入模拟器/设备实例上的 adb 远程 shell。要在不进入远程 shell 的情况下发出一个命令,请使用如下 shell
命令:
adb [-d|-e|-s serial_number] shell shell_command
或者,使用如下命令进入模拟器/设备实例上的远程 shell:
adb [-d|-e|-s serial_number] shell
当您准备退出远程 shell 时,按 Control + D 或输入 exit
。
shell 命令二进制文件存储在模拟器或设备的文件系统中,其路径为 /system/bin/
。
在 adb shell 中,您可以使用 Activity Manager (am) 工具发出命令以执行各种系统操作,如启动 Activity、强行停止进程、广播 intent、修改设备屏幕属性及其他操作。在 shell 中,此语法为:
am command
您也可以直接从 adb 发出 Activity Manager 命令,无需进入远程 shell。例如:
adb shell am start -a android.intent.action.VIEW
命令 | 说明 |
---|
start [options] intent
启动
intent
指定的
Activity
。
请参阅 intent 参数的规范。
选项包括:
-D
:启用调试。 -W
:等待启动完成。 --start-profiler file
:启动分析器并将结果发送到 file
。 -P file
:类似于 --start-profiler
,但当应用进入空闲状态时分析停止。 -R count
:重复 Activity 启动 count
次数。在每次重复前,将完成顶部 Activity。 -S
:启动 Activity 前强行停止目标应用。 --opengl-trace
:启用 OpenGL 函数的跟踪。 --user user_id | current
:指定要作为哪个用户运行;如果未指定,则作为当前用户运行。 startservice [options] intent
启动
intent
指定的
Service
。
请参阅 intent 参数的规范。
选项包括:
--user user_id | current
:指定要作为哪个用户运行;如果未指定,则作为当前用户运行。 force-stop package
强行停止与
package
(应用的包名称)关联的所有应用。
kill [options] package
终止与
package
(应用的包名称)关联的所有进程。此命令仅终止可安全终止且不会影响用户体验的进程。
选项包括:
--user user_id | all | current
:指定将终止其进程的用户;如果未指定,则终止所有用户的进程。 kill-all
终止所有后台进程。
broadcast [options] intent
发出广播 intent。
请参阅 intent 参数的规范。
选项包括:
[--user user_id | all | current]
:指定要发送到的用户;如果未指定,则发送到所有用户。 instrument [options] component
使用
Instrumentation
实例启动监控。通常,目标
component
是表单
test_package/runner_class
。
选项包括:
-r
:输出原始结果(否则对 report_key_streamresult
进行解码)。与 [-e perf true]
结合使用以生成性能测量的原始输出。 -e name value
:将参数 name
设为 value
。对于测试运行器,通用表单为 -e testrunner_flag value[,value...]
。 -p file
:将分析数据写入 file
。 -w
:先等待仪器完成,然后再返回。测试运行器需要使用此选项。 --no-window-animation
:运行时关闭窗口动画。 --user user_id | current
:指定仪器在哪个用户中运行;如果未指定,则在当前用户中运行。 profile start process file
启动
process
的分析器,将结果写入
file
。
profile stop process
停止
process
的分析器。
dumpheap [options] process file
转储
process
的堆,写入
file
。
选项包括:
--user [user_id|current]
:提供进程名称时,指定要转储的进程用户;如果未指定,则使用当前用户。 -n
:转储原生堆,而非托管堆。 set-debug-app [options] package
将应用
package
设为调试。
选项包括:
-w
:应用启动时等待调试程序。 --persistent
:保留此值。 clear-debug-app
使用
set-debug-app
清除以前针对调试用途设置的软件包。
monitor [options]
启动对崩溃或 ANR 的监控。
选项包括:
--gdb
:在崩溃/ANR 时在给定端口上启动 gdbserv。 screen-compat {on|off} package
控制
package
的
屏幕兼容性模式。
display-size [reset|widthxheight]
替换模拟器/设备显示尺寸。此命令对于在不同尺寸的屏幕上测试您的应用非常有用,它支持使用大屏设备模仿小屏幕分辨率(反之亦然)。
示例:am display-size 1280x800
display-density dpi
替换模拟器/设备显示密度。此命令对于在不同密度的屏幕上测试您的应用非常有用,它支持使用低密度屏幕在高密度环境环境上进行测试(反之亦然)。
示例:am display-density 480
to-uri intent
将给定的 intent 规范以 URI 的形式输出。
请参阅 intent 参数的规范。
to-intent-uri intent
将给定的 intent 规范以
intent:
URI 的形式输出。
请参阅 intent 参数的规范。
对于采用 intent
参数的 Activity Manager 命令,您可以使用以下选项指定 intent:
-a action
-d data_uri
-t mime_type
-c category
-n component
-f flags
setFlags()
支持的 intent。
--esn extra_key
-e|--es extra_key extra_string_value
--ez extra_key extra_boolean_value
--ei extra_key extra_int_value
--el extra_key extra_long_value
--ef extra_key extra_float_value
--eu extra_key extra_uri_value
--ecn extra_key extra_component_name_value
ComponentName
对象进行转换和传递。
--eia extra_key extra_int_value[,extra_int_value...]
--ela extra_key extra_long_value[,extra_long_value...]
--efa extra_key extra_float_value[,extra_float_value...]
--grant-read-uri-permission
FLAG_GRANT_READ_URI_PERMISSION
。
--grant-write-uri-permission
FLAG_GRANT_WRITE_URI_PERMISSION
。
--debug-log-resolution
FLAG_DEBUG_LOG_RESOLUTION
。
--exclude-stopped-packages
FLAG_EXCLUDE_STOPPED_PACKAGES
。
--include-stopped-packages
FLAG_INCLUDE_STOPPED_PACKAGES
。
--activity-brought-to-front
FLAG_ACTIVITY_BROUGHT_TO_FRONT
。
--activity-clear-top
FLAG_ACTIVITY_CLEAR_TOP
。
--activity-clear-when-task-reset
FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET
。
--activity-exclude-from-recents
FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS
。
--activity-launched-from-history
FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY
。
--activity-multiple-task
FLAG_ACTIVITY_MULTIPLE_TASK
。
--activity-no-animation
FLAG_ACTIVITY_NO_ANIMATION
。
--activity-no-history
FLAG_ACTIVITY_NO_HISTORY
。
--activity-no-user-action
FLAG_ACTIVITY_NO_USER_ACTION
。
--activity-previous-is-top
FLAG_ACTIVITY_PREVIOUS_IS_TOP
。
--activity-reorder-to-front
FLAG_ACTIVITY_REORDER_TO_FRONT
。
--activity-reset-task-if-needed
FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
。
--activity-single-top
FLAG_ACTIVITY_SINGLE_TOP
。
--activity-clear-task
FLAG_ACTIVITY_CLEAR_TASK
。
--activity-task-on-home
FLAG_ACTIVITY_TASK_ON_HOME
。
--receiver-registered-only
FLAG_RECEIVER_REGISTERED_ONLY
。
--receiver-replace-pending
FLAG_RECEIVER_REPLACE_PENDING
。
--selector
-d
和
-t
选项以设置 intent 数据和类型。
URI component package
在 adb shell 中,您可以使用软件包管理器 (pm) 工具发出命令,以对设备上安装的应用软件包进行操作和查询。在 shell 中,此语法为:
pm command
您也可以直接从 adb 发出软件包管理器命令,无需进入远程 shell。例如:
adb shell pm uninstall com.example.MyApp
命令 | 说明 |
---|
list packages [options] filter
输出所有软件包,或者,仅输出包名称包含
filter
中的文本的软件包。
选项:
-f
:查看它们的关联文件。 -d
:进行过滤以仅显示已停用的软件包。 -e
:进行过滤以仅显示已启用的软件包。 -s
:进行过滤以仅显示系统软件包。 -3
:进行过滤以仅显示第三方软件包。 -i
:查看软件包的安装程序。 -u
:也包括卸载的软件包。 --user user_id
:要查询的用户空间。 list permission-groups
输出所有已知的权限组。
list permissions [options] group
输出所有已知权限,或者,仅输出
group
中的权限。
选项:
-g
:按组加以组织。 -f
:输出所有信息。 -s
:简短摘要。 -d
:仅列出危险权限。 -u
:仅列出用户将看到的权限。 list instrumentation [options]
列出所有测试软件包。
选项:
-f
:列出用于测试软件包的 APK 文件。 target_package
:列出仅用于此应用的测试软件包。 list features
输出系统的所有功能。
list libraries
输出当前设备支持的所有库。
list users
输出系统上的所有用户。
path package
输出给定
package
的 APK 的路径。
install [options] path
将软件包(通过
path
指定)安装到系统。
选项:
-l
:安装具有转发锁定功能的软件包。 -r
:重新安装现有应用,保留其数据。 -t
:允许安装测试 APK。 -i installer_package_name
:指定安装程序软件包名称。 -s
:在共享的大容量存储(如 sdcard)上安装软件包。 -f
:在内部系统内存上安装软件包。 -d
:允许版本代码降级。 -g
:授予应用清单中列出的所有权限。 uninstall [options] package
从系统中移除软件包。
选项:
-k
:移除软件包后保留数据和缓存目录。 clear package
删除与软件包关联的所有数据。
enable package_or_component
启用给定软件包或组件(作为“package/class”写入)。
disable package_or_component
停用给定软件包或组件(作为“package/class”写入)。
disable-user [options] package_or_component
选项:
--user user_id
:要停用的用户。 grant package_name permission
向应用授予权限。在运行 Android 6.0(API 级别 23)及更高版本的设备上,可以是应用清单中声明的任何权限。在运行 Android 5.1(API 级别 22)和更低版本的设备上,必须是应用定义的可选权限。
revoke package_name permission
从应用中撤销权限。在运行 Android 6.0(API 级别 23)及更高版本的设备上,可以是应用清单中声明的任何权限。在运行 Android 5.1(API 级别 22)和更低版本的设备上,必须是应用定义的可选权限。
set-install-location location
更改默认安装位置。位置值:
0
:自动—让系统决定最佳位置。 1
:内部—安装在内部设备存储上。 2
:外部—安装在外部介质上。 注:此命令仅用于调试目的;使用此命令会导致应用中断和其他意外行为。
get-install-location
返回当前安装位置。返回值:
0 [auto]
:让系统决定最佳位置。 1 [internal]
:安装在内部设备存储上 2 [external]
:安装在外部介质上 set-permission-enforced permission [true|false]
指定是否应强制执行给定的权限。
trim-caches desired_free_space
减少缓存文件以达到给定的可用空间。
create-user user_name
使用给定的
user_name
创建新用户,输出新用户的标识符。
remove-user user_id
移除具有给定的
user_id
的用户,删除与该用户关联的所有数据。
get-max-users
输出设备支持的最大用户数。
进行屏幕截图
screencap
命令是一个用于对设备显示屏进行屏幕截图的 shell 实用程序。在 shell 中,此语法为:
screencap filename
要从命令行使用 screencap
,请输入以下命令:
$ adb shell screencap /sdcard/screen.png
以下屏幕截图会话示例向您展示使用 adb shell 捕获屏幕截图,并使用 pull
命令从设备下载此文件:
$ adb shell
shell@ $ screencap /sdcard/screen.png
shell@ $ exit
$ adb pull /sdcard/screen.png
录制视频
screenrecord
命令是一个用于录制设备(运行 Android 4.4(API 级别 19)及更高版本)显示屏的 shell 实用程序。此实用程序将屏幕 Activity 录制到 MPEG-4 文件。
注:音频不与视频文件一起录制。
开发者可以使用此文件创建宣传视频或培训视频。在 shell 中,此语法为:
screenrecord [options] filename
要从命令行使用 screenrecord
,请输入以下命令:
$ adb shell screenrecord /sdcard/demo.mp4
按 Control + C 停止屏幕录制,否则,到三分钟或 --time-limit
设置的时间限制时,录制将自动停止。
要开始录制设备屏幕,请运行 screenrecord
命令以录制视频。然后,运行 pull 命令从设备将此视频下载到主计算机。下面是一个录制会话示例:
$ adb shell
shell@ $ screenrecord --verbose /sdcard/demo.mp4
(press Control + C to stop)
shell@ $ exit
$ adb pull /sdcard/demo.mp4
screenrecord
实用程序可以任何支持的分辨率和所需的比特率进行录制,同时保留设备显示屏的纵横比。默认情况下,此实用程序以原生显示分辨率和屏幕方向进行录制,最大时长为三分钟。
下面是 screenrecord
实用程序的一些已知限制,您在使用时应注意:
选项 | 说明 |
---|
--help
显示命令语法和选项
--size widthxheight
设置视频大小:
1280x720
。默认值是设备的原生显示分辨率(如果支持),如果不支持,则使用 1280x720。为实现最佳结果,请使用设备的 Advanced Video Coding (AVC) 编码器支持的大小。
--bit-rate rate
设置视频的视频比特率(以兆比特每秒为单位)。默认值为 4Mbps。您可以增加比特率以提升视频质量,但这么做会导致影片文件变得更大。以下示例将录制比特率设为 6Mbps:
screenrecord --bit-rate 6000000 /sdcard/demo.mp4
--time-limit time
设置最大录制时长(以秒为单位)。默认值和最大值均为 180(3 分钟)。
--rotate
将输出旋转 90 度。此功能是实验性的。
--verbose
显示命令行屏幕上的日志信息。如果您不设置此选项,则运行时此实用程序不会显示任何信息。
读取应用的 ART 配置文件
从 Android 7.0(API 级别 24)开始,Android Runtime (ART) 会收集已安装应用的执行配置文件,其可用于优化应用性能。您可能想要检查收集的配置文件,以了解在应用启动期间,系统决定频繁执行哪些方法和使用哪些类。
要生成配置文件信息的文本表单,请使用以下命令:
$ adb shell cmd package dump-profiles package
要检索生成的文件,请使用:
$ adb pull /data/misc/profman/package.txt
其他 shell 命令
如需所有可用 shell 程序的列表,请使用以下命令:
adb shell ls /system/bin
大多数命令都提供帮助说明。
表 5 列出了一些比较常用的 adb shell 命令。
Shell 命令 | 说明 | 注释 |
---|
dumpsys
将系统数据转储到屏幕。
Dalvik Debug Monitor Server (DDMS) 工具提供了一个集成调试环境,让您用起来更方便。
dumpstate
将状态转储到文件。
logcat [option]... [filter-spec]...
启用系统和应用日志记录,并将输出传输到屏幕。
dmesg
将内核调试消息输出到屏幕。
start
启动(重启)模拟器/设备实例。
stop
停止执行模拟器/设备实例。
APK分析器的命令行版本提供了对构建过程完成后APK的组成的即时洞察,并允许您比较两个APKs之间的差异。通过使用APK分析器,您可以减少在应用程序中使用DEX文件和资源调试问题的时间,并减少APK的大小。
apkanalyzer 包含在 Android SDK Tools 的 android_sdk/tools/bin/apkanalyzer
或者使用AndroidStudio携带的分析工具
apkanalyzer [global-options] subject verb [options] apk-file [apk-file2]
你想要的 subject
可能是整个apk或者apk的一部分,subject 可能是下面之一:
apk:
分析apk的属性,例如:应用ID,版本号,版本名.files:
分析apk内的文件manifest:
分析apk的清单文件dex:
分析apk的DEX文件resources:
资源文件.verb
为你想知道subject
的什么,下面会介绍
每个命令都要求您指定一个APK文件。只有APK比较命令要求您指定第二个APK。只要选项是明确的,您就可以缩短每个选项。例如,--human-readable
的全局选项可以缩写为-h。下面的例子分析apk(subject)来获取它的文件大小(动词),然后以 --human-readable
的格式(-h选项)打印文件大小:
apkanalyzer -h apk file-size myapk.apk
全局选项
Option | Description |
---|---|
--human-readable | Prints sizes in human-readable format. |
下面的命令描述了subject
的结构,和verb
列表,和subject选项组合
View APK file attributes | Description |
---|---|
apk summary apk-file | 打印应用程序ID,版本号,版本名 |
Example output:
com.myapp 5 1.1-beta
apk file-size apk-file
打印apk的总文件大小
apk download-size apk-file
打印估量apk的下载的大小
apk features [--not-required] apk-file
打印apk的特性, . 增加
--not-required
选项包含不需要打印的特性.
Example output:
android.hardware.type.watch android.hardware.microphone implied: requested android.permission.RECORD_AUDIO permission
apk compare [options] apk-file apk-file2
比较
apk-file
和
apk-file2
.的大小,可以是如下选项:
--different-only
: 打印目录和文件有差异--files-only
: 不打印目录条目--patch-size
: 对文件的逐个文件进行评估,而不是原始的差异。Example output (old size / new size / size difference / path):
39086736 48855615 9768879 / 10678448 11039232 360784 /classes.dex 18968956 18968956 0 /lib/ 110576 110100 -476 /AndroidManifest.xml ...View the APK file system Description
files list apk-file
apk的文件列表
Example output:
/ /classes2.dex /classes.dex /assets/ /assets/asset.data /AndroidManifest.xml /resources.arsc /res/ ...
files cat --file path apk-file
打印文件的内容,你必须制定APK内部的文件路径,使用、
--file path
选项, 例如:
--file /AndroidManifest.xml
View information in the manifest Description
manifest print apk-file
以XML格式打印清单文件
manifest application-id apk-file
打印应用程序ID
manifest version-name apk-file
打印版本名
manifest version-code apk-file
打印版本号
manifest min-sdk apk-file
打印最小的SDK版本
manifest target-sdk apk-file
打印目标SDK版本
manifest permissions apk-file
打印权限列表
manifest debuggable apk-file
打印app是否是可调试的 Access DEX file information Description
dex list apk-file
打印这个apk的DEX列表
dex references [--files path] [--files path2] apk-file
打印指定DEX文件的方法数量,增加
--files
选项定义你想包含的文件。
Example output:
classes.dex 59598 classes2.dex 8042
dex packages [option1 option2 ...] apk-file
打印DEX树形类,在输出中,
P
,
C
,
M
, and
F
indicate packages, classes, methods, and fields, 另外. And
x
,
k
,
r
, and
d
indicate removed, kept,referenced and defined nodes, 另外.
增加下面的选项优化输出:
--defined-only
: 只包括在输出中的APK中定义的类。--files
: 指定的DEX文件名,默认是所有的DEX文件--proguard-folder file
: 指定Proguard输出文件夹来搜索映射.--proguard-mappings file
: 指定Proguard 映射文件.--proguard-seeds file
: 指定Proguard种子文件--proguard-usages file
: Specify the Proguard usages file.--show-removed
: 显示有Proguard删除的类和常量.Example output (type / state / defined methods / referenced methods / byte size / name):
P d 1 1 85 g P d 1 1 85 g.a C d 1 1 85 g.a.a M d 1 1 45 g.a.a java.lang.Object get() C r 0 1 40 byte[] M r 0 1 40 byte[] java.lang.Object clone()
dex code --class class [--method method]
以smali 格式 打印类或者方法的字节码。需要并打印完全合格的类名以进行反编译。增加
--method
选项指定反编译的方法。这反编译方法的格式是:
name(params)returnType
, for example,
someMethod(Ljava/lang/String;I)V
. View resources stored in res/ and resources.arsc Description
resources packages
打印资源表中定义的包的列表。
resources configs --type type [--package package] apk-file
打印指定
type
.配置列表,这个
type
是一个资源类型,例如:
string
. 包含
--package
选项,如果你想指定资源包名, 否则,将使用第一个已定义的包名。.
resources value --config config --name name --type type [--package package] apk-file
打印通过
config
name
, and
type
指定的资源值, . The
type
选项是一个资源类型,例如:
string
. 包含
--package
选项,如果你想指定资源包名, 否则,将使用第一个已定义的包名。..
resources names --config config --type type [--package package] apk-file
为一个配置和类型打印资源列表.
type
选项是一个资源类型,例如:
string
. 包含
--package
选项,如果你想指定资源包名, 否则,将使用第一个已定义的包名。
resources xml --file path apk-file
以二进制XML形式打印 human-readable. 包含
file
选项指定文件路径