全部开发者教程

Android SDK 工具介绍

从本小节开始我们将介绍 Android SDK 中包含的众多命令行工具,包括 SDK 工具、构建工具、平台工具、模拟器工具、分析工具。本小节我们学习 SDK 工具。

1. 概述

Android SDK 工具位于以下位置:android_sdk/tools/bin/

主要的命令行工具有如下这些:

  • apkanalyzer
    用于在构建过程完成后深入分析我们的 APK 组成。

  • avdmanager
    可让我们从命令行创建和管理 Android 虚拟设备 (AVD)。

  • sdkmanager
    可让我们查看、安装、更新和卸载 Android SDK 的软件包。

  • jobb
    可以让我们构建不透明二进制 Blob (OBB) 格式的已加密和未加密 APK 扩展文件。

2. apkanalyzer

使用 APK 分析器的命令行版本,我们可以在构建流程完成后立即了解 APK 的组成,并且可以比较两个 APK 之间的差异。使用 APK 分析器可以减少调试应用中的 DEX 文件和资源相关问题所花费的时间,并减小 APK 的大小。

2.1 语法

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:查看文本、图片和字符串资源。

以下示例会分析 apk (subject) 以获取其 file-size (verb),然后以简单易懂的格式(-h 选项)输出文件大小:

apkanalyzer -h apk file-size myapk.apk

2.2 全局选项

选项 说明
–human-readable 以简单易懂的格式输出大小。

2.3 命令选项

以下命令说明按 subject 整理,并列出了每个 subject 适用的 verb 和选项组合。

  • 查看 APK 文件属性
命令选项 说明
apk summary 输出应用 ID、版本代码和版本名称。
apk file-size 输出 APK 的总文件大小。
apk download-size 输出 APK 的下载大小估计值。
apk features 输出 APK 用来触发 Play 商店过滤的功能。
apk compare 比较 apk-file 和 apk-file2 的大小。
--different-only:输出存在差异的目录和文件。
--files-only:不输出目录条目。
--patch-size:显示逐个文件的补丁程序大小估计值,而不是原始差异。
  • **查看 APK 文件系统 **
命令选项 说明
files list 列出 APK 中的所有文件。
files cat --file 输出文件内容。必须使用 --file path 选项指定 APK 内的路径。
  • 查看清单中的信息
命令选项 说明
manifest print 以 XML 格式输出 APK 清单。
manifest application-id 输出应用 ID 值。
manifest version-name 输出版本名称值。
manifest version-code 输出版本代码值。
manifest min-sdk 输出最低 SDK 版本。
manifest target-sdk 输出目标 SDK 版本。
manifest permissions 输出权限列表。
manifest debuggable 输出应用是否可调试。
  • 访问 DEX 文件信息
命令选项 说明
dex list 输出 APK 中的 DEX 文件列表。
dex references 输出指定 DEX 文件中的方法引用数。
dex packages 输出 DEX 中的类树。在输出中,P、C、M 和 F 分别表示软件包、类、方法和字段。–defined-only:在输出中仅包含 APK 中定义的类。
–files:指定要包含的 DEX 文件名。默认:所有 DEX 文件。
–proguard-folder file:指定用于搜索映射的 Proguard 输出文件夹。
–proguard-mappings file:指定 Proguard 映射文件。
–proguard-seeds file:指定 Proguard 种子文件。
–proguard-usages file:指定 Proguard 用法文件。
dex code --class 以 smali 格式输出类或方法的字节码。输出中必须包含类名,并且要输出完全限定类名以进行反编译。
  • 看存储在 APK 的资源
命令选项 说明
resources packages 输出资源表中定义的软件包列表。
resources configs --type 输出指定 type 的配置列表。type 是资源类型,如 string。
resources value --config --name --type 输出由 config、name 和 type 指定的资源的值。
resources names --config --type 输出属于某种配置和类型的资源名称列表。
resources xml --file 以简单易懂的形式输出 XML 二进制文件。

3. avdmanager

avdmanager 是一个命令行工具,可让我们从命令行创建和管理 Android 虚拟设备 (AVD)。借助 AVD,我们可以定义要在 Android 模拟器中模拟的 Android 手机、Wear OS 手表或 Android TV 设备的特性。

3.1 语法

avdmanager [global options] command [command options]

3.2 全局选项

选项 说明
-s 静默模式:仅输出错误。
-h 使用帮助。
-v 详细模式:输出错误、警告和参考性消息。

3.3 命令选项

命令选项 说明
create avd -n name -k “sdk_id” [-c] [-f] [-p] 创建一个新的 AVD。必须为该 AVD 提供一个名称,并使用加引号的 sdk_id 指定要用于该 AVD 的 SDK 软件包的 ID。
-c:此 AVD 的 SD 卡映像的路径,或要为此 AVD 创建的新 SD 卡映像的大小。
-f:强制创建 AVD。
-p:将从中创建此 AVD 的文件的目录所在位置的路径。
delete avd -n 删除一个 AVD。必须使用 name 指定该 AVD。
move avd -n name [-p] [-r] 移动和/或重命名一个 AVD。必须使用 name 指定该 AVD。
-p:用于接收此 AVD 的文件的目录所在位置的绝对路径。
-r:AVD 的新名称。
list 列出所有可用的目标、设备定义或 AVD。

4. sdkmanager

sdkmanager 是一个命令行工具,我们可以用它来查看、安装、更新和卸载 Android SDK 的软件包。

4.1 语法

  • 列出已安装和可用的软件包
sdkmanager --list [options]
  • 安装软件包
sdkmanager packages [options]

packages 参数是 --list 命令列出的 SDK 式的路径,这些路径括在引号中(例如 “build-tools;29.0.2” 或 “platforms;android-28”)。
例如,下面展示了如何安装最新的平台工具(包括 adb 和 fastboot)以及适用于 API 级别 28 的 SDK 工具:

sdkmanager "platform-tools" "platforms;android-28"
  • 更新所有已安装的软件包
sdkmanager --update [options]

4.2 命令选项

命令选项 说明
–sdk_root 使用指定的 SDK 路径而不是包含此工具的 SDK。
–channel 包含从 channel_0 到 channel_id 所有渠道中的软件包。
可用的渠道包括:0(稳定版)、1(测试版)、2(开发版)和 3(Canary 版)。
–include_obsolete 在列出或更新软件包时纳入那些已过时的软件包。
–no_https 强制所有连接使用 HTTP 而不是 HTTPS。
–verbose 详细输出模式。该模式会输出错误、警告和参考性消息。
–proxy 通过给定类型的代理建立连接:用 http 指定一个高层级协议(如 HTTP 或 FTP)的代理,或用 socks 指定一个 SOCKS(V4 或 V5)代理。
–proxy_host 要使用的代理的 IP 或 DNS 地址。
–proxy_port 要连接到的代理端口号。

5. jobb

借助 jobb 工具,我们可以构建不透明二进制 Blob (OBB) 格式的已加密和未加密 APK 扩展文件。我们可以在搭载 Android 2.3(API 级别 9)或更高版本的设备上使用 StorageManager 在应用中下载和装载这些扩展文件。OBB 文件用于为 Android 应用提供额外文件资源(例如图形、音频和视频),这些文件资源与应用的 APK 文件是分开的。

5.1 语法

jobb [-d <directory>][-o <filename>][-pn <package>][-pv <version>] \
     [-k <key>][-ov][-dump <filename>][-v][-about]

以下示例命令会从源文件创建 OBB 文件:

jobb -d /temp/assets/ -o my-app-assets.obb -k secret-key -pn com.my.app.package -pv 11

以下示例展示了如何转储(提取)现有 OBB 文件的内容:

jobb -d /temp/obb-output/ -o my-app-assets.obb -k secret-key

5.2 命令选项

命令选项 说明
-d 设置创建 OBB 文件时所用的输入目录,或提取 (-dump) 现有文件时所用的输出目录。创建 OBB 文件时,指定目录及其所有子目录的内容都将包含在 OBB 文件系统中。
-o 指定 OBB 文件的文件名。创建 OBB 和提取(转储)其内容时,必须提供此参数。
-pn 指定装载 OBB 文件的应用的软件包名称,该名称对应于应用清单中指定的 package 值。创建 OBB 文件时,必须提供此参数。
-pv 设置可装载 OBB 文件的应用的最低版本,这对应于应用清单中的 android:versionCode 值。创建 OBB 文件时,必须提供此参数。
-k 指定用于加密新 OBB 文件或解密现有的已加密 OBB 文件的密码。
-ov 创建叠加在现有 OBB 文件结构上的 OBB 文件。该选项可让我们将新文件包的内容装载到先前的文件包所在的位置,旨在用于创建之前生成的 OBB 文件的补丁版本。
-dump 提取指定 OBB 文件的内容。
-v 设置该工具的详细输出。
-about 显示 jobb 工具的版本和帮助信息。

6. 小结

本节课程我们主要学习了 Android SDK 命令行工具。本节课程的重点如下:

  • 掌握如何使用 Android SDK 命令行工具。