Android SDK: aapt 命令的使用（查看apk内容和配置信息、添加/删除apk内的文件、压缩/预处理PNG等）

「爱情、让人受尽委屈。」 2021-09-22 21:14 1068阅读 0赞

本文链接: [https://blog.csdn.net/xietansheng/article/details/87799327][https_blog.csdn.net_xietansheng_article_details_87799327]

## 0. aapt 简介 ##

`aapt`（Android Asset Packaging Tool）是 Android 资源打包工具。aapt 的主要作用是吧 Android 的各类资源（图片、布局文件、源码等）经过处理打成 apk 安装包。对与已生成的 apk 包，可以通过 aapt 工具详细查看包内的各项信息（包名、APP名称、APP图标、APP版本信息、SDK版本信息、权限列表等），还可对包内已编译的 xml 进行反编译输出，还可以对 apk 包进行修改（添加或删除文件，修改过的 apk 包需要重新签名和对齐）。

aapt 命令文件在 Android SDK 的 `{Android_SDK}/build-tools/version` 目录下，执行`aapt`<Enter> 查看详细的帮助信息。

## 1. 查看 APK 包内的文件：aapt l\[list\] ##

列出 APK（zip 格式压缩包）文件内的所有压缩条目。

语法格式：

aapt l[ist] [-v] [-a] file.{ zip,jar,apk}
    
    参数: -v      详细输出每一个压缩文件的详细信息（包括大小, 压缩率, 日期时间, 条目名称等）

实例：

$ aapt l demo.apk
    AndroidManifest.xml
    META-INF/CERT.RSA
    META-INF/CERT.SF
    META-INF/CHANGES
    META-INF/MANIFEST.MF
    ...
    res/layout/activity_main.xml
    res/mipmap-xhdpi-v4/ic_launcher.png
    res/mipmap-xhdpi-v4/ic_like.png
    
    
    $ aapt l -v demo.apk
    Archive:  demo.apk
     Length   Method    Size  Ratio   Offset      Date  Time  CRC-32    Name
    --------  ------  ------- -----  -------      ----  ----  ------    ----
       37540  Deflate    6852  82%         0  11-30-79 00:00  70397bae  AndroidManifest.xml
         987  Deflate     666  33%      6901  11-30-79 00:00  51944c96  META-INF/CERT.RSA
      288921  Deflate  104259  64%      7614  11-30-79 00:00  7935be0c  META-INF/CERT.SF
       39533  Deflate   12391  69%    111919  11-30-79 00:00  3df4ff23  META-INF/CHANGES
      288859  Deflate  102333  65%    124356  11-30-79 00:00  3bd85efc  META-INF/MANIFEST.MF
    ...
        2380  Deflate     702  71%  17421681  11-30-79 00:00  fffffffff423a01b  res/layout/activity_main.xml
        1998  Stored     1998   0%  18166854  11-30-79 00:00  ffffffffe77beedd  res/mipmap-xhdpi-v4/ic_launcher.png
        1569  Stored     1569   0%  18168926  11-30-79 00:00  ffffffff9f7b2095  res/mipmap-xhdpi-v4/ic_like.png
    --------          -------  ---                            -------
    42365544          19627133 54%                            2491 files

**PS:** apk 文件是标准的 zip 压缩包，如果需要导出 apk 包中的某个文件（例如 应用的图标），可以使用操作 zip 压缩包的相关命令工具解压。

## 2. 查看 APK 包的配置信息：aapt d\[ump\] ##

语法格式：

aapt d[ump] [--values] [--include-meta-data] WHAT file.{ apk} [asset [asset ...]]
    
    参数:
        --values                "dump resources" 命令时使用, 结果包括资源字段对应的值
        --include-meta-data     "dump badging" 命令时使用, 结果包括 meta-data 标签
        asset                   指定具体的资源名称（xmltree 和 xmlstrings 操作时需要指定）
    
    WHAT 参数:
        strings         打印 APK 资源表字符串池中的内容（xml中定义的字符串(只包括值), res资源的路径等组成）。
        
        badging         打印 APK 中声明的应用的标签和图标（包名、版本、SDK版本、权限、应用名称、应用图标的路径）, 
                        以 key:value 的形式逐行输出。
        
        permissions     打印 APK 中声明的权限列表（包括 声明需要的权限 和 声明的自定义权限）。
        
        resources       打印 APK 中的资源表（在 res 资源文件夹下定义的 id、layout、string、dimen、
                        color、attr、style、mipmap、drawable、anim）。
        
        configurations  打印 APK 的 配置信息（打印的内容很少: 支持的屏幕类型、区域码等）。
        
        xmltree         打印 APK 中已编译的 xml 资源的内容（即反编译）, 需要指定具体资源路径名称。
        
        xmlstrings      打印 APK 中已编译的 xml 资源中的所有字符串（元素名称、属性名称、属性值等组成）, 
                        需要指定具体资源路径名称。

实例（常用的其中 3 个命令的输出内容预览）：

#
    # 查看 APK 的配置信息（结果第1行为包名版本等信息）
    #
    $ aapt d badging demo.apk
    package: name='com.xiets.demo' versionCode='1' versionName='1.0' compileSdkVersion='28' compileSdkVersionCodename='9'
    sdkVersion:'16'
    targetSdkVersion:'28'
    uses-permission: name='android.permission.INTERNET'
    uses-permission: name='android.permission.READ_PHONE_STATE'
    uses-permission: name='android.permission.READ_EXTERNAL_STORAGE'
    ...
    application-label:'Demo'
    application-label-es-US:'Demo'
    application-label-zh-CN:'Demo'
    ...
    application-icon-320:'res/mipmap-xhdpi-v4/ic_launcher.png'
    application-icon-480:'res/mipmap-xxhdpi-v4/ic_launcher.png'
    application-icon-640:'res/mipmap-xxxhdpi-v4/ic_launcher.png'
    ...
    application: label='Demo' icon='res/mipmap-hdpi-v4/ic_launcher.png'
    launchable-activity: name='com.xiets.demo.MainActivity'  label='' icon=''
    ...
    supports-screens: 'small' 'normal' 'large' 'xlarge'
    supports-any-density: 'true'
    ...
    supports-screens: 'small' 'normal' 'large' 'xlarge'
    supports-any-density: 'true'
    locales: '--_--' 'es' 'es-US' 'zh-CN' ...
    densities: '160' '240' '320' '480' '640' '65534'
    native-code: 'armeabi' 'armeabi-v7a' 'mips' 'x86'
    
    
    #
    # 查看 APK 的权限列表
    #
    $ aapt d permissions demo.apk
    package: com.xiets.demo
    uses-permission: name='android.permission.INTERNET'
    uses-permission: name='android.permission.READ_PHONE_STATE'
    uses-permission: name='android.permission.READ_EXTERNAL_STORAGE'
    ...
    
    
    #
    # 反编译 APK 内的 xml 文件
    #
    $ aapt d xmltree demo.apk AndroidManifest.xml
    N: android=http://schemas.android.com/apk/res/android
      E: manifest (line=2)
        A: android:versionCode(0x0101021b)=(type 0x10)0x1
        A: android:versionName(0x0101021c)="1.0" (Raw: "1.0")
        A: android:compileSdkVersion(0x01010572)=(type 0x10)0x1c
        A: android:compileSdkVersionCodename(0x01010573)="9" (Raw: "9")
        A: package="com.xiets.demo" (Raw: "com.xiets.demo")
        A: platformBuildVersionCode=(type 0x10)0x1
        A: platformBuildVersionName=(type 0x4)0x3f800000
        E: uses-sdk (line=7)
          A: android:minSdkVersion(0x0101020c)=(type 0x10)0x10
          A: android:targetSdkVersion(0x01010270)=(type 0x10)0x1c
        E: uses-permission (line=11)
          A: android:name(0x01010003)="android.permission.INTERNET" (Raw: "android.permission.INTERNET")
        E: application (line=14)
          A: android:theme(0x01010000)=@0x7f0c0005
          A: android:label(0x01010001)=@0x7f0b0027
          A: android:icon(0x01010002)=@0x7f0a0000
          A: android:allowBackup(0x01010280)=(type 0x12)0x0
          A: android:roundIcon(0x0101052c)=@0x7f0a0001
          E: activity (line=23)
            A: android:name(0x01010003)="com.xiets.demo.MainActivity" (Raw: "com.xiets.demo.MainActivity")
            E: intent-filter (line=24)
              E: action (line=25)
                A: android:name(0x01010003)="android.intent.action.MAIN" (Raw: "android.intent.action.MAIN")
              E: category (line=27)
                A: android:name(0x01010003)="android.intent.category.LAUNCHER" (Raw: "android.intent.category.LAUNCHER")

## 3. 打包 Android 资源：aapt p\[ackage\] ##

将 Android 的 AndroidManifest.xml、assets、res(png, xml等)、jar、dex 等各类资源打包成一个 apk 安装包。

语法格式：

aapt p[ackage] [-d][-f][-m][-u][-v][-x][-z][-M AndroidManifest.xml] \
            [-0 extension [-0 extension ...]] [-g tolerance] [-j jarfile] \
            [--debug-mode] [--min-sdk-version VAL] [--target-sdk-version VAL] \
            [--app-version VAL] [--app-version-name TEXT] [--custom-package VAL] \
            [--rename-manifest-package PACKAGE] \
            [--rename-instrumentation-target-package PACKAGE] \
            [--utf16] [--auto-add-overlay] \
            [--max-res-version VAL] \
            [-I base-package [-I base-package ...]] \
            [-A asset-source-dir]  [-G class-list-file] [-P public-definitions-file] \
            [-D main-dex-class-list-file] \
            [-S resource-sources [-S resource-sources ...]] \
            [-F apk-file] [-J R-file-dir] \
            [--product product1,product2,...] \
            [-c CONFIGS] [--preferred-density DENSITY] \
            [--split CONFIGS [--split CONFIGS]] \
            [--feature-of package [--feature-after package]] \
            [raw-files-dir [raw-files-dir] ...] \
            [--output-text-symbols DIR]
    
        打包 Android 资源。该命令将读取以 -M -A -S 或 raw-files-dir 参数提供的 assets 和 res。
        -J -P -F 和 -R 选项控制哪些文件被输出。

`aapt p`打包命令较复杂，控制台输入`aapt`<Enter> 在输出的最后可详细查看各参数的具体说明，这里不再举实例。

## 4. 移除 APK 包内的文件：aapt r\[emove\] ##

语法格式：

aapt r[emove] [-v] file.{ zip,jar,apk} file1 [file2 ...]
    
    参数:
        -v              详细输出执行过程
        file1 ...       文件在压缩包内的路径

实例：

# 移除 demo.apk 中的 AndroidManifest.xml 文件
    aapt r demo.apk AndroidManifest.xml
    
    # 移除 demo.apk 中的签名文件
    aapt r demo.apk META-INF/CERT.RSA
    aapt r demo.apk META-INF/CERT.SF
    
    # 可以同时删除多个文件
    aapt r demo.apk AndroidManifest.xml META-INF/CERT.RSA META-INF/CERT.SF

## 5. 添加文件到 APK 包内：aapt a\[dd\] ##

语法格式：

aapt a[dd] [-v] file.{ zip,jar,apk} file1 [file2 ...]
    
    参数:
        -v          详细输出执行过程
        file1 ...   文件在本地的路径（必须是相对路径）, 添加到压缩包内的路径和该路径相同

实例：

# 把文件 aa.txt 添加到 apk 包中, 添加后在 apk 中的路径为 aa.txt
    aapt a demo.apk aa.txt
    
    # 把文件 META-INF/bb.txt 添加到 apk 包中, 添加后在 apk 中的路径为 META-INF/bb.txt
    aapt a demo.apk META-INF/bb.txt
    
    # 可以同时添加多个文件
    aapt a demo.apk aa.txt META-INF/bb.txt

## 6. 批量预处理 PNG 资源：aapt c\[runch\] ##

对一个或多个资源文件夹进行 PNG 预处理（压缩 PNG 文件，降低存储空间），然后把处理结果保存到输出文件夹。

语法格式：

aapt c[runch] [-v] -S resource-sources ... -C output-folder ...
    
    参数：
        -v      输出详情
        -S      资源文件夹（子文件夹也会被处理, 只处理后缀为 png 的文件）
        -C      输出文件夹（需要事先创建）

实例：

# 将文件夹 pngDir 中的所有 png 文件进行预处理, 结果输出到 outDir 文件夹中
    aapt c -S pngDir -C outDir

## 7. 预处理单个 PNG 资源：aapt s\[ingleCrunch\] ##

对单个资源文件进行 PNG 预处理。

语法格式：

aapt s[ingleCrunch] [-v] -i input-file -o outputfile
    
    参数：
        -v      输出详情
        -i      输入文件
        -o      输出文件

实例：

# 预处理 demo.png 文件, 结果输出到 out.png
    aapt s -i demo.png -o out.png

## 8. 打印版本信息：aapt v\[ersion\] ##

打印 aapt 命令的版本信息：

$ aapt v
    Android Asset Packaging Tool, v0.2-4913185

--------------------