升级至SDK 34后Android原生应用发布版崩溃问题求助

核心排查方向 #

1. 检查R8/ProGuard混淆配置 #

SDK 34升级后，R8默认混淆规则可能对Activity等核心组件的处理逻辑变化，导致启动类被错误混淆或移除。

• 在proguard-rules.pro中强制保留启动Activity及构造方法：

  -keep public class com.yourpackage.YourLaunchActivity
  -keepclassmembers class com.yourpackage.YourLaunchActivity {
      public <init>();
  }
  

• 检查是否存在过度混淆规则，或误删除AndroidX相关的默认keep规则。

2. 验证签名包与Play优化的差异 #

Google Play的App Signing会对上传包做额外优化（如签名方案、资源压缩），和本地调试包逻辑不同：

• 本地生成签名包后手动安装测试：
  • 若本地签名包正常，说明是Play优化环节问题，可临时关闭部分优化测试：

    android {
        signingConfigs {
            release {
                v3SigningEnabled false
                v4SigningEnabled false
            }
        }
        buildTypes {
            release {
                shrinkResources false
            }
        }
    }
    

  • 若本地签名包也崩溃，说明是签名后的类加载冲突，需排查依赖重复问题。

3. 解决类加载冲突（ClassLoader异常） #

LinkageError多由类重复定义或版本冲突导致，SDK 34对类加载校验更严格：

• 执行./gradlew app:dependencies查看依赖树，找出重复依赖（如androidx.core多版本共存），统一依赖版本：

  dependencies {
      implementation platform('androidx.core:core:1.12.0')
  }
  

• 若应用使用自定义ClassLoader或插件化逻辑，需适配SDK 34的类加载权限限制。

4. 适配AppComponentFactory逻辑 #

堆栈显示崩溃发生在CoreComponentFactory.instantiateActivity环节：

• 若自定义了AppComponentFactory，确保继承自androidx.core.app.CoreComponentFactory，并在Manifest正确声明：

  <application
      android:appComponentFactory="com.yourpackage.CustomComponentFactory"
      tools:replace="android:appComponentFactory">
  </application>
  

• 可临时移除自定义ComponentFactory，改用默认实现排查问题。

5. 检查SDK 34兼容性细节 #

SDK 34对Activity声明、权限有新要求：

• 确保启动Activity的Manifest声明添加android:exported="true"（LAUNCHER Activity必须设置）：

  <activity
      android:name=".YourLaunchActivity"
      android:exported="true">
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
  </activity>
  

• 清理清单中已废弃或受限的权限声明。

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