萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android aapt/aapt2 命令檢測 APK 信息完整指南:包名、版本、權限、圖標、Activity、架構

工具演進

  • aapt (Android Asset Packaging Tool):舊版打包工具,Android Gradle Plugin 3.0 前默認
  • aapt2:新版並行、增量編譯工具,AGP 3.0+ 默認,**語法基本兼容**
  • 現代構建產物通常在 build/outputs/apk/ 或 build/outputs/bundle/

核心命令:dump badging

# 完整信息轉储
aapt dump badging app-release.apk
# 或 aapt2
aapt2 dump badging app-release.apk

輸出字段詳細解讀

package: name='com.example.app' versionCode='123' versionName='2.1.0'
  → 應用包名、版本代碼 (整數)、版本名 (字符串)

sdkVersion:'21'                    → minSdkVersion
targetSdkVersion:'34'              → targetSdkVersion

uses-permission:'android.permission.INTERNET'
uses-permission:'android.permission.CAMERA'
  → Manifest 聲明的權限

application-label:'MyApp'          → android:label (本地化後)
application-icon-160:'res/drawable-mdpi/ic_launcher.png'
application-icon-240:'res/drawable-hdpi/ic_launcher.png'
application-icon-320:'res/drawable-xhdpi/ic_launcher.png'
application-icon-480:'res/drawable-xxhdpi/ic_launcher.png'
application-icon-640:'res/drawable-xxxhdpi/ic_launcher.png'
  → 各密度啟動圖標路徑

launchable-activity: name='com.example.app.MainActivity' label='MyApp' icon=''
  → LAUNCHER 入口 Activity

uses-feature:'android.hardware.camera'
uses-feature:'android.hardware.camera.autofocus'
uses-feature:'android.hardware.touchscreen'
  → 硬體特性需求 (隱式/顯式)

supports-screens:'small' 'normal' 'large' 'xlarge'
supports-any-density:'true'
  → 屏幕兼容性

locales:'en_US' 'zh_CN' 'ja_JP'
  → 支持語言

densities:'160' '240' '320' '480' '640'
  → 包含資源的密度桶

native-code:'arm64-v8a' 'armeabi-v7a'
  → 包含的原生庫架構

其他實用 dump 子命令

命令用途
aapt dump permissions app.apk僅列出權限
aapt dump resources app.apk列出所有資源 ID、類型、名稱
aapt dump configurations app.apk列出資源配置 (語言、密度、屏幕尺寸等)
aapt dump xmltree app.apk res/layout/main.xml查看編譯後 XML 樹結構
aapt dump --values strings app.apk導出所有字符串資源

進階:提取圖標/資源文件

# 提取所有資源到目錄
aapt dump --files app.apk | grep -E '\.png$|\.xml$' | while read f; do
    aapt dump xmltree app.apk "$f" > "${f//\//_}.txt" 2>/dev/null || true
done

# 直接用 unzip (APK 本質是 ZIP)
unzip -l app.apk | grep ic_launcher
unzip -j app.apk 'res/drawable-*hdpi*/ic_launcher.png' -d ./icons/

在 CI/CD 中自動化校驗

# GitHub Actions 片段
- name: Verify APK metadata
  run: |
    aapt dump badging app-release.apk > badging.txt
    # 檢查版本號
    VERSION_CODE=$(grep -oP "versionCode='\K\d+" badging.txt)
    VERSION_NAME=$(grep -oP "versionName='\K[^']+" badging.txt)
    echo "Version: $VERSION_NAME ($VERSION_CODE)"
    # 檢查必需權限
    grep -q "android.permission.INTERNET" badging.txt || exit 1
    # 檢查目標 SDK
    TARGET_SDK=$(grep -oP "targetSdkVersion:'\K\d+" badging.txt)
    [[ $TARGET_SDK -ge 33 ]] || { echo "targetSdkVersion < 33"; exit 1; }

常見問題

  1. 命令找不到:將 $ANDROID_HOME/build-tools// 加入 PATH
  2. 輸出亂碼:終端編碼設置 UTF-8,或管道 | iconv -f utf-8 -t gbk (Windows)
  3. Bundle (.aab) 不支持:aapt 僅支持 APK。AAB 需用 bundletool dump manifest 或先 bundletool build-apks --mode=universal 生成通用 APK 再檢測
  4. 大文件耗時:aapt2 並行解析較快,大型 APK 仍需數秒

總結

aapt dump badging 是檢測 APK 元數據的「瑞士軍刀」,無需安裝即可獲取包名、版本、權限、組件、圖標、架構、屏幕適配等關鍵信息。集成到 CI 流水線可自動化把關版本號、目標 SDK、權限合規、原生庫架構等發布前檢查。掌握輸出字段含義,能快速定位打包配置錯誤、第三方 SDK 引入的隱性權限、資源缺失等問題。

copyright © 萬盛學電腦網 all rights reserved