Adicionar notificações push a um app iOS

Adicionar notificações push a um app iOS

Sobre este codelab

Último fev. 26, 2025 atualizado

Escrito por Kanae Matsuguchi

1. Introdução

Última atualização:06/01/2020

O Firebase Cloud Messaging (FCM) é uma solução de mensagens entre plataformas que permite o envio confiável de mensagens.

Usando o FCM, você pode notificar um app cliente de que novos e-mails ou outros dados estão disponíveis para sincronização. É possível enviar mensagens de notificação para promover novas interações e a retenção de usuários. Para casos de uso como mensagens instantâneas, uma mensagem pode transferir um payload de até 4 KB para um app cliente.

Como funciona?

Uma implementação do FCM inclui dois componentes principais para envio e recebimento:

1. Um ambiente confiável, como o Cloud Functions para Firebase ou um servidor de apps que você usa para criar, segmentar e enviar mensagens.
2. Um app cliente iOS, Android ou da Web (JavaScript) que recebe mensagens pelo serviço de transporte específico da plataforma.

Visão geral da arquitetura do FCM

O FCM depende do seguinte conjunto de componentes que criam, transportam e recebem mensagens:

1. Ferramentas para escrever ou criar solicitações de mensagens. O Editor do Notificações tem uma opção baseada em GUI para criar solicitações de notificação. Para automação e suporte completos a todos os tipos de mensagens, crie solicitações de mensagens em um ambiente de servidor confiável que ofereça suporte ao SDK Admin do Firebase ou aos protocolos do servidor FCM. Esse ambiente pode ser o Cloud Functions para Firebase, o Google App Engine ou seu próprio servidor de aplicativos.
2. O back-end do FCM, que (entre outras funções) aceita solicitações de mensagens, realiza a distribuição de mensagens por tópicos e gera metadados de mensagens, como o ID da mensagem.
3. Uma camada de transporte no nível da plataforma, que encaminha a mensagem para o dispositivo de destino, processa a entrega da mensagem e aplica a configuração específica da plataforma quando apropriado. Essa camada de transporte inclui:

• Camada de transporte do Android (ATL) para dispositivos Android com o Google Play Services
• Serviço de notificação push da Apple (APNs) para dispositivos iOS
• Protocolo de push da Web para aplicativos da Web

Observação:as camadas de transporte no nível da plataforma estão fora do serviço do FCM. As mensagens do FCM roteadas para uma camada de transporte no nível da plataforma podem ser termos de assunto específicos dessa plataforma, em vez dos Termos de Serviço do FCM. O roteamento de mensagens do Android via ATL está de acordo com os Termos de Serviço das APIs do Google.

4. O SDK do FCM no dispositivo do usuário, em que a notificação é exibida ou a mensagem é processada de acordo com o estado em primeiro plano/segundo plano do app e qualquer lógica de aplicativo relevante.

O que você vai criar

Neste codelab, você vai adicionar notificações push a um exemplo de app iOS com o FCM.

O que você vai aprender

• Como inscrever e cancelar a inscrição de um usuário para mensagens push
• Como lidar com mensagens push recebidas
• Como mostrar uma notificação
• Como responder a cliques de notificação

O que é necessário

• Xcode 11.0 ou versões mais recentes
• CocoaPods 1.9.0 ou versões mais recentes
• Conta de desenvolvedor da Apple
• Um dispositivo iOS físico para executar seu app
• Conhecimento básico de Swift

2. Etapas da configuração

Baixe o exemplo de código

Neste codelab, você vai criar seu próprio app de teste, mas, se quiser ver e executar o app de exemplo, faça o download do código de exemplo do guia de início rápido.

Há duas maneiras de receber a amostra:

• Clone o repositório Git:

$ git clone https://github.com/firebase/quickstart-ios.git

• Faça o download do arquivo ZIP:

Se você baixar a fonte como um arquivo ZIP, ao descompactá-la, uma pasta raiz quickstart-ios será criada.

Fazer o download do código-fonte

Criar um novo app

Crie seu próprio app de teste seguindo estas etapas (as etapas abaixo são do Xcode 12.3):

1. Abra o Xcode e selecione Criar um projeto do Xcode.
2. Selecione App e clique em Próxima.

3. Insira o Nome do produto (por exemplo, MessagingExample)
4. Selecione Equipe. Se você ainda não tiver criado uma, configure na conta de desenvolvedor da Apple.
5. Insira o Identificador da organização (por exemplo, com.your-name)
6. Insira o Identificador do pacote (por exemplo, com.your-name.MessagingExample, que precisa ser exclusivo entre todos os apps iOS.
7. Selecione Storyboard no menu suspenso Interface.
8. Selecione Delegado do app UIKit no menu suspenso Ciclo de vida.
9. Selecione Swift em Linguagem.
10. Clique em Próxima.

Você vai precisar do identificador do pacote ao criar uma chave do APNs e registrar seu app no projeto do Firebase.

3. Como configurar APNs

Criar a chave de autenticação

Esta seção descreve como gerar uma chave de autenticação para um código de app ativado para notificações push. Se você tem uma chave, pode usá-la em vez de gerar uma nova.

Para criar uma chave de autenticação:

1. Na sua conta de desenvolvedor, acesse Certificados, identificadores e perfis e navegue até Chaves.

2. Clique no botão Adicionar (+) no canto superior direito.

3. Digite uma descrição para a chave de autenticação de APNs.
4. Em "Serviços de chave", marque a caixa de seleção "APNs" e clique em Continuar.

5. Clique em Registrar e em Fazer o download. Salve a chave em um lugar seguro. Este é um download único, e a chave não pode ser recuperada mais tarde.

Criar um ID do app

Um código de app é um identificador exclusivo de um aplicativo. Como convenção, ele é representado por um domínio invertido.

1. Faça login no Apple Developer Member Center.
2. Navegue até Certificates, Identifiers and Profiles.
3. Navegue até Identificadores.
4. Clique no botão + para criar um novo código do app.
5. Selecione o botão de opção IDs de apps e clique em Continuar.

6. Selecione App e clique em Continuar.

7. Para criar o novo ID do app:
8. Insira um Nome para o ID do app.
9. Insira um ID da equipe. Esse valor precisa corresponder ao Team ID da guia "Membership".
10. Na seção App ID Suffix, selecione Explicit App ID e insira o Bundle ID.
11. Na seção App Services, verifique se Push Notifications está marcado.
12. Clique em Continuar e verifique se a entrada está correta:
13. O valor do Identificador precisa corresponder à concatenação dos valores de "Team ID" e "Bundle ID".
14. A opção Push Notifications precisa ser definida como Configurable.
15. Clique em Register para criar o ID do app.

Criar o perfil

Para testar seu app ainda em desenvolvimento, você precisará de um perfil para que seus dispositivos sejam autorizados a executar um app ainda não publicado na App Store.

1. Faça login no Apple Developer Member Center.
2. Navegue até Certificates, Identifiers and Profiles.
3. No menu suspenso no canto superior esquerdo, selecione iOS, tvOS, watchOS, caso essa opção ainda não esteja selecionada, e navegue até Profiles.
4. Clique no botão + para criar um novo perfil.
5. Selecione Desenvolvimento de app para iOS como tipo de perfil de provisionamento e clique em Continuar.

6. No menu suspenso, selecione o ID do app que você quer usar e clique em Continuar.
7. Selecione o certificado de desenvolvimento do iOS referente ao código do app escolhido na etapa anterior e clique em Continuar.
8. Selecione os dispositivos iOS que você quer incluir no perfil de provisionamento e clique em Continuar. Confira se você selecionou todos os dispositivos que deseja usar para os testes.
9. Insira um nome para o perfil de provisionamento (por exemplo, MessagingExampleProfile) e clique em Gerar.

10. Clique em Download para salvar o perfil de provisionamento no seu Mac.

11. Clique duas vezes no arquivo do perfil de provisionamento para instalá-lo.

4. Adicionar o Firebase ao projeto do iOS

Criar um projeto do Firebase

Antes de adicionar o Firebase ao app para iOS, é preciso criar um projeto do Firebase para conectá-lo ao app. Acesse Noções básicas sobre projetos do Firebase para saber mais.

1. No console do Firebase, clique em Adicionar projeto e selecione ou insira um Nome do projeto.

Se você tiver um projeto do Google Cloud Platform (GCP), poderá selecioná-lo no menu suspenso para adicionar recursos do Firebase.

2. (Opcional) Se você estiver criando um novo projeto, poderá editar o ID do projeto.

O Firebase atribui automaticamente um ID exclusivo ao seu projeto. Consulte "Noções básicas sobre projetos do Firebase" para saber como o Firebase usa o ID do projeto.

Observação:não é possível mudar o ID do projeto depois que o Firebase provisiona recursos para ele. Para usar um identificador específico, é necessário editar seu ID do projeto durante essa etapa de configuração.

3. Clique em Continuar.
4. Configure o Google Analytics para o projeto e tenha uma experiência ideal ao usar qualquer um dos seguintes produtos do Firebase:

• Firebase Crashlytics
• Firebase Previsões
• Firebase Cloud Messaging
• Mensagens no app do Firebase
• Configuração remota do Firebase
• Teste A/B do Firebase

Quando solicitado, selecione para usar uma conta do Google Analytics ou criar uma nova. Se você optar por criar uma nova conta, selecione seu local de relatórios do Analytics e aceite as configurações de compartilhamento de dados e os termos do Google Analytics relacionados ao seu projeto.

5. Clique em Criar projeto (ou Adicionar Firebase, se você estiver usando um projeto do GCP).

O Firebase provisiona recursos automaticamente para seu projeto. Quando o processo for concluído, você será direcionado para a página de visão geral do seu projeto no Console do Firebase.

Registrar o app no Firebase

Depois de criar um projeto do Firebase, é possível adicionar o app para iOS a ele.

Consulte Noções básicas sobre projetos do Firebase para saber mais sobre práticas recomendadas e considerações sobre como adicionar apps a um projeto do Firebase, incluindo como lidar com diversas variantes de build.

1. Acesse o Console do Firebase.
2. No centro da página de visão geral do projeto, clique no ícone iOS para iniciar o fluxo de trabalho de configuração.

Se você já adicionou um app ao seu projeto do Firebase, clique em "Adicionar app" para exibir as opções da plataforma.

3. Insira o ID do pacote do seu app no campo ID do pacote do iOS.
4. (Opcional) Insira outras informações do app: apelido do app e ID da App Store.
5. Clique em Registrar app.

Adicionar um arquivo de configuração do Firebase

1. Clique em Fazer o download do GoogleService-Info.plist para receber o arquivo de configuração do Firebase para iOS (GoogleService-Info.plist).
2. Mova o arquivo de configuração para a raiz do seu projeto Xcode. Quando solicitado, selecione a opção de adicionar o arquivo de configuração a todos os destinos.

Se o projeto tiver vários IDs de pacotes, associe cada ID a um app registrado no Console do Firebase para que tenha o próprio arquivo GoogleService-Info.plist.

Feche o Xcode.

Adicionar SDKs do Firebase ao seu app

Recomendamos o uso do CocoaPods para instalar as bibliotecas do Firebase. No entanto, se você prefere não usar o CocoaPods, é possível integrar os frameworks do SDK diretamente ou usar a versão Beta do Gerenciador de pacotes Swift.

1. Crie um Podfile se ainda não tiver um. Se você estiver usando o exemplo de início rápido, o projeto do Xcode e o Podfile (com pods) já estarão presentes.

$ cd MessagingExample
$ pod init

2. No seu Podfile, adicione os pods do Firebase que você quer usar no app.

É possível adicionar qualquer um dos produtos do Firebase compatíveis ao app para iOS.

Na amostra de início rápido, os SDKs do Google Analytics e do Firebase Cloud Messaging foram adicionados.

# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'

# Add the pod for Firebase Cloud Messaging
pod 'Firebase/Messaging'

3. Instale os pods e abra o arquivo .xcworkspace para ver o projeto no Xcode:

$ pod install

4. Abra MessagingExample.xcworkspace e clique em Próxima no console do Firebase.

Inicializar o Firebase no seu app

É necessário adicionar o código de inicialização do Firebase ao seu app.

Importe o módulo do Firebase e configure uma instância compartilhada. No exemplo de início rápido, o módulo do Firebase já está importado.

1. Importe o módulo do Firebase no UIApplicationDelegate:

AppDelegate.swift

import UIKit
import Firebase // Add this line

2. Configure uma instância compartilhada do FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do app:

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure() // Add this line
  return true
}

3. Clique em Próxima no console do Firebase.
4. Os SDKs do Firebase são adicionados ao seu app. Clique em Continuar no console.

5. Como configurar o cliente do FCM

Fazer upload da chave de autenticação de APNs

Faça upload da chave de autenticação de APNs para o Firebase.

1. No seu projeto do Console do Firebase, selecione o ícone de engrenagem, Configurações do projeto e a guia Cloud Messaging.
2. Em Chave de autenticação de APNs, na seção Configuração do app para iOS, clique no botão Fazer upload.
3. Navegue até o local onde você salvou a chave, selecione-a e clique em Abrir. Adicione o ID da chave (disponível em Certificates, Identifiers & Profiles no Apple Developer Member Center) e clique em Upload.

Registrar o app para receber notificações remotas

Na inicialização ou no ponto desejado do fluxo do seu aplicativo, registre-o para receber notificações remotas.

Na amostra do guia de início rápido, registerForRemoteNotifications já foi adicionado.

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure()
  // [START register for remote notifications]
  if #available(iOS 10.0, *) {
    // For iOS 10 display notification (sent via APNS)
    UNUserNotificationCenter.current().delegate = self
        
    let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
    UNUserNotificationCenter.current().requestAuthorization(options: authOptions, completionHandler: {_, _ in })
  } else {
    let settings: UIUserNotificationSettings = UIUserNotificationSettings(types: [.alert, .badge, .sound], categories: nil)
    application.registerUserNotificationSettings(settings)
  }

  application.registerForRemoteNotifications()
  // [END register for remote notifications]
  return true
}

Atribua a propriedade de delegado de UNUserNotificationCenter adicionando estas linhas ao final de AppDelegate.swift.

AppDelegate.swift

@available(iOS 10, *)
extension AppDelegate : UNUserNotificationCenterDelegate {

  // Receive displayed notifications for iOS 10 devices.
  func userNotificationCenter(_ center: UNUserNotificationCenter,
                              willPresent notification: UNNotification,
    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    let userInfo = notification.request.content.userInfo

    // Print full message.
    print(userInfo)

    // Change this to your preferred presentation option
    completionHandler([[.alert, .sound]])
  }

  func userNotificationCenter(_ center: UNUserNotificationCenter,
                              didReceive response: UNNotificationResponse,
                              withCompletionHandler completionHandler: @escaping () -> Void) {
    let userInfo = response.notification.request.content.userInfo

    // Print full message.
    print(userInfo)

    completionHandler()
  }
}

Definir a delegação de mensagens

Para receber tokens de registro, implemente o protocolo de delegação de mensagens e defina a propriedade delegate do FIRMessaging depois de chamar [FIRApp configure]. Por exemplo, se o delegado do aplicativo estiver em conformidade com o protocolo de delegação de mensagens, você poderá configurá-lo como seu próprio delegado em application:didFinishLaunchingWithOptions:. Na amostra do guia de início rápido, ele já está definido.

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure()
  Messaging.messaging().delegate = self // Add this line
  // [START register for remote notifications]
  if #available(iOS 10.0, *) {
    // For iOS 10 display notification (sent via APNS)
    UNUserNotificationCenter.current().delegate = self
        
    let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
    UNUserNotificationCenter.current().requestAuthorization(options: authOptions, completionHandler: {_, _ in })
  } else {
    let settings: UIUserNotificationSettings = UIUserNotificationSettings(types: [.alert, .badge, .sound], categories: nil)
    application.registerUserNotificationSettings(settings)
  }

  application.registerForRemoteNotifications()
  // [END register for remote notifications]
  return true
}

Atribua a propriedade de delegado de FIRMessaging adicionando estas linhas ao final de AppDelegate.swift.

AppDelegate.swift

extension AppDelegate : MessagingDelegate {
  func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
    print("Firebase registration token: \(String(describing: fcmToken))")
    
    let dataDict:[String: String] = ["token": fcmToken ?? ""]
    NotificationCenter.default.post(name: Notification.Name("FCMToken"), object: nil, userInfo: dataDict)
  }
}

Adicionar recursos

Você adicionou o recurso de notificações push na seção "Criar um ID do app", mas também precisa adicionar esse recurso no Xcode seguindo estas etapas (as etapas abaixo são do Xcode 12.3):

1. Clique no nome do projeto na área do navegador.
2. Clique em Assinatura e recursos.
3. Clique em + Capacidade.

4. Clique duas vezes em Modos de plano de fundo.
5. Clique em + Capacidade novamente.
6. Clique duas vezes em Notificações push.
7. Marque Remote notifications nas seções Background Modes.

6. Enviar uma mensagem de notificação

Para enviar uma mensagem de teste, siga estas etapas:

1. Instale e execute o app no dispositivo de destino. Você precisará aceitar a solicitação de permissão para receber notificações remotas.
2. Extraia o token de registro do registro do Xcode.

3. Verifique se o app está em segundo plano no dispositivo.
4. Abra o Editor do Notificações e selecione Nova notificação.
5. Digite o texto da mensagem.
6. Selecione Enviar mensagem de teste.
7. No campo Adicionar um token de registro do FCM, insira o token de registro obtido na etapa 2.
8. Clique em Testar.

Depois de clicar em Testar, o dispositivo cliente escolhido (com o app em segundo plano) vai receber a notificação na central de notificações.

Para saber mais sobre a entrega de mensagens ao seu app, consulte o painel de relatórios do FCM, que registra o número de mensagens enviadas e abertas em dispositivos iOS e Android.

7. Parabéns

Parabéns, você enviou uma mensagem de teste!

Há muitas outras funções e configurações no FCM, como a inscrição em tópicos.

Confira o documento oficial para desenvolvedores se tiver interesse.

Qual é a próxima etapa?

Confira alguns destes codelabs.

• Android avançado no Kotlin 01.2:Firebase Cloud Messaging no Android

Leia mais

• Documento oficial do Firebase Cloud Messaging