使用 Android Debug Bridge

ADB全称 Android Debug Bridge,是 Android 的命令行调试工具。可以完成多种功能,如跟踪系统日志,上传下载文件,安装应用等。

Windows、Ubuntu、macOS均可使用ADB工具调试Android。

硬件连接

使用ADB时,硬件连接需要按照如下步骤

adb-connection

准备ADB连接

  1. 准备一根USB TYPE C线,一端为USB TYPE A,用于连接PC,一端为USB TYPE C,用于连接edge2。
  2. edge2 开机,在edge2系统中打开设置(Settings) -> 关于平板电脑(About tablet) -> 连续点击7下版本号(Build number)。
  3. 在edge2系统中打开设置(Settings) -> 系统(System) -> 高级(Advance) -> 开发者选项(Developer options)。
  4. 勾选 “USB 调试(USB debugging)” 选项(默认已勾选)。
  5. 基于PC(Windows、Ubuntu、Mac os)安装adb驱动和命令。

adb-developeroptions-usbdebugging

查看adb连接状态

edge2 adb 连接成功后会显示 USB debugging connected

adb-edge2-show

PC(windows、ubuntu、Mac os)可通过adb 命令查看状态

$ adb devices
List of devices attached
IOO2TDRJNA    device

$ adb shell
mixtile_edge2:/ $
mixtile_edge2:/ $
mixtile_edge2:/ $

windows上安装ADB

windows上调试android,需要安装adb工具

下载ADB工具

下载ADB工具

安装ADB工具

按照如下步骤:

  1. 将文件下载下来,解压缩到自定义的安装目录,例如C:\adb\platform-tools

  2. 按键windows+r打开运行,输入sysdm.cpl,回车。按顺序点击->高级->环境变量->系统变量->Path

  3. 在Path下新建C:\adb\platform-tools

验证ADB连接状态

windows可以通过如下adb命令,验证adb是否连接成功。

C:\Users\xxx> adb devices
List of devices attached
IOO2TDRJNA      device

C:\Users\xxx> adb shell
mixtile_edge2:/ $
mixtile_edge2:/ $
mixtile_edge2:/ $

ubuntu上安装ADB

ubuntu上调试android,需安装ADB工具。

安装ADB工具

ubuntu上安装ADB工具,参考如下命令。

sudo apt-get update
sudo apt-get install android-tools-adb

验证ADB连接状态

参考windows上安装ADB章节下验证ADB连接状态

$ adb devices
List of devices attached
IOO2TDRJNA    device

$ adb shell
mixtile_edge2:/ $
mixtile_edge2:/ $
mixtile_edge2:/ $

Mac os上安装ADB

Mac os上调试android,需要安装ADB工具。

安装ADB工具

Mac os上安装ADB工具,参考如下命令。

brew cask install android-platform-tools

验证ADB连接状态

参考windows上安装ADB章节下验证ADB连接状态

$ adb devices
List of devices attached
IOO2TDRJNA    device

$ adb shell
mixtile_edge2:/ $
mixtile_edge2:/ $
mixtile_edge2:/ $

常用ADB命令

连接管理

列出所有连接设备及其序列号:

adb devices

如果有多个连接设备,则需要使用序列号来区分:

export ANDROID_SERIAL=<设备序列号>
adb shell ls

多设备下连接指定设备

adb -s 序列号 shell

可以通过网络来连接 ADB:

# 让设备端的 adbd 重启,并在 TCP 端口 5555 处监听
adb tcpip 5555
# 此时可以断开 USB 连接
# 远程连接设备,设备的 IP 地址是 192.168.1.100
adb connect 192.168.1.100:5555
# 断开连接
adb disconnect 192.168.1.100:5555

调试

通过ADB工具,可以获取Android运行时调试信息。

获取系统日志 adb logcat

adb logcat [选项] [应用标签]

示例

# 查看全部日志
adb logcat
# 仅查看部分日志
adb logcat -s WifiStateMachine StateMachine

运行命令 adb shell

获取详细运行信息

adb bugreport 用于错误报告,里面包含大量有用的信息。

示例

db bugreport
# 保存到本地,方便用编辑器查看
adb bugreport >bugreport.txt

root 权限

如果 TARGET_BUILD_VARIANT 使用的是 userdebug 模式,要获得 root 权限,需要先运行:

adb root

让 ADB 的设备端切换到 root 权限模式,这样 adb remount 等需要 root 权限的命令才会成功。

应用管理

通过ADB工具,可以安装应用,卸载应用。

安装应用

adb install [选项] 应用包.apk

选项包括:

-l forward-lock
-r 重新安装应用,保留原先数据
-s 安装到 SD 卡上,而不是内部存储

示例:

# 安装 facebook.apk
adb install facebook.apk
# 升级 twitter.apk
adb install -r twitter.apk

如果安装成功,工具会返回成功提示 Success;失败的话,一般是以下几种情况:

  • INSTALL_FAILED_ALREADY_EXISTS: 此时需要用 -r 参数来重新安装。
  • INSTALL_FAILED_SIGNATURE_ERROR: 应用的签名不一致,可能是发布版和调试版签名不同所致。如果确认 APK 文件签名正常,可以用 adb uninstall 命令先卸载旧的应用,然后再安装。
  • INSTALL_FAILED_INSUFFICIENT_STORAGE: 存储空间不足,需要检查设备存储情况。

卸载应用

adb uninstall 应用包名称

示例:

adb uninstall com.android.chrome

应用包名称可以用以下命令列出:

adb shell pm list packages -f

运行结果是:

package:/system/app/Bluetooth.apk=com.android.bluetooth

前面是 apk 文件,后面则是对应的包名称。

命令行帮助信息

Android Debug Bridge version 1.0.31

 -a                            - directs adb to listen on all interfaces for a connection
 -d                            - directs command to the only connected USB device
                                 returns an error if more than one USB device is present.
 -e                            - directs command to the only running emulator.
                                 returns an error if more than one emulator is running.
 -s <specific device>          - directs command to the device or emulator with the given
                                 serial number or qualifier. Overrides ANDROID_SERIAL
                                 environment variable.
 -p <product name or path>     - simple product name like 'sooner', or
                                 a relative/absolute path to a product
                                 out directory like 'out/target/product/sooner'.
                                 If -p is not specified, the ANDROID_PRODUCT_OUT
                                 environment variable is used, which must
                                 be an absolute path.
 -H                            - Name of adb server host (default: localhost)
 -P                            - Port of adb server (default: 5037)
 devices [-l]                  - list all connected devices
                                 ('-l' will also list device qualifiers)
 connect <host>[:<port>]       - connect to a device via TCP/IP
                                 Port 5555 is used by default if no port number is specified.
 disconnect [<host>[:<port>]]  - disconnect from a TCP/IP device.
                                 Port 5555 is used by default if no port number is specified.
                                 Using this command with no additional arguments
                                 will disconnect from all connected TCP/IP devices.

device commands:
  adb push [-p] <local> <remote>
                               - copy file/dir to device
                                 ('-p' to display the transfer progress)
  adb pull [-p] [-a] <remote> [<local>]
                               - copy file/dir from device
                                 ('-p' to display the transfer progress)
                                 ('-a' means copy timestamp and mode)
  adb sync [ <directory> ]     - copy host->device only if changed
                                 (-l means list but don't copy)
                                 (see 'adb help all')
  adb shell                    - run remote shell interactively
  adb shell <command>          - run remote shell command
  adb emu <command>            - run emulator console command
  adb logcat [ <filter-spec> ] - View device log
  adb forward --list           - list all forward socket connections.
                                 the format is a list of lines with the following format:
                                    <serial> " " <local> " " <remote> "\n"
  adb forward <local> <remote> - forward socket connections
                                 forward specs are one of:
                                   tcp:<port>
                                   localabstract:<unix domain socket name>
                                   localreserved:<unix domain socket name>
                                   localfilesystem:<unix domain socket name>
                                   dev:<character device name>
                                   jdwp:<process pid> (remote only)
  adb forward --no-rebind <local> <remote>
                               - same as 'adb forward <local> <remote>' but fails
                                 if <local> is already forwarded
  adb forward --remove <local> - remove a specific forward socket connection
  adb forward --remove-all     - remove all forward socket connections
  adb jdwp                     - list PIDs of processes hosting a JDWP transport
  adb install [-l] [-r] [-d] [-s] [--algo <algorithm name> --key <hex-encoded key> --iv <hex-encoded iv>] <file>
                               - push this package file to the device and install it
                                 ('-l' means forward-lock the app)
                                 ('-r' means reinstall the app, keeping its data)
                                 ('-d' means allow version code downgrade)
                                 ('-s' means install on SD card instead of internal storage)
                                 ('--algo', '--key', and '--iv' mean the file is encrypted already)
  adb uninstall [-k] <package> - remove this app package from the device
                                 ('-k' means keep the data and cache directories)
  adb bugreport                - return all information from the device
                                 that should be included in a bug report.

  adb backup [-f <file>] [-apk|-noapk] [-obb|-noobb] [-shared|-noshared] [-all] [-system|-nosystem] [<packages...>]
                               - write an archive of the device's data to <file>.
                                 If no -f option is supplied then the data is written
                                 to "backup.ab" in the current directory.
                                 (-apk|-noapk enable/disable backup of the .apks themselves
                                    in the archive; the default is noapk.)
                                 (-obb|-noobb enable/disable backup of any installed apk expansion
                                    (aka .obb) files associated with each application; the default
                                    is noobb.)
                                 (-shared|-noshared enable/disable backup of the device's
                                    shared storage / SD card contents; the default is noshared.)
                                 (-all means to back up all installed applications)
                                 (-system|-nosystem toggles whether -all automatically includes
                                    system applications; the default is to include system apps)
                                 (<packages...> is the list of applications to be backed up.  If
                                    the -all or -shared flags are passed, then the package
                                    list is optional.  Applications explicitly given on the
                                    command line will be included even if -nosystem would
                                    ordinarily cause them to be omitted.)

  adb restore <file>           - restore device contents from the <file> backup archive

  adb help                     - show this help message
  adb version                  - show version num

scripting:
  adb wait-for-device          - block until device is online
  adb start-server             - ensure that there is a server running
  adb kill-server              - kill the server if it is running
  adb get-state                - prints: offline | bootloader | device
  adb get-serialno             - prints: <serial-number>
  adb get-devpath              - prints: <device-path>
  adb status-window            - continuously print device status for a specified device
  adb remount                  - remounts the /system partition on the device read-write
  adb reboot [bootloader|recovery] - reboots the device, optionally into the bootloader or recovery program
  adb reboot-bootloader        - reboots the device into the bootloader
  adb root                     - restarts the adbd daemon with root permissions
  adb usb                      - restarts the adbd daemon listening on USB
  adb tcpip <port>             - restarts the adbd daemon listening on TCP on the specified port
networking:
  adb ppp <tty> [parameters]   - Run PPP over USB.
 Note: you should not automatically start a PPP connection.
 <tty> refers to the tty for PPP stream. Eg. dev:/dev/omap_csmi_tty1
 [parameters] - Eg. defaultroute debug dump local notty usepeerdns

adb sync notes: adb sync [ <directory> ]
  <localdir> can be interpreted in several ways:

  - If <directory> is not specified, both /system and /data partitions will be updated.

  - If it is "system" or "data", only the corresponding partition
    is updated.

environmental variables:
  ADB_TRACE                    - Print debug information. A comma separated list of the following values
                                 1 or all, adb, sockets, packets, rwx, usb, sync, sysdeps, transport, jdwp
  ANDROID_SERIAL               - The serial number to connect to. -s takes priority over this if given.
  ANDROID_LOG_TAGS             - When used with the logcat option, only these debug tags are printed.