Partilhar via


Migração dos Hubs de Notificação do Azure e do Google Firebase Cloud Messaging

Os principais recursos para a integração dos Hubs de Notificação do Azure com o Firebase Cloud Messaging (FCM) v1 estão disponíveis. Como lembrete, o Google deixará de oferecer suporte a HTTP herdado do FCM em 20 de junho de 2024, portanto, você deve migrar seus aplicativos e cargas úteis de notificação para o novo formato antes disso.

Importante

A partir de junho de 2024, as APIs herdadas do FCM não serão mais suportadas e serão desativadas. Para evitar qualquer interrupção no serviço de notificação por push, você deve migrar para o protocolo FCM v1 o mais rápido possível.

Conceitos para FCM v1

  • Um novo tipo de plataforma é suportado, chamado FCM v1.
  • Novas APIs, credenciais, registros e instalações são usados para o FCM v1.

Passos da Migração

A API herdada do Firebase Cloud Messaging (FCM) será preterida até julho de 2024. Você pode começar a migrar do protocolo HTTP herdado para o FCM v1 agora. Você deve concluir a migração até junho de 2024.

FAQ

Esta seção fornece respostas para perguntas frequentes sobre a migração do legado do FCM para o FCM v1.

Como faço para criar registros de modelo do FCM v1 com SDKs ou APIs REST?

Para obter instruções sobre como criar registros de modelo do FCM v1, consulte Hubs de Notificação do Azure e a migração do Google Firebase Cloud Messaging (FCM) usando SDKs.

Preciso armazenar credenciais legadas e FCM v1?

Sim, o FCM herdado e o FCM v1 são tratados como duas plataformas separadas nos Hubs de Notificação do Azure, portanto, você deve armazenar as credenciais herdadas do FCM e do FCM v1 separadamente. Para obter mais informações, consulte as instruções para configurar credenciais.

Como posso verificar se as operações de envio estão passando pelo pipeline do FCM v1 em vez do pipeline herdado do FCM?

A resposta de envio de depuração contém uma results propriedade, que é uma matriz de resultados de registro para o envio de depuração. Cada resultado de registo especifica a plataforma de aplicação. Além disso, oferecemos telemetria por mensagem para hubs de notificação de camada padrão. Esta telemetria apresenta GcmOutcomeCounts e FcmV1OutcomeCounts, que podem ajudá-lo a verificar qual plataforma é usada para operações de envio.

Preciso criar novos registros para o FCM v1?

Sim, mas você pode usar importar/exportar. Depois de atualizar o SDK do cliente, ele cria tokens de dispositivo para registros FCM v1.

A documentação do Google Firebase diz que não são necessárias alterações no lado do cliente. Preciso fazer alguma alteração nos Hubs de Notificação para garantir que minhas notificações sejam enviadas pelo FCM v1?

Para operações de envio direto, não há alterações específicas dos Hubs de Notificação que precisem ser feitas no dispositivo cliente. Se você armazenar instalações ou registros com os Hubs de Notificação do Azure, deverá informar aos Hubs de Notificação que deseja ouvir a plataforma migrada (FCM v1). Independentemente de você usar os Hubs de Notificação ou o Firebase diretamente, as alterações na carga útil são necessárias. Consulte a documentação sobre como migrar para o FCM v1.

Meu feedback PNS mostra "erro desconhecido" ao enviar uma mensagem FCM v1. O que devo fazer para corrigir este erro?

Os Hubs de Notificação do Azure estão trabalhando em uma solução que reduz o número de vezes que o "erro desconhecido" é mostrado. Enquanto isso, os clientes de nível padrão podem usar a API de feedback de notificação para examinar as respostas.

Como os clientes Xamarin podem migrar para o FCM v1?

O Xamarin agora foi preterido e os clientes do Xamarin devem migrar para o .NET Multi-platform App UI (.NET MAUI). Embora SDKs específicos do Hub de Notificação do Azure não sejam fornecidos para .NET para Android, .NET para iOS e MAUI do .NET, o SDK do .NET pode ser usado por aplicativos criados com o .NET, incluindo o .NET MAUI. Para obter mais informações, incluindo o envio de notificações por push para um aplicativo .NET MAUI via FCM v1, consulte Enviar notificações por push para aplicativos .NET MAUI usando os Hubs de Notificação do Azure por meio de um serviço de back-end.

Próximos passos