无Activity的App Widget如何注册BroadcastReceiver？

刚好碰到过类似的场景，先拆解下你遇到的问题根源，再给你两个可行的解决方案：

为什么之前的方法会失败？ #

1. ReceiverCallNotAllowedException原因：AppWidgetProvider本质是BroadcastReceiver的子类，它的onEnabled()、onUpdate()这些方法是在广播接收的临时上下文中执行的。Android明确禁止在BroadcastReceiver的回调方法里注册/注销另一个广播接收器，这是为了防止形成广播回调链，导致系统资源浪费或ANR。
2. SDK24+静态广播被忽略：从Android 7.0（API24）开始，系统限制了大部分隐式广播的静态注册，ConnectivityManager.CONNECTIVITY_ACTION就在这个受限列表里，所以清单注册这条路完全走不通。

方案1：用ConnectivityManager.NetworkCallback监听网络变化（推荐，API21+） #

这是官方推荐替代网络广播的方案，不仅避开了广播的限制，还能更精准地监听网络状态变化。

具体实现步骤：

1. 在你的AppWidgetProvider类中定义静态的NetworkCallback和ConnectivityManager引用（避免重复创建，同时方便注销）：

private static ConnectivityManager sConnectivityManager;
private static ConnectivityManager.NetworkCallback sNetworkCallback;

2. 在onEnabled()里初始化并注册回调：

@Override
public void onEnabled(Context context) {
    super.onEnabled(context);
    // 一定要用Application Context，避免Widget实例销毁后导致内存泄漏
    Context appContext = context.getApplicationContext();
    sConnectivityManager = (ConnectivityManager) appContext.getSystemService(Context.CONNECTIVITY_SERVICE);

    if (sNetworkCallback == null) {
        sNetworkCallback = new ConnectivityManager.NetworkCallback() {
            @Override
            public void onAvailable(Network network) {
                super.onAvailable(network);
                // 网络恢复时，触发Widget刷新
                refreshAllWidgets(appContext);
            }
        };
    }

    // 构建网络请求，监听有互联网访问的网络类型
    NetworkRequest networkRequest = new NetworkRequest.Builder()
            .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
            .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
            .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
            .build();
    sConnectivityManager.registerNetworkCallback(networkRequest, sNetworkCallback);
}

3. 在onDisabled()里注销回调，防止内存泄漏：

@Override
public void onDisabled(Context context) {
    super.onDisabled(context);
    if (sConnectivityManager != null && sNetworkCallback != null) {
        sConnectivityManager.unregisterNetworkCallback(sNetworkCallback);
        sConnectivityManager = null;
        sNetworkCallback = null;
    }
}

4. 封装刷新逻辑为公共方法，方便复用：

private void refreshAllWidgets(Context context) {
    AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
    ComponentName widgetComponent = new ComponentName(context, YourWidgetProvider.class);
    int[] widgetIds = appWidgetManager.getAppWidgetIds(widgetComponent);

    // 遍历所有Widget实例，执行刷新
    for (int id : widgetIds) {
        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.your_widget_layout);
        // 这里写你的Widget内容更新逻辑，比如设置文本、图片等
        appWidgetManager.updateAppWidget(id, views);
    }
}

注意事项：

• 必须使用Application Context来注册回调，否则当AppWidgetProvider的临时实例被系统回收后，回调可能失效。
• 如果需要兼容API21以下的设备，可以回退到动态注册CONNECTIVITY_ACTION广播，但要在onDisabled()里注销，同时注意这些设备上静态注册该广播是允许的，可以作为备选。

方案2：用WorkManager调度刷新任务（API14+，适合多场景调度） #

如果你的Widget除了网络监听，还需要结合定时任务等其他后台需求，WorkManager是更灵活的选择，它会自动适配不同Android版本的后台限制。

具体实现步骤：

1. 先添加WorkManager依赖（在Module的build.gradle中）：

implementation "androidx.work:work-runtime:2.8.1"

2. 创建一个Worker类，负责执行Widget刷新：

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

    @NonNull
    @Override
    public Result doWork() {
        // 执行Widget刷新逻辑，和上面的refreshAllWidgets方法一致
        Context appContext = getApplicationContext();
        AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(appContext);
        ComponentName widgetComponent = new ComponentName(appContext, YourWidgetProvider.class);
        int[] widgetIds = appWidgetManager.getAppWidgetIds(widgetComponent);

        RemoteViews views = new RemoteViews(appContext.getPackageName(), R.layout.your_widget_layout);
        // 更新Widget内容...
        appWidgetManager.updateAppWidget(widgetIds, views);

        // 返回success表示任务完成，如果需要持续监听，可以重新调度任务
        return Result.success();
    }
}

3. 在AppWidgetProvider的onEnabled()里调度带网络约束的任务：

@Override
public void onEnabled(Context context) {
    super.onEnabled(context);
    // 设置约束：仅当网络可用时执行任务
    Constraints constraints = new Constraints.Builder()
            .setRequiredNetworkType(NetworkType.CONNECTED)
            .build();

    // 创建一次性任务，满足约束时自动执行
    OneTimeWorkRequest refreshRequest = new OneTimeWorkRequest.Builder(WidgetRefreshWorker.class)
            .setConstraints(constraints)
            .build();

    // 提交任务到WorkManager
    WorkManager.getInstance(context.getApplicationContext()).enqueue(refreshRequest);

    // 如果需要每次联网都刷新，可以在Worker的doWork()里重新提交任务，或者用周期性任务
    // 比如周期性任务（最小间隔15分钟，系统限制）：
    // PeriodicWorkRequest periodicRequest = new PeriodicWorkRequest.Builder(WidgetRefreshWorker.class, 15, TimeUnit.MINUTES)
    //         .setConstraints(constraints)
    //         .build();
    // WorkManager.getInstance(context).enqueue(periodicRequest);
}

注意事项：

• WorkManager的NetworkType.CONNECTED约束会在网络从不可用切换为可用时触发任务。
• 如果需要每次联网都刷新，可以在Worker执行完成后，重新提交一个带相同约束的OneTimeWorkRequest，这样下次网络变化时会再次触发。

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