React Native项目：APP关闭时Android原生Widget调用JS函数失败求助

HeadlessJsTaskService的核心限制是依赖APP进程存活，当APP完全关闭（进程被系统回收）时，它无法触发JS代码执行。要实现Widget在APP关闭时获取JS数据，得换个思路——把数据提前落地到本地存储，让Widget直接读取本地数据，或者用后台任务定期同步数据。

方案一：本地存储中转（最直接） #

通过React Native将数据写入Android本地存储（比如SharedPreferences），Widget直接读取该存储的数据，不需要依赖JS进程。

步骤1：React Native端写入数据 #

使用react-native-shared-preferences库（或RN内置的AsyncStorage，但SharedPreferences更适合原生直接读取）：

import SharedPreferences from 'react-native-shared-preferences';

// 保存数据到SharedPreferences
const saveWidgetData = async (data) => {
  try {
    await SharedPreferences.setItem('widget_data', JSON.stringify(data));
    // 可选：通知原生Widget更新
    await NativeModules.WidgetUpdateModule.updateWidget();
  } catch (error) {
    console.error('保存Widget数据失败:', error);
  }
};

// 数据变化时调用这个方法，比如接口请求完成后
saveWidgetData({ userName: '张三', latestScore: 95 });

步骤2：Android Widget读取数据 #

在Widget的AppWidgetProvider中直接读取SharedPreferences：

@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
    for (int appWidgetId : appWidgetIds) {
        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
        
        // 读取SharedPreferences中的数据
        SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(context);
        String widgetDataStr = prefs.getString("widget_data", "{}");
        try {
            JSONObject data = new JSONObject(widgetDataStr);
            views.setTextViewText(R.id.tv_user_name, data.getString("userName"));
            views.setTextViewText(R.id.tv_score, data.getString("latestScore"));
        } catch (JSONException e) {
            e.printStackTrace();
        }
        
        appWidgetManager.updateAppWidget(appWidgetId, views);
    }
}

步骤3：触发Widget更新 #

如果JS端数据更新后需要立即刷新Widget，可以写一个原生Module来发送广播通知Widget更新：

// 原生Module
public class WidgetUpdateModule extends ReactContextBaseJavaModule {
    public WidgetUpdateModule(ReactApplicationContext reactContext) {
        super(reactContext);
    }

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

    @ReactMethod
    public void updateWidget() {
        Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
        intent.setComponent(new ComponentName(getReactApplicationContext(), MyWidget.class));
        getReactApplicationContext().sendBroadcast(intent);
    }
}

方案二：WorkManager + HeadlessJS 定期同步数据 #

如果需要定期从JS获取最新数据（比如每小时更新一次），可以用Android的WorkManager触发HeadlessJS任务，将数据写入本地存储，再由Widget读取。

步骤1：配置WorkManager任务 #

// 定义Worker类
public class WidgetSyncWorker extends Worker {
    public WidgetSyncWorker(@NonNull Context context, @NonNull WorkerParameters params) {
        super(context, params);
    }

    @NonNull
    @Override
    public Result doWork() {
        // 触发HeadlessJS任务
        Intent intent = new Intent(getApplicationContext(), MyHeadlessTaskService.class);
        intent.putExtra("taskName", "syncWidgetData");
        getApplicationContext().startService(intent);
        return Result.success();
    }
}

// 调度周期性任务
public static void scheduleWidgetSync(Context context) {
    PeriodicWorkRequest workRequest = new PeriodicWorkRequest.Builder(WidgetSyncWorker.class, 1, TimeUnit.HOURS)
            .build();
    WorkManager.getInstance(context).enqueueUniquePeriodicWork("WidgetSync", ExistingPeriodicWorkPolicy.REPLACE, workRequest);
}

步骤2：HeadlessJS任务处理数据 #

// index.js中注册Headless任务
AppRegistry.registerHeadlessTask('syncWidgetData', () => async (taskData) => {
  try {
    // 调用JS函数获取最新数据，比如请求接口
    const latestData = await fetchLatestWidgetData();
    // 写入本地存储
    await SharedPreferences.setItem('widget_data', JSON.stringify(latestData));
    // 通知Widget更新
    await NativeModules.WidgetUpdateModule.updateWidget();
  } catch (error) {
    console.error('同步Widget数据失败:', error);
  }
});

关键注意事项 #

• 当APP被强制杀死后，WorkManager仍能在系统允许的情况下运行，但深度休眠模式下可能会延迟执行。
• 避免频繁同步数据，防止消耗过多电量，尽量根据业务需求设置合理的同步周期。
• 敏感数据不要存在SharedPreferences中，可改用加密存储或SQLite。

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