手动编译Android APK时AndroidManifest.xml格式异常求助

1. 明确Android Studio对Manifest的隐式处理 #

Android Studio/Gradle打包时会对Manifest做这些关键转换，你手动打包时大概率漏掉了：

• 命名空间与属性补全：API 31+（含Android 12）要求显式指定android:namespace或通过tools命名空间处理兼容；
• SDK版本映射：将编译配置的SDK版本同步到Manifest的<uses-sdk>标签，确保与你使用的android-33平台匹配；
• 资源ID注入：把@layout/、@string/这类资源引用替换为实际资源ID（若Manifest中有此类引用）；
• XML格式规范化：自动修复缩进、闭合标签，移除冗余空白字符，适配Android XML解析规范。

2. 手动修复自定义Manifest的实操步骤 #

步骤1：补全Manifest必填属性 #

确保根标签<manifest>包含以下核心属性（以API 33为例）：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:package="com.your.package.name"
    android:versionCode="1"
    android:versionName="1.0">

    <uses-sdk android:minSdkVersion="21" android:targetSdkVersion="33" />

    <!-- Activity等组件声明 -->
</manifest>

注意：android:package必须与你编译Kotlin时指定的包名完全一致，否则会出现组件找不到的问题。

步骤2：用aapt2处理Manifest #

Build Tools中的aapt2是处理Manifest和资源的核心工具，用它完成AS的隐式转换：

1. 创建空的res/目录（哪怕无资源，也要保留这个标准结构）；
2. 编译资源目录：

aapt2 compile --dir ./res -o res.zip

3. 链接Manifest与资源，生成预处理后的基础APK：

aapt2 link -o base.apk \
    --manifest ./AndroidManifest.xml \
    -I $ANDROID_HOME/platforms/android-33/android.jar \
    --java ./gen \
    --min-sdk-version 21 \
    --target-sdk-version 33 \
    --version-code 1 \
    --version-name 1.0 \
    res.zip

此命令会生成包含规范Manifest的base.apk，同时在gen/目录生成R.java（有资源时生效）。

步骤3：合并dex到基础APK #

用zip命令将你之前生成的classes.dex添加到base.apk：

zip -u base.apk classes.dex

步骤4：签名APK #

最后用apksigner签名，此时Manifest已符合规范：

apksigner sign --ks your-keystore.jks base.apk

3. 自定义Manifest的常见隐性错误排查 #

• 检查所有XML标签是否完全闭合（比如<activity>是否漏写</activity>）；
• 避免随意使用tools:ignore或tools:replace属性，除非明确其作用；
• 组件的android:name必须写全类名（如com.your.package.name.MainActivity），不能省略包名前缀。

内容的提问来源于stack exchange，提问作者Mousin Ahanger