企业官网建设流程全解析

• 文档
• 教程
• 知识库

aapt（Android Asset Packaging Tool，Android 资源打包工具）是 Android 开发者日常排查与打包 APK 时的高频命令行工具。本文以 tldr 仓库中维护的 aapt 速查页（英文版与孟加拉语版）为核心骨架，完整讲解其三大核心操作——归档内容列举、应用元数据查看与 APK 打包生成，并结合仓库的页面格式规范与翻译约定，说明每条命令的参数语义与占位符写法。读完本文，你将能直接上手用aapt完成 APK 内容的快速检视与最小化打包。

aapt 是什么：Android 资源打包工具

aapt的全称是 Android Asset Packaging Tool，用于编译并打包一个 Android 应用（App）的资源（assets）。在 tldr 速查页中，它的定位被一句话概括为：

Android Asset Packaging Tool：将一个 Android App 的资源进行编译与打包的工具。

它面向 APK 归档（.apk文件）提供三种最常见的操作：查看归档内部文件清单、读取应用元数据（版本、权限等）、从目录直接打包生成新的 APK 归档。tldr 页面将这三种能力分别映射为list、dump badging、package -F三个子命令，构成一份“即查即用”的命令速查。

文档定位：一份跨语言的 tldr 速查页

在 tldr 仓库中，aapt 页面存放于pages/common/目录（pages/common/aapt.md），表示它属于跨平台通用命令；其孟加拉语翻译版则位于pages.bn/common/。两份页面在结构上完全对齐，遵循仓库风格指南规定的统一模板：

• 第 1 行：#标题，与命令名完全一致（aapt）；
• >开头：一段简洁的命令描述，不重复标题本身；
• >开头：More information信息链接（本页指向 aapt 的 man 手册页）；
• 后续每个例子由一行-开头的祈使句描述 + 一个反引号包裹的示例命令构成。

该模板在风格指南中被规定为每页最多 8 个示例，aapt页面的 3 个示例即在此约束下选取了最常用的操作。

操作一：aapt list列出 APK 归档内容

aapt list {{path/to/app}}.apk

孟加拉语版等价写法为：

aapt list {{app/এর/পাথ}}.apk

命令语义：list子命令读取指定 APK 归档（本质是一个 zip 压缩包），并将归档内部包含的文件条目逐一打印到终端。它的典型用途是在不展开压缩包的前提下快速确认 APK 内包含哪些文件——例如验证打包产物是否包含了预期的资源、classes.dex、AndroidManifest.xml等。

参数说明：唯一的参数是 APK 文件的路径。tldr 示例中使用了{{...}}占位符语法（详见下文“占位符规范”一节），{{path/to/app}}表示“app 的路径”，需要使用者替换为真实路径；.apk扩展名保留在占位符之外，表示该扩展名是该命令的固定输入格式。

操作二：aapt dump badging查看应用元数据

aapt dump badging {{path/to/app}}.apk

孟加拉语版：

aapt dump badging {{app/এর/পাথ}}.apk

命令语义：dump子命令用于输出 APK 中记录的包信息，而badging是其中最常见的一种 dump 模式。它以键值文本的形式输出应用的版本信息（如版本名、版本号）、权限声明（permissions）、包名、启动 Activity 等元数据，正对应页面上“查看一个应用的元数据（版本、权限等）”的描述。这在发布前核对包签名信息、排查权限声明是否正确、确认目标 SDK 版本等场景中非常实用。

参数说明：同样只需一个 APK 路径参数。与list不同，dump badging关注的是归档内部的元数据字段而非文件清单，二者互补构成对 APK 的两种“只读检视”手段。

操作三：aapt package -F从指定目录生成 APK

aapt package -F {{path/to/app}}.apk {{path/to/directory}}

孟加拉语版：

aapt package -F {{app/এর/পাথ}}.apk {{ডিরেক্টরি/এর/পাথ}}

命令语义：package子命令用于打包。-F选项（Force/final output file）指定打包产物的输出文件路径，即生成的 APK 归档；第二个位置参数指定输入目录，aapt会将该目录下的文件归档为一个新的 APK。示例中“使用指定目录中的文件创建一个新的 APK 归档”正是对这一流程的概括。

参数说明：

• -F后跟输出 APK 的路径，占位符写作{{path/to/app}}.apk；
• 目录参数写作{{path/to/directory}}（孟加拉语版为{{ডিরেক্টরি/এর/পাথ}}）。

需要说明的是，tldr 页面给出的是最精简的打包形式；在实际工程构建流程中，aapt package通常还会涉及 Manifest、资源目录等更多输入与选项，具体可查阅 aapt 的 man 手册页。本示例的价值在于演示最小可用的 APK 归档生成路径，便于理解-F与目录输入两个核心参数的作用。

占位符规范：{{}}语法与翻译约定

tldr 页面用{{...}}标记需要用户自行替换的值，客户端可据此对占位符做高亮。风格指南对这一语法有明确要求：文件路径统一写作{{path/to/placeholder}}的形态；若位置隐含则省略；扩展名若为固定格式则放在占位符之外。aapt 页面中的{{path/to/app}}.apk正是“路径占位 + 固定.apk扩展名”的标准写法。

对于非英语页面，占位符内容需要按语言翻译。翻译模板维护了一张跨语言常用占位符对照表，其中孟加拉语（bn）一行的对照关系为：

aapt 孟加拉语页中的{{app/এর/পাথ}}即path/to/app的本地化变体，{{ডিরেক্টরি/এর/পাথ}}对应path/to/directory，与翻译模板保持术语一致。这种“英文页与各语言页结构对齐、仅替换占位符与描述文本”的模式，是整个 tldr 仓库多语言维护的基础。

检查与验证：如何校验页面格式

如果你想确认或扩展此类速查页，仓库风格指南给出了两种本地校验手段：

• 使用 linter 校验页面格式是否符合模板约束：

npm install --global tldr-lint tldr-lint path/to/tldr_page.md

• 使用客户端本地渲染预览页面效果：

tldr --render path/to/tldr_page.md

这两种方式与 CI 中自动运行的检查一致，可用于验证新页面或翻译页是否满足“标题与命令名一致、描述使用祈使句、占位符语法正确、示例不超过 8 条”等规范。

小结

围绕 tldr 的 aapt 速查页，你可以用三条命令覆盖 APK 生命周期中最常用的检视与打包动作：aapt list看内容、aapt dump badging读元数据、aapt package -F出归档。结合英文原页、孟加拉语翻译页以及仓库的风格指南与翻译模板，既能看到命令本身，也能理解 tldr 在跨语言场景下如何保持信息一致与格式规范。

• 文档
• 教程
• 知识库