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

Seguir
Avatar
Jared Ornstead
Updated
Documento

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 da aplicação configurada para notificações push
  • Perfil de provisionamento: Autoriza os dispositivos a executar a aplicação 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 equipa de programadores 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 ficheiro 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. Aceder 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 utilizador:
    • Endereço de e-mail do utilizador: Introduza o seu endereço de e-mail (utilizado na conta de Programador 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 ficheiro CSR: Clique em Continuar e guarde o ficheiro .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 descarregará da Apple mais tarde.

Passo 2: Criar ou configurar o ID da aplicação

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

Compreender as IDs de aplicações

Estrutura da App ID

Uma App ID identifica de forma exclusiva a sua aplicação 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 aplicação explícito: As IDs de aplicações curingas (contendo *) não podem utilizar as notificações push. Se tiver um ID de aplicação com curinga existente, crie um novo ID de aplicação explícito para aplicações activadas por push.

Criar nova ID de aplicativo

Passos de configuração da ID de aplicação

Crie uma nova ID de aplicação no portal de programadores da Apple com as notificações push activadas.

  1. Aceder ao Portal de programadores: 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 aplicação

Create App ID Button

Configurar detalhes do ID da aplicação

Preencha as informações do ID da aplicação e active 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 secção Prefixo do ID da aplicação, utilize o ID da equipa predefinido
  5. Introduzir ID do pacote explícito: No campo ID do pacote, introduza o identificador da aplicação 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 ficheiro Info.plist da sua aplicação e nas definiçõ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 secção Serviços da aplicação.

  1. Desloque-se para Capacidades: Localize a secção "Serviços de aplicações"
  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 definições
  4. Confirmar a ID da aplicação: 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. Registar a ID da aplicação: 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 a sua aplicação.

Aceder às definições do ID da aplicação

Editar a configuração do ID da aplicação

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 da aplicação: 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 secçã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 secçã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 ficheiro) e selecione o ficheiro .certSigningRequest que criou no Passo 1
  5. Gerar: Clique em Continuar (ou Gerar) para criar o certificado

Push Notifications Certificate Options

Upload CSR

Descarregar 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. Descarregar 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 ficheiro .cer transferido 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 descarregado 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 rato na seleção e escolha "Exportar 2 itens..."
  5. Nomear ficheiro: 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 ficheiro
  7. Definir palavra-passe: Introduza uma palavra-passe forte para proteger o ficheiro .p12
  8. Confirmar exportação: Clique em OK e introduza a palavra-passe de início de sessão do Mac, se solicitado

Aviso de segurança: O ficheiro .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 Definições de ID de aplicação: Navegue de volta para a configuração do seu ID de aplicativo no portal do desenvolvedor da Apple
  2. Certificado de produção: Na secção Notificações Push, clique em "Criar certificado..." em Certificado SSL de produção
  3. Siga o mesmo processo: Carregar CSR, gerar certificado, descarregar 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: As aplicações submetidas à App Store e distribuídas 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 a sua aplicação 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 da aplicação, os certificados e os dispositivos registados para permitir a instalação e o teste da aplicação.

Tipo de perfil Finalidade Limite de dispositivos
Desenvolvimento de aplicações iOS Testes internos em dispositivos registados Até 100 dispositivos por perfil
Ad Hoc Distribuição a testadores fora da equipa 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. Aceder 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 aplicações iOS) na secção Development (Desenvolvimento)
  4. Continuar: Clique no botão Continuar
  5. Selecionar ID da aplicação: No menu pendente, escolha o ID da aplicação configurado 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 secçã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)

Registo do dispositivo: Os dispositivos de teste têm de ser registados no portal de programadores da Apple antes de poderem ser adicionados aos perfis de aprovisionamento. Registe os dispositivos por UDID na secção Dispositivos.

Instalar o perfil de provisionamento

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

  1. Descarregar 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 da aplicação: 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 da aplicação
  • Capacidades: Capacidade de notificações push activada 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 a aplicação e conceder permissões de notificação push quando solicitado
  3. Registar 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 activadas nas capacidades Ativar as notificações push no separador 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 registados Renovar o perfil de provisionamento e garantir que os dispositivos estão registados
Incompatibilidade da ID do pacote A ID do pacote do Xcode não corresponde à ID da aplicação Atualizar o ID do pacote no Xcode para corresponder exatamente ao identificador do ID da aplicação

Ferramentas de teste: Utilize a Consola 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 registo de APNs e o tratamento de notificações no código da sua aplicação 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 deteçã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 definições do Xcode Archive
  • TestFlight: As compilações do TestFlight usam o ambiente de produção-teste com o certificado de produção