React Native安卓调用WallpaperManager.setBitmap后应用崩溃问题

问题根源 #

从异常日志来看，崩溃的直接原因是react-native-screens的Fragment恢复机制冲突——设置壁纸的操作可能触发了Activity重建（比如系统权限校验、配置变更），进而暴露了Fragment配置的疏漏，和壁纸设置逻辑本身无直接关联。

步骤1：修复MainActivity的Fragment配置 #

关键是阻止系统自动恢复ScreenFragment，修改MainActivity.java：

import android.os.Bundle;
import com.facebook.react.ReactActivity;
import com.facebook.react.defaults.DefaultReactActivityDelegate;

public class MainActivity extends ReactActivity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    // 清除Fragment恢复状态，避免ScreenFragment被错误重建
    if (savedInstanceState != null) {
      savedInstanceState.remove("android:support:fragments");
    }
    super.onCreate(savedInstanceState);
  }

  @Override
  protected String getMainComponentName() {
    return "zenwalls";
  }

  @Override
  protected ReactActivityDelegate createReactActivityDelegate() {
    return new DefaultReactActivityDelegate(
        this,
        getMainComponentName()
    );
  }
}

步骤2：优化原生壁纸模块稳定性 #

虽然壁纸设置不是崩溃根源，但可以优化代码避免潜在问题：

• 确保UI操作在主线程执行
• 释放Bitmap内存，避免泄漏
• 补充低版本SDK兼容逻辑

修改后的WallpaperMod.java：

package com.zenwalls;

import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Build;
import android.os.Handler;
import android.os.Looper;
import android.util.Base64;
import android.util.Log;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import java.io.IOException;
import android.app.WallpaperManager;

public class WallpaperMod extends ReactContextBaseJavaModule {
    private final ReactApplicationContext context;
    private final Handler mainHandler;

    public WallpaperMod(ReactApplicationContext context) {
        super(context);
        this.context = context;
        this.mainHandler = new Handler(Looper.getMainLooper());
    }

    @Override
    public String getName() {
        return "WallpaperMod";
    }

    @ReactMethod
    public void setWallpaper(String image64) {
        // 切换到主线程执行UI相关操作
        mainHandler.post(() -> {
            try {
                byte[] decodedString = Base64.decode(image64, Base64.DEFAULT);
                Bitmap bitmap = BitmapFactory.decodeByteArray(decodedString, 0, decodedString.length);
                
                if (bitmap == null) {
                    Log.e("WallpaperMod", "Base64解码Bitmap失败");
                    return;
                }

                WallpaperManager wallpaperManager = WallpaperManager.getInstance(context);
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
                    wallpaperManager.setBitmap(bitmap, null, false, WallpaperManager.FLAG_SYSTEM);
                } else {
                    // 兼容Android N以下版本
                    wallpaperManager.setBitmap(bitmap);
                }

                // 释放Bitmap内存
                if (!bitmap.isRecycled()) {
                    bitmap.recycle();
                }
            } catch (IOException e) {
                Log.e("WallpaperMod", "设置壁纸失败", e);
            } catch (IllegalArgumentException e) {
                Log.e("WallpaperMod", "无效的Base64字符串", e);
            }
        });
    }
}

步骤3：React Native端添加错误处理（可选） #

提升用户体验，捕获调用过程中的异常：

useEffect(()=>{
  WallpaperMod.setWallpaper(base64String)
    .catch(err => console.error('设置壁纸失败:', err));
}, [base64String])

总结 #

崩溃的核心是react-native-screens的Fragment配置问题，修复MainActivity的状态清除逻辑即可解决；优化原生模块的线程和内存处理，能进一步提升应用稳定性。

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