Flutter壁纸应用设置壁纸后重启问题求助

问题根源 #

这种情况基本是Android系统配置变更触发了Activity重建——设置壁纸后，部分设备会触发系统UI配置（比如夜间模式、壁纸关联主题）的变化，导致Flutter依附的主Activity被销毁重建，看起来就像应用重启了。另外，未处理的异步异常、文件权限问题也可能间接引发类似现象。

具体解决办法 #

1. 禁止Activity因配置变更重建 #

修改Android项目下的AndroidManifest.xml，给主Activity添加configChanges属性，明确忽略可能触发重建的配置项：

<activity
    android:name=".MainActivity"
    android:configChanges="keyboard|keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize|uiMode">
    <!-- 保留原有其他配置 -->
</activity>

重点加上uiMode，因为壁纸变更常触发UI模式（比如昼夜切换相关）的变化，这是导致重建的常见诱因。

2. 规范异步操作与异常捕获 #

你的原代码没有等待壁纸设置完成，也没处理异常，可能隐藏了崩溃问题。修改代码确保异步流程可控：

Future<void> _setwallpaper(String imagePath, int location) async {
  try {
    final file = await DefaultCacheManager().getSingleFile(imagePath);
    // 等待壁纸设置操作完成，避免异步流程混乱
    await WallpaperManagerFlutter().setwallpaperfromFile(file, location);
    // 添加成功提示，确认操作状态
    if (mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('壁纸设置成功')),
      );
    }
  } catch (e) {
    // 捕获所有异常，避免崩溃
    if (mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('设置失败：${e.toString()}')),
      );
    }
  }
}

注意加上mounted判断，避免在Widget已销毁时调用UI操作。

3. 优化文件权限与存储路径 #

缓存目录的文件可能存在权限问题，部分设备会因权限不足触发系统保护机制。可以把图片复制到应用私有目录后再设置：

import 'dart:io';
import 'package:path_provider/path_provider.dart';

Future<void> _setwallpaper(String imagePath, int location) async {
  try {
    final cacheFile = await DefaultCacheManager().getSingleFile(imagePath);
    // 获取应用私有文档目录，权限更稳定
    final appDir = await getApplicationDocumentsDirectory();
    final tempFile = File('${appDir.path}/temp_wallpaper.jpg');
    // 复制文件到私有目录
    await cacheFile.copy(tempFile.path);
    
    await WallpaperManagerFlutter().setwallpaperfromFile(tempFile, location);
    // 设置完成后清理临时文件
    await tempFile.delete();
    
    if (mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('壁纸设置成功')),
      );
    }
  } catch (e) {
    if (mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('设置失败：${e.toString()}')),
      );
    }
  }
}

4. 绕过第三方包，直接调用系统API #

如果第三方包的封装有问题，可通过MethodChannel直接调用Android原生壁纸API，兼容性更好：

Flutter端代码

import 'package:flutter/services.dart';

Future<void> _setWallpaper(String imagePath, int location) async {
  const platform = MethodChannel('com.your.package/wallpaper');
  try {
    await platform.invokeMethod('setWallpaper', {
      'path': imagePath,
      'location': location, // 0: 主屏, 1: 锁屏, 2: 两者
    });
    if (mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('壁纸设置成功')),
      );
    }
  } on PlatformException catch (e) {
    if (mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('设置失败：${e.message}')),
      );
    }
  }
}

Android原生端代码（MainActivity.java）

import android.app.WallpaperManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import java.io.File;
import java.io.IOException;
import io.flutter.embedding.android.FlutterActivity;
import io.flutter.embedding.engine.FlutterEngine;
import io.flutter.plugin.common.MethodChannel;

public class MainActivity extends FlutterActivity {
    private static final String CHANNEL = "com.your.package/wallpaper";

    @Override
    public void configureFlutterEngine(FlutterEngine flutterEngine) {
        super.configureFlutterEngine(flutterEngine);
        new MethodChannel(flutterEngine.getDartExecutor().getBinaryMessenger(), CHANNEL)
                .setMethodCallHandler((call, result) -> {
                    if (call.method.equals("setWallpaper")) {
                        String path = call.argument("path");
                        int location = call.argument("location");
                        try {
                            WallpaperManager manager = WallpaperManager.getInstance(this);
                            Bitmap bitmap = BitmapFactory.decodeFile(path);
                            switch (location) {
                                case 0:
                                    manager.setBitmap(bitmap, null, true, WallpaperManager.FLAG_SYSTEM);
                                    break;
                                case 1:
                                    manager.setBitmap(bitmap, null, true, WallpaperManager.FLAG_LOCK);
                                    break;
                                case 2:
                                    manager.setBitmap(bitmap);
                                    break;
                            }
                            result.success(null);
                        } catch (IOException e) {
                            result.error("SET_FAILED", e.getMessage(), null);
                        }
                    } else {
                        result.notImplemented();
                    }
                });
    }
}

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