Desinstalar o rastreamento - (APNS) Serviço de notificações push da Apple

Seguir
Avatar
Jared Ornstead
Updated

Guia de configuração do Serviço de Notificação por Push da Apple (APNs)

Configure os certificados e perfis de provisionamento do Serviço de Notificação por Push da Apple para permitir a entrega de notificações por push e o rastreamento de desinstalação para aplicativos iOS usando o SDK Singular.

Visão geral

Pré-requisitos

Habilite as notificações por push de APNs criando certificados SSL e perfis de provisionamento no Apple Developer Member Center.

Componentes necessários:

  • Certificado SSL: Associado à ID do aplicativo configurada para notificações push
  • Perfil de provisionamento: Autoriza os dispositivos a executar o aplicativo durante o desenvolvimento e os testes
  • Conta de desenvolvedor da Apple: Associação ativa necessária para a criação do certificado
  • Computador Mac: Necessário para acesso ao Keychain e geração de certificados

Portal do desenvolvedor da Apple: Toda a gestão de certificados e perfis ocorre no Apple Developer Member Center. Certifique-se de que tem as permissões adequadas na equipe de desenvolvedores da sua organização.

Tipos de certificados

A Apple fornece dois tipos de certificados SSL APNs para diferentes ambientes.

Tipo de certificado Ambiente Caso de uso
Certificado SSL de desenvolvimento Caixa de areia Testes internos e compilações de desenvolvimento
Certificado SSL de produção Produção Lançamentos da App Store e compilações do TestFlight

Ambiente de correspondência crítico: Os aplicativos devem usar certificados que correspondam ao seu ambiente de compilação. Os aplicativos de produção com certificados de desenvolvimento não receberão notificações push.

Etapa 1: gerar solicitação de assinatura de certificado

Crie um arquivo de Solicitação de assinatura de certificado (CSR) no seu Mac para autenticar a criação do certificado SSL.

Criar arquivo CSR

Usando o Acesso às chaves

Gere CSR por meio do aplicativo Keychain Access no macOS.

  1. Abra o Acesso às Chaves: Navegue até Aplicativos → Utilitários → Acesso às Chaves, ou use a pesquisa do Spotlight (Cmd+Espaço)
  2. Acessar ao Assistente de Certificados: na barra de menus, selecione Acesso às Chaves → Assistente de Certificados → Solicitar um Certificado a uma Autoridade de Certificação...
  3. Introduzir informações do usuário:
    • Endereço de e-mail do usuário: Introduza o seu endereço de e-mail (utilizado na conta de Desenvolvedor Apple)
    • Nome comum: Introduza um nome descritivo (por exemplo, "YourCompany APNs Certificate")
    • Endereço de e-mail da CA: Deixar em branco
  4. Selecionar tipo de pedido: Escolha a opção "Guardado no disco" (necessário para a criação manual de certificados)
  5. Guardar arquivo CSR: Clique em Continuar e guarde o arquivo .certSigningRequest numa localização memorável no seu Mac

Certificate Signing Request Creation

Armazenamento da chave privada: O Keychain Access gera e armazena automaticamente uma chave privada ao criar a CSR. Esta chave privada é emparelhada com o certificado SSL que baixará da Apple mais tarde.

Passo 2: Criar ou configurar o ID do aplicativo

Crie uma nova ID de aplicativo ou configure a ID de aplicativo existente para ativar a capacidade de Notificação Push.

Compreender as IDs de aplicativos

Estrutura da App ID

Uma App ID identifica de forma exclusiva o seu aplicativo iOS e tem de ser um identificador explícito (não um wildcard) para suportar as Notificações Push.

Formato: Notação de domínio invertida (por exemplo, com.yourcompany.appname)

É necessário um ID de aplicativo explícito: As IDs de aplicativos curingas (contendo *) não podem utilizar as notificações push. Se tiver um ID de aplicativo com curinga existente, crie um novo ID de aplicativo explícito para aplicativos ativados por push.

Criar nova ID de aplicativo

Passos de configuração da ID de aplicativo

Crie uma nova ID de aplicativo no portal de desenvolvedores da Apple com as notificações push ativadas.

  1. Acessar ao Portal de desenvolvedores: Navegue até ao Apple Developer Member Centere inicie sessão
  2. Abra Certificados e identificadores: Selecione "Certificates, Identifiers & Profiles" (Certificados, identificadores e perfis)
  3. Navegue até Identifiers (Identificadores): Na barra lateral esquerda, selecione "Identifiers" (Identificadores)
  4. Selecionar Plataforma: No menu suspenso superior esquerdo, selecione "iOS Apps" (ou "iOS, tvOS, watchOS" na interface mais recente)
  5. Criar identificador: Clique no botão "+" para criar um novo ID de aplicativo

Create App ID Button

Configurar detalhes do ID do aplicativo

Preencha as informações do ID do aplicativo e ative a capacidade de notificações push.

  1. Selecionar tipo: Escolha "App IDs" (não App Clips)
  2. Selecionar tipo de pacote: Escolha "App" como o tipo
  3. Introduzir descrição: Forneça um nome com significado (por exemplo, "YourApp Production")
  4. Definir ID do pacote: Na seção Prefixo do ID do aplicativo, utilize o ID da equipe predefinido
  5. Introduzir ID do pacote explícito: No campo ID do pacote, introduza o identificador do aplicativo exatamente como aparece no Xcode (por exemplo, com.yourcompany.appname)

Bundle ID Configuration

Correspondência do ID do pacote: O valor do ID do pacote deve corresponder exatamente ao identificador no arquivo Info.plist do seu aplicativo e nas configurações do projeto Xcode. A sensibilidade a maiúsculas e minúsculas é importante.

Ativar as notificações push

Active a capacidade de Notificações Push na seção Serviços do aplicativo.

  1. Desloque-se para Capacidades: Localize a seção "Serviços de aplicativos"
  2. Ativar as notificações push: Marque a caixa de verificação "Push Notifications" (Notificações Push)
  3. Rever a configuração: Clique em Continuar e verifique as configurações
  4. Confirmar a ID do aplicativo: Verifique se o Identificador mostra corretamente o seu ID do Pacote
  5. Verificar estado: Confirmar que as Notificações Push são apresentadas como "Configurável"
  6. Registrar a ID do aplicativo: Clique em Enviar para criar a ID do aplicativo

Enable Push Notifications

Etapa 3: Configurar o certificado de notificação por push

Gere certificados SSL para as notificações push para permitir a comunicação das APNs com o seu aplicativo.

Acessar às configurações do ID do aplicativo

Editar a configuração do ID do aplicativo

Abra as configurações de ID do aplicativo para criar certificados SSL para ambientes de desenvolvimento e produção.

  1. Navegue até Identificadores: No portal do desenvolvedor da Apple, vá para Certificados, Identificadores e Perfis → Identificadores
  2. Selecione ID do aplicativo: Clique no ID de aplicativo que você criou ou deseja configurar
  3. Editar configuração: Clique no botão "Edit" (ou a App ID abre diretamente no modo de edição)
  4. Localizar Push Notifications (Notificações Push): Desloque-se para a seção "Push Notifications" (Notificações Push) na lista de capacidades

Edit App ID

Criar certificado SSL de desenvolvimento

Gerar certificado de desenvolvimento

Crie um certificado de desenvolvimento para testar as notificações push durante o desenvolvimento.

  1. Iniciar a criação do certificado: Na seção Push Notifications (Notificações Push), clique em "Create Certificate..." (Criar Certificado...) em Development SSL Certificate (Certificado SSL de Desenvolvimento)
  2. Rever as instruções: Leia as informações "Sobre a criação de um pedido de assinatura de certificado (CSR)
  3. Continuar: Clique no botão Continuar
  4. Carregar CSR: Clique em "Choose File..." (Escolher arquivo) e selecione o arquivo .certSigningRequest que criou no Passo 1
  5. Gerar: Clique em Continuar (ou Gerar) para criar o certificado

Push Notifications Certificate Options

Upload CSR

Baixar e instalar o certificado

Faça o download do certificado SSL e instale-o no Mac Keychain para usar com as notificações por push.

  1. Baixar certificado: Clique no botão "Download" para salvar o arquivo .cer no seu Mac
  2. Processo completo: Clique em "Done" (Concluído) para fechar o fluxo de criação do certificado
  3. Instalar o certificado: Localize o arquivo .cer baixado e faça duplo clique para o adicionar ao Keychain
  4. Verificar a instalação: Abra o Keychain Access e navegue até à categoria "My Certificates" (Os meus certificados)
  5. Localizar o certificado: Localize o certificado "Apple Development iOS Push Services: your.bundle.id" com a chave privada associada

Emparelhamento de certificados: O certificado baixado emparelha-se automaticamente com a chave privada gerada durante a criação do CSR. Ambos têm de estar presentes no Keychain para que as notificações push funcionem.

Exportar certificado como .p12

Gerar arquivo P12

Exportar certificado e chave privada como arquivo .p12 para carregar em serviços de notificação por push (como o Singular).

  1. Abra o Acesso às Chaves: Navegue até a categoria "Meus certificados
  2. Expandir certificado: Clique no triângulo de divulgação ao lado do certificado "Apple Development iOS Push Services" para revelar a chave privada
  3. Selecionar ambos os itens: Mantenha premida a tecla Comando e clique para selecionar o certificado e a chave privada
  4. Exportar: Clique com o botão direito do mouse na seleção e escolha "Exportar 2 itens..."
  5. Nomear arquivo: Guardar com um nome descritivo (por exemplo, "YourApp_Development_APNs.p12")
  6. Selecionar o formato: Certifique-se de que "Personal Information Exchange (.p12)" está selecionado como formato de arquivo
  7. Definir senha: Introduza uma senha forte para proteger o arquivo .p12
  8. Confirmar exportação: Clique em OK e introduza a senha de início de sessão do Mac, se solicitado

Aviso de segurança: O arquivo .p12 contém a sua chave privada e o seu certificado. Guarde-o de forma segura e nunca o submeta a repositórios públicos. Lembre-se da senha - ela não pode ser recuperada.

Criar certificado SSL de produção

Geração do certificado de produção

Repita o processo de criação de certificados para o Certificado SSL de produção necessário para as versões da App Store.

  1. Regressar às Configurações de ID de aplicativo: Navegue de volta para a configuração do seu ID de aplicativo no portal do desenvolvedor da Apple
  2. Certificado de produção: Na seção Notificações Push, clique em "Criar certificado..." em Certificado SSL de produção
  3. Siga o mesmo processo: Carregar CSR, gerar certificado, baixar e instalar no Keychain
  4. Exportar P12 de produção: Exporte como .p12 com um nome descritivo (por exemplo, "YourApp_Production_APNs.p12")
  5. Armazenamento seguro: Armazene o certificado de produção de forma segura e separada do certificado de desenvolvimento

Certificado de produção necessário: Os aplicativos submetidos à App Store e distribuídos através do TestFlight TÊM de utilizar certificados SSL de produção. Os certificados de desenvolvimento falharão no ambiente de produção.

Passo 4: Criar perfil de aprovisionamento

Crie perfis de aprovisionamento para autorizar dispositivos a executar o seu aplicativo durante as fases de desenvolvimento e teste.

Noções básicas sobre perfis de provisionamento

Tipos de perfil

Os perfis de aprovisionamento ligam o seu ID do aplicativo, os certificados e os dispositivos registrados para permitir a instalação e o teste do aplicativo.

Tipo de perfil Finalidade Limite de dispositivos
Desenvolvimento de aplicativos iOS Testes internos em dispositivos registrados Até 100 dispositivos por perfil
Ad Hoc Distribuição a testadores fora da equipe de desenvolvimento Até 100 dispositivos por perfil
Loja de aplicativos Distribuição da App Store e TestFlight Ilimitado (todos os dispositivos)

Criar perfil de desenvolvimento

Configuração do perfil de desenvolvimento

Criar perfil de provisionamento de desenvolvimento de aplicativo iOS para teste de notificação por push.

  1. Acessar aos perfis de aprovisionamento: No portal de desenvolvedores da Apple, navegue até Certificados, Identificadores e Perfis → Perfis
  2. Criar novo perfil: Clique no botão "+" para iniciar a criação do perfil
  3. Selecionar o tipo: Escolha "iOS App Development" (Desenvolvimento de aplicativos iOS) na seção Development (Desenvolvimento)
  4. Continuar: Clique no botão Continuar
  5. Selecionar ID do aplicativo: No menu pendente, escolha o ID do aplicativo configurada para as notificações push
  6. Continuar: Clique no botão Continuar

Configurar detalhes do perfil

Selecione certificados, dispositivos e nomeie o perfil de provisionamento.

  1. Selecione Certificado: Verifique o certificado de desenvolvimento do iOS associado à sua ID de aplicativo
  2. Continuar: Clique no botão Continuar
  3. Selecionar Dispositivos: Marque todos os dispositivos onde pretende testar as notificações push (devem ser pré-registados na seção Dispositivos)
  4. Continuar: Clique no botão Continuar
  5. Nomear perfil: Introduza um nome descritivo (por exemplo, "YourApp Development Push Testing")
  6. Generate Profile (Gerar perfil): Clique no botão Generate (Gerar)

Registro do dispositivo: Os dispositivos de teste têm de ser registrados no portal de desenvolvedores da Apple antes de poderem ser adicionados aos perfis de aprovisionamento. Registre os dispositivos por UDID na seção Dispositivos.

Instalar o perfil de provisionamento

Baixe e instale o perfil de provisionamento para uso no Xcode.

  1. Baixar o perfil: Clique no botão Download para salvar o arquivo .mobileprovision
  2. Instalar o perfil: Clique duas vezes no arquivo .mobileprovision baixado para adicioná-lo ao Xcode
  3. Verificar a instalação: Abra o Xcode → Preferências → Contas → Ver detalhes para confirmar que o perfil aparece
  4. Selecionar no projeto: Nas configurações do projeto Xcode, selecione o perfil de provisionamento em Signing & Capabilities

Expiração do perfil: Os perfis de provisionamento expiram após um ano. Renove os perfis expirados no portal de desenvolvedores da Apple e baixe novos arquivos .mobileprovision.

Verificação e teste

Verifique se a configuração de APNs está correta, testando a entrega de notificações push em dispositivos de desenvolvimento.

Lista de verificação de configuração

Verificação antes do teste

Confirme se todos os componentes estão corretamente configurados antes de testar as notificações push.

  • ID do aplicativo: ID de aplicativo explícita com o recurso de notificações por push ativado
  • Certificados SSL: Certificados de desenvolvimento e produção criados e exportados como .p12
  • Perfil de provisionamento: Perfil de desenvolvimento instalado no Xcode com ID de aplicativo e dispositivos corretos
  • Correspondência de ID de pacote: A ID do pacote do projeto Xcode corresponde exatamente ao identificador da ID do aplicativo
  • Capacidades: Capacidade de notificações push ativada no Xcode Assinatura e capacidades
  • Porta-chaves: Certificados com chaves privadas presentes no Mac Keychain "Meus Certificados"

Teste de notificações push

Procedimento de teste

Enviar notificação push de teste para verificar a configuração de APNs.

  1. Criar e instalar: Criar aplicativo com perfil de provisionamento de desenvolvimento e instalar no dispositivo de teste
  2. Solicitar permissões: Iniciar o aplicativo e conceder permissões de notificação push quando solicitado
  3. Registrar o token do dispositivo: Verificar se o aplicativo recebe o token do dispositivo APNs nos logs do console
  4. Enviar notificação de teste: Utilizar a ferramenta de teste de APNs ou o serviço push para enviar a notificação de teste
  5. Verificar entrega: Confirmar se a notificação aparece no dispositivo

Problemas comuns

Problema Causa Solução
Nenhum token de dispositivo recebido As notificações push não estão ativadas nas capacidades Ativar as notificações push na guia Assinatura e capacidades do Xcode
Erro de certificado não encontrado Falta uma chave privada no Keychain Exportar novamente o certificado incluindo a chave privada do Mac original que criou o CSR
As notificações push não são entregues Ambiente errado (dev vs prod) Verificar se o tipo de certificado corresponde à configuração de compilação
Perfil de aprovisionamento inválido Perfil expirado ou dispositivos não registrados Renovar o perfil de provisionamento e garantir que os dispositivos estão registrados
Incompatibilidade da ID do pacote A ID do pacote do Xcode não corresponde à ID do aplicativo Atualizar o ID do pacote no Xcode para corresponder exatamente ao identificador do ID do aplicativo

Ferramentas de teste: Utilize o Console de Notificações Push da Apple no Xcode ou ferramentas de terceiros como o Pusher, Knuff ou comandos curl para enviar notificações de teste durante o desenvolvimento.

Próximos passos

Com os APNs configurados, integre o tratamento de notificações push no seu aplicativo e configure o Singular para rastreamento de desinstalação.

Guias de integração

Concluir sua configuração

  • Implementação do iOS Push: Implementar o registro de APNs e o tratamento de notificações no código do seu aplicativo iOS
  • Integração do SDK do Singular: Siga o Guia de implementação do Singular SDK do iOSpara habilitar o rastreamento de desinstalação
  • Carregar certificado para o Singular: Faça o upload do seu certificado .p12 para a configuração do aplicativo Singular para rastreamento de desinstalação
  • Testar o rastreamento de desinstalação: Verifique se a detecção de desinstalação funciona corretamente antes do lançamento da produção

Implantação de produção

Requisitos de envio da App Store:

  • Certificado de produção: Usar o certificado SSL de produção para compilações da App Store
  • Perfil da App Store: Criar e usar o perfil de provisionamento de distribuição da App Store
  • Assinatura de código: Assegurar que o certificado e o perfil corretos estão selecionados nas configurações do Xcode Archive
  • TestFlight: As compilações do TestFlight usam o ambiente de produção-teste com o certificado de produção