Android应用终止后React Native实现setWallpaper的可行性及方案

开发者阿泽

2026-6-29

可行性说明

可以实现，但受Android系统的电池优化和后台限制约束。应用从最近任务列表清除后，普通后台任务会被系统回收，需借助Android提供的高优先级后台机制：

WorkManager：适合调度延迟/周期性任务，即使应用终止，系统也会在资源允许时触发执行
前台服务：优先级最高，需显示通知栏，几乎不会被系统杀死（除非手动强制停止应用）

React Native 实现方案

一、非Expo（裸项目）方案

1. 使用WorkManager实现

步骤1：Android原生端创建Worker类

在android/app/src/main/java/com/[你的包名]/目录下新建WallpaperWorker.java：

import android.app.WallpaperManager;
import android.content.Context;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import androidx.annotation.NonNull;
import androidx.work.Worker;
import androidx.work.WorkerParameters;
import java.io.IOException;

public class WallpaperWorker extends Worker {
    public WallpaperWorker(@NonNull Context context, @NonNull WorkerParameters params) {
        super(context, params);
    }

    @NonNull
    @Override
    public Result doWork() {
        // 替换为你的壁纸资源ID或本地文件路径
        Bitmap wallpaperBitmap = BitmapFactory.decodeResource(getApplicationContext().getResources(), R.drawable.your_wallpaper);
        WallpaperManager wallpaperManager = WallpaperManager.getInstance(getApplicationContext());
        try {
            wallpaperManager.setBitmap(wallpaperBitmap);
            return Result.success();
        } catch (IOException e) {
            e.printStackTrace();
            return Result.failure();
        }
    }
}

步骤2：创建RN原生模块暴露调度方法

同目录下新建WallpaperModule.java：

import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import androidx.work.OneTimeWorkRequest;
import androidx.work.WorkManager;
import java.util.concurrent.TimeUnit;

public class WallpaperModule extends ReactContextBaseJavaModule {
    public WallpaperModule(ReactApplicationContext reactContext) {
        super(reactContext);
    }

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

    @ReactMethod
    public void scheduleWallpaperTask(long delaySeconds) {
        OneTimeWorkRequest request = new OneTimeWorkRequest.Builder(WallpaperWorker.class)
                .setInitialDelay(delaySeconds, TimeUnit.SECONDS)
                .build();
        WorkManager.getInstance(getReactApplicationContext()).enqueue(request);
    }
}

在MainApplication.java中注册模块：

// 导入必要类
import com.yourpackagename.WallpaperModule;
import com.facebook.react.ReactPackage;
import java.util.Arrays;
import java.util.List;

public class MainApplication extends Application implements ReactApplication {
    // ...其他已有代码
    @Override
    protected List<ReactPackage> getPackages() {
        List<ReactPackage> packages = new PackageList(this).getPackages();
        packages.add(new ReactPackage() {
            @Override
            public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
                return Arrays.asList(new WallpaperModule(reactContext));
            }
        });
        return packages;
    }
}

步骤3：RN端调用任务调度

import { NativeModules } from 'react-native';
const { WallpaperModule } = NativeModules;

// 调度10秒后执行壁纸设置任务（应用终止后仍会触发）
WallpaperModule.scheduleWallpaperTask(10);

2. 使用前台服务实现

步骤1：创建前台服务类

同目录下新建WallpaperService.java：

import android.app.Notification;
import android.app.NotificationChannel;
import android.app.NotificationManager;
import android.app.Service;
import android.content.Intent;
import android.os.Build;
import android.os.IBinder;
import android.app.WallpaperManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import java.io.IOException;

public class WallpaperService extends Service {
    private static final String CHANNEL_ID = "WallpaperServiceChannel";

    @Override
    public void onCreate() {
        super.onCreate();
        createNotificationChannel();
        // 启动前台服务（必须显示通知）
        Notification notification = new Notification.Builder(this, CHANNEL_ID)
                .setContentTitle("壁纸设置服务")
                .setContentText("正在后台处理壁纸设置")
                .setSmallIcon(R.drawable.ic_notification)
                .build();
        startForeground(1, notification);
        // 执行壁纸设置逻辑
        setWallpaper();
        // 任务完成后停止服务
        stopSelf();
    }

    private void setWallpaper() {
        Bitmap wallpaperBitmap = BitmapFactory.decodeResource(getResources(), R.drawable.your_wallpaper);
        WallpaperManager wallpaperManager = WallpaperManager.getInstance(this);
        try {
            wallpaperManager.setBitmap(wallpaperBitmap);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private void createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel serviceChannel = new NotificationChannel(
                    CHANNEL_ID,
                    "壁纸服务通道",
                    NotificationManager.IMPORTANCE_DEFAULT
            );
            NotificationManager manager = getSystemService(NotificationManager.class);
            manager.createNotificationChannel(serviceChannel);
        }
    }

    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

步骤2：配置权限与服务注册

在AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.SET_WALLPAPER" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<application ...>
    <service android:name=".WallpaperService" />
</application>

步骤3：扩展原生模块添加启动服务方法

在WallpaperModule.java中新增方法：

@ReactMethod
public void startWallpaperService() {
    Intent serviceIntent = new Intent(getReactApplicationContext(), WallpaperService.class);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        getReactApplicationContext().startForegroundService(serviceIntent);
    } else {
        getReactApplicationContext().startService(serviceIntent);
    }
}

步骤4：RN端启动服务

import { NativeModules } from 'react-native';
const { WallpaperModule } = NativeModules;

// 启动前台服务设置壁纸（应用终止后仍能执行）
WallpaperModule.startWallpaperService();

二、Expo 方案

Expo无直接WorkManager支持，可通过Expo Task Manager结合Background Fetch实现，需提前配置权限：

1. 配置权限

在app.json中添加：

{
  "expo": {
    "android": {
      "permissions": [
        "SET_WALLPAPER",
        "SCHEDULE_EXACT_ALARM",
        "POST_NOTIFICATIONS"
      ],
      "backgroundPermissions": ["NOTIFICATIONS"]
    }
  }
}

2. 安装依赖

expo install expo-task-manager expo-background-fetch expo-wallpaper

3. 注册并触发后台任务

import * as TaskManager from 'expo-task-manager';
import * as BackgroundFetch from 'expo-background-fetch';
import * as Wallpaper from 'expo-wallpaper';

const WALLPAPER_TASK = 'wallpaper-set-task';

// 定义后台任务逻辑
TaskManager.defineTask(WALLPAPER_TASK, async () => {
  try {
    // 替换为本地壁纸路径或已下载的远程文件路径
    const result = await Wallpaper.setWallpaperAsync('file:///path/to/your/wallpaper.jpg', Wallpaper.WALLPAPER_SCREEN.BOTH);
    return result.success ? BackgroundFetch.Result.NewData : BackgroundFetch.Result.Failed;
  } catch (error) {
    return BackgroundFetch.Result.Failed;
  }
});

// 注册后台任务
async function registerBackgroundTask() {
  const isRegistered = await TaskManager.isTaskRegisteredAsync(WALLPAPER_TASK);
  if (!isRegistered) {
    await BackgroundFetch.registerTaskAsync(WALLPAPER_TASK, {
      minimumInterval: 15, // 系统限制最小间隔15分钟
      stopOnTerminate: false, // 应用终止后不停止任务
      startOnBoot: true // 设备重启后自动启动
    });
  }
}

// 调用注册方法
registerBackgroundTask();

通用注意事项

必须申请SET_WALLPAPER权限，Android 13+还需POST_NOTIFICATIONS权限（用于前台服务通知）
需引导用户关闭应用的电池优化，否则后台任务可能被系统限制执行
WorkManager任务执行时间由系统调度，并非精确触发；前台服务会立即执行，但必须显示通知栏提示

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

Android应用终止后React Native实现setWallpaper的可行性及方案

一、非Expo（裸项目）方案 #

1. 使用WorkManager实现 #