Converter PNG para PKPASS

Um PNG precisa fazer parte de um pass do Apple Wallet quando um ingresso, cartão de embarque, cartão de fidelidade ou cupom precisa ser instalado no Wallet em vez de ser compartilhado como uma imagem. O PNG fornece o material gráfico; o pacote PKPASS resultante fornece campos estruturados, dados de código de barras e uma assinatura criptográfica.

O que é o formato PNG

PNG é um formato de imagem rasterizada sem perdas que oferece suporte a transparência, cores indexadas, escala de cinza e imagens RGB ou RGBA em cores completas. Web designers, desenvolvedores de software, fotógrafos, editores gráficos e usuários que criam capturas de tela, logotipos, códigos QR e materiais digitalizados costumam utilizá-lo. Aplicativos como Adobe Photoshop, Affinity Photo, GIMP e Preview podem criar ou exportar arquivos PNG.

Um PNG contém pixels, não instruções do Wallet. Normalmente, ele não contém os campos do pass, o payload do código de barras, a URL de atualização, o layout do Apple Wallet ou os dados de assinatura exigidos pelo PKPASS. Um gerador de pass pode usá-lo como ícone, logotipo, faixa, miniatura, plano de fundo ou outro image asset compatível.

O que é o formato PKPASS

PKPASS é o formato de pacote de pass do Apple Wallet. Um arquivo com a extensão .pkpass é um arquivo ZIP contendo arquivos como pass.json, image assets, manifest.json e uma signature criptográfica.

O arquivo pass.json identifica o tipo de pass, o emissor, a equipe, o número de série, as cores, os campos, o código de barras, as datas e outros comportamentos do Wallet. manifest.json lista os arquivos do pacote e seus hashes SHA-1; signature assina esse manifesto com um certificado Apple Pass Type ID. O Wallet verifica a assinatura antes de aceitar o pass. Essa estrutura oferece suporte a cartões de embarque, ingressos de eventos, cupons, cartões de lojas e cartões de associação com dados legíveis por máquina e atualizáveis.

Como criar um PKPASS a partir de um PNG

Não existe uma conversão válida em um clique de um PNG independente. Crie um pass do Wallet e coloque o PNG dentro dele.

1. Prepare o material gráfico em um editor de imagens. Exporte um PNG RGB ou RGBA, remova metadados desnecessários e siga as dimensões exigidas pelo gerador de pass e as regras de nomenclatura de assets @2x ou @3x. Mantenha textos importantes e códigos de barras como campos do pass ou dados de código de barras, em vez de desenhá-los na imagem; o conteúdo incorporado não pode ser atualizado, localizado ou digitalizado de forma confiável.
2. Reúna os dados do pass: nome do emissor, tipo de pass, número de série, campos de exibição, formato e payload do código de barras, datas relevantes, cores e quaisquer informações de atualização. Uma captura de tela de um ingresso não fornece automaticamente esses valores. Se o PNG contiver um código de barras, decodifique-o separadamente e verifique o resultado.
3. Para geração programática, crie um Apple Developer Pass Type ID e obtenha seu certificado e sua chave privada. O identificador em pass.json deve corresponder ao certificado. O processo de assinatura também exige o certificado intermediário atual Apple Worldwide Developer Relations.
4. Use passkit-generator para um fluxo de trabalho Node.js reproduzível no macOS, Windows ou Linux. Instale-o com npm install passkit-generator, forneça pass.json, os PNG assets, o certificado Pass Type ID, a chave privada e o certificado intermediário da Apple e, em seguida, exporte o arquivo .pkpass gerado. A biblioteca cria o manifesto e a assinatura, evitando erros comuns de ZIP e assinatura manuais.
5. Para um fluxo de trabalho sem código ou hospedado, uma plataforma de pass como PassKit pode aceitar material gráfico, coletar campos do pass e dados de código de barras, assinar passes com as credenciais configuradas da Apple e distribuí-los por meio de um link de download ou e-mail. É um serviço de criação de passes, não um conversor de PNG: o emissor ainda precisa fornecer dados de pass e credenciais válidos. Analise o tratamento de dados antes de fazer upload de ingressos, documentos de identidade ou designs não lançados.
6. Abra o arquivo concluído em um iPhone ou iPad com o Apple Wallet e teste a instalação, a digitalização do código de barras, o contraste do texto, o dimensionamento da imagem, as datas e a versão mais antiga do iOS compatível. Não edite, recomprima nem adicione arquivos após a assinatura; qualquer alteração no pacote invalida a assinatura do manifesto.

Limites de qualidade e compatibilidade

O Apple Wallet não aceita um PNG renomeado para .pkpass, um ZIP contendo apenas uma imagem ou um arquivo não assinado. Um pacote utilizável precisa de um pass.json válido, arquivos com hashes corretos em manifest.json, uma signature criptográfica correspondente e uma estrutura de pass compatível.

A qualidade da imagem depende da resolução da fonte e do asset slot. Ampliar uma captura de tela pequena produz desfoque, enquanto textos renderizados no material gráfico podem ficar ilegíveis em diferentes telas. Use as funções e dimensões de imagem documentadas pela ferramenta de pass escolhida e mantenha os dados digitalizáveis do código de barras em um código de barras nativo do Wallet sempre que possível.

PKPASS foi desenvolvido para o Apple Wallet e não é o formato nativo de pass do Google Wallet ou de outras carteiras Android. Para distribuição no Android, use o formato de pass da plataforma de destino ou um serviço que gere versões específicas para cada plataforma. O suporte do Wallet, os requisitos de certificado, os campos do pass e o comportamento do código de barras também podem mudar de acordo com as especificações PassKit atuais da Apple; portanto, verifique o arquivo gerado em relação às versões compatíveis do iOS antes da distribuição.