Android Oreo环境下GCM适配：谷歌官方代码配置咨询

嘿，我来帮你搞定Android Oreo（API 26+）里GCM配置的问题，顺便梳理下版本适配的关键注意事项：

先提个重要前提：GCM已经被Google官方弃用，现在推荐迁移到Firebase Cloud Messaging (FCM)——它完全兼容GCM的接口，而且对Android新版本的适配更完善。不过如果你确实需要继续使用GCM，下面的配置和注意事项一定要记牢。

一、清单文件的适配调整 #

你给出的原始代码需要针对性修改，才能适配Oreo的后台限制：

1. 广播接收器（GcmReceiver） #

原配置的核心逻辑是对的，只需确保权限和包名正确，完整配置如下：

<receiver
    android:name="com.google.android.gms.gcm.GcmReceiver"
    android:exported="true"
    android:permission="com.google.android.c2dm.permission.SEND">
    <intent-filter>
        <action android:name="com.google.android.c2dm.intent.RECEIVE" />
        <!-- 替换成你自己的应用包名 -->
        <category android:name="com.example.gcm" />
    </intent-filter>
</receiver>

划重点：Oreo虽然限制了大部分隐式广播的静态注册，但com.google.android.c2dm.intent.RECEIVE属于系统允许的例外，所以这个静态注册是有效的，不用担心被系统拦截。

2. 消息处理服务（替代原GcmListenerService） #

Oreo引入了后台服务限制，原来继承GcmListenerService（它是IntentService子类）的实现，在应用后台时会被系统限制启动，导致消息无法处理。我们需要改用JobIntentService来实现消息处理：

首先自定义服务继承JobIntentService：

public class MyGcmJobIntentService extends JobIntentService {
    private static final int JOB_ID = 1000;

    // 用于将任务加入队列的静态方法
    public static void enqueueWork(Context context, Intent intent) {
        enqueueWork(context, MyGcmJobIntentService.class, JOB_ID, intent);
    }

    @Override
    protected void onHandleWork(@NonNull Intent intent) {
        // 这里的逻辑和原GcmListenerService的onMessageReceived完全一致
        Bundle extras = intent.getExtras();
        if (extras != null && !extras.isEmpty()) {
            String messageContent = extras.getString("message");
            // 处理消息，比如显示通知
            showNotification(messageContent);
        }
    }

    private void showNotification(String message) {
        // Oreo及以上必须创建通知渠道，否则通知无法显示
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel channel = new NotificationChannel(
                "GCM_CHANNEL", 
                "GCM消息通知", 
                NotificationManager.IMPORTANCE_DEFAULT
            );
            NotificationManager manager = getSystemService(NotificationManager.class);
            manager.createNotificationChannel(channel);
        }

        // 构建并显示通知
        NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "GCM_CHANNEL")
                .setSmallIcon(R.drawable.ic_notification)
                .setContentTitle("新GCM消息")
                .setContentText(message)
                .setPriority(NotificationCompat.PRIORITY_DEFAULT);

        NotificationManagerCompat.from(this).notify(1, builder.build());
    }
}

然后在清单文件中配置该服务：

<service
    android:name="com.example.MyGcmJobIntentService"
    android:exported="false"
    android:permission="com.google.android.c2dm.permission.SEND">
    <intent-filter>
        <action android:name="com.google.android.c2dm.intent.RECEIVE" />
    </intent-filter>
</service>

最新版本的GCM库会自动将GcmReceiver收到的消息转发给这个服务，无需额外手动转发。

二、必须添加的权限 #

在清单文件根节点下添加以下权限，否则GCM功能会失效：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />

<!-- 替换成你的应用包名 -->
<permission
    android:name="com.example.gcm.permission.C2D_MESSAGE"
    android:protectionLevel="signature" />
<uses-permission android:name="com.example.gcm.permission.C2D_MESSAGE" />

三、版本适配核心注意事项 #

• 后台服务限制：Oreo及以上禁止后台启动IntentService，必须用JobIntentService或WorkManager处理后台任务，这是最核心的适配点，否则后台消息会完全收不到。
• 通知渠道强制要求：Oreo及以上显示通知必须先创建通知渠道，否则通知不会在状态栏显示。
• GCM库版本：一定要使用最新的GCM依赖（最后一个稳定版本是com.google.android.gms:play-services-gcm:17.0.0），旧版本库没有适配Oreo的限制，会导致消息接收失败。
• 官方弃用提醒：GCM已于2019年停止服务，虽然目前可能还能运行，但官方不再维护，后续大概率会出现兼容性问题，强烈建议迁移到FCM，迁移成本极低，仅需替换依赖和少量代码。

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