build/outputs/apk/ 或 build/outputs/bundle/# 完整信息轉储 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' → 包含的原生庫架構
| 命令 | 用途 |
|---|---|
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/
# 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; }
$ANDROID_HOME/build-tools// 加入 PATH| iconv -f utf-8 -t gbk (Windows)bundletool dump manifest 或先 bundletool build-apks --mode=universal 生成通用 APK 再檢測aapt dump badging 是檢測 APK 元數據的「瑞士軍刀」,無需安裝即可獲取包名、版本、權限、組件、圖標、架構、屏幕適配等關鍵信息。集成到 CI 流水線可自動化把關版本號、目標 SDK、權限合規、原生庫架構等發布前檢查。掌握輸出字段含義,能快速定位打包配置錯誤、第三方 SDK 引入的隱性權限、資源缺失等問題。