Capacitor 5 Android发布包出现packageInfo is null错误及命令行编译咨询

问题根源 #

Release构建默认启用R8代码混淆，可能误移除了Capacitor依赖的PackageInfo相关反射逻辑或核心类，导致运行时无法获取包信息抛出异常。

修复步骤 #

1. 添加ProGuard规则保留关键代码 #

打开Android项目的app/proguard-rules.pro文件，追加以下规则：

# 保留Capacitor核心与插件类
-keep class com.getcapacitor.** { *; }
-keep class com.getcapacitor.plugin.** { *; }
# 保留PackageInfo相关类及成员，避免反射失效
-keepclassmembers class android.content.pm.PackageInfo { *; }
-keepclassmembers class * extends android.content.pm.PackageInfo { *; }

2. 配置Release签名（必填，即使是测试用unsigned包） #

打开app/build.gradle，完善android节点下的签名与构建配置：

android {
    // ...其他配置
    signingConfigs {
        debug {
            storeFile file('debug.keystore')
            storePassword 'android'
            keyAlias 'androiddebugkey'
            keyPassword 'android'
        }
        // 正式发布时替换为你的生产签名配置
        release {
            storeFile file("your-release-keystore.jks")
            storePassword "your-store-pass"
            keyAlias "your-key-alias"
            keyPassword "your-key-pass"
        }
    }
    buildTypes {
        release {
            // 测试阶段可临时使用debug签名，正式发布切换为signingConfigs.release
            signingConfig signingConfigs.debug
            minifyEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

正确的命令行编译流程 #

1. 同步Capacitor资源到Android项目 #

每次前端代码更新后，先同步资源：

npx cap sync android

2. 构建Debug包 #

./gradlew assembleDebug

3. 构建Release包 #

• 测试用（临时debug签名）：

  ./gradlew assembleRelease
  

• 正式发布（使用生产签名）：
  确保build.gradle中release块的signingConfig指向signingConfigs.release，再执行上述命令。

4. 使用Capacitor一键构建 #

自动完成同步+构建流程，添加--prod启用生产优化：

npx cap build android --prod

额外排查点 #

• 检查AndroidManifest.xml中的package属性是否与Capacitor配置一致
• 升级Capacitor依赖到最新稳定版：

  npm update @capacitor/core @capacitor/android
  

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