React Native项目构建Android APK时因getInstance方法缺失崩溃

问题描述 #

集成react-native-branch@5.4.0的React Native项目，构建Android APK后启动直接崩溃，崩溃日志如下：

2023-08-02 09:13:14.958 21590-21590/staging.klubcoin E/AndroidRuntime: FATAL EXCEPTION: main
    Process: staging.klubcoin, PID: 21590
    java.lang.NoSuchMethodError: No static method getInstance(Landroid/content/Context;)Lio/branch/referral/Branch; in class Lio/branch/referral/Branch; or its super classes (declaration of 'io.branch.referral.Branch' appears in /data/app/~~I5cmDpCmKQePbQPBCrzxzA==/staging.klubcoin-GsaHiZyd32cGjYRnZFrsYA==/base.apk!classes7.dex)
        at io.branch.rnbranch.RNBranchModule.setupBranch(RNBranchModule.java:746)
        at io.branch.rnbranch.RNBranchModule.initSession(RNBranchModule.java:123)
        at com.liquichain.MainActivity.onStart(MainActivity.java:37)
        at android.app.Instrumentation.callActivityOnStart(Instrumentation.java:1436)
        at android.app.Activity.performStart(Activity.java:8024)
        at android.app.ActivityThread.handleStartActivity(ActivityThread.java:3459)
        at android.app.servertransaction.TransactionExecutor.performLifecycleSequence(TransactionExecutor.java:221)
        at android.app.servertransaction.TransactionExecutor.cycleToPath(TransactionExecutor.java:201)
        at android.app.servertransaction.TransactionExecutor.executeLifecycleState(TransactionExecutor.java:173)
        at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:97)
        at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2068)
        at android.os.Handler.dispatchMessage(Handler.java:106)
        at android.os.Looper.loop(Looper.java:223)
        at android.app.ActivityThread.main(ActivityThread.java:7703)
        at java.lang.reflect.Method.invoke(Native Method)
        at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:592)
        at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:952)

问题原因 #

崩溃核心是RN分支库的原生代码调用了Branch.getInstance(Context)静态方法，但当前打包进APK的Branch原生SDK版本中不存在这个方法，本质是react-native-branch封装库与依赖的原生Branch SDK版本不兼容，或是项目中存在依赖冲突导致引入了错误版本的原生SDK。

解决方案 #

1. 强制统一原生Branch SDK版本 #

在Android项目根目录的build.gradle文件中，添加依赖版本强制策略，确保使用与react-native-branch@5.4.0匹配的原生SDK版本（5.x系列，推荐5.3.0及以上）：

allprojects {
    repositories {
        // ... 其他仓库配置
    }
    configurations.all {
        resolutionStrategy.force 'io.branch.sdk.android:library:5.3.0'
    }
}

2. 清理构建缓存与依赖 #

• 清理React Native缓存：

npx react-native start --reset-cache

• 清理Android构建缓存：

cd android && ./gradlew clean

• 重新安装依赖：

rm -rf node_modules package-lock.json
npm install

3. 检查并修正MainActivity初始化代码 #

确保MainActivity.java中的Branch初始化代码遵循react-native-branch@5.x的规范，不要直接调用原生Branch的初始化方法：

import io.branch.rnbranch.RNBranchModule;

@Override
protected void onStart() {
    super.onStart();
    // 使用RN分支库提供的初始化方法
    RNBranchModule.initSession(getIntent().getData(), this);
}

4. 排查并排除依赖冲突 #

执行以下命令查看项目中Branch相关的依赖树：

cd android && ./gradlew app:dependencies

如果发现有其他第三方库引入了旧版本的Branch SDK，在对应的依赖声明中排除冲突模块，再手动添加正确版本：

implementation(project(':react-native-branch')) {
    exclude group: 'io.branch.sdk.android', module: 'library'
}
implementation 'io.branch.sdk.android:library:5.3.0'

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