Partilhar via


Recursos Wallet no Xamarin.iOS

A adição de funcionalidades a um aplicativo geralmente requer uma configuração de provisionamento adicional. Este guia explica a configuração necessária para as funcionalidades da Wallet.

Wallet é um aplicativo que armazena e exibe códigos de barras e outros conteúdos que permitem aos usuários exibir tíquetes, passagens aéreas e cupons diretamente do dispositivo. Essas informações são armazenadas em um passe. Por exemplo, uma passagem aérea ou um único tíquete seriam um único passe.

Os desenvolvedores podem trabalhar com o Wallet de várias maneiras:

  • Para criar um passe, um aplicativo não precisa ser criado. Um Passfile é um arquivo compactado que contém alguns arquivos JSON e arquivos de metadados opcionais. Para prepará-lo, são necessários uma ID de Tipo de Passe e um Certificado de passe. Em seguida, essas informações são declaradas em um arquivo JSON. Mais informações de como provisionar um Passfile podem ser encontradas no guia Introdução ao PassKit.

  • Aplicativos complementares são gravados para distribuir passes. Eles também têm a funcionalidade de criar, editar e atualizar passes e, em seguida, adicioná-los no aplicativo Wallet. Um bom exemplo desse tipo de aplicativo seria um aplicativo de cinema. Quando um usuário compra um tíquete usando o aplicativo, esse tíquete pode ser adicionado diretamente do aplicativo ao Wallet. Para usar um aplicativo complementar, o perfil de provisionamento deve incluir uma ID do aplicativo com os recursos do Wallet, que podem ser definidos seguindo as etapas abaixo. Seu aplicativo também deve incluir os direitos necessários.

  • Aplicativos de canal são aplicativos que não manipulam passes diretamente. Eles têm uma interação mínima com o passe além de recebê-lo e dar ao usuário a opção de adicioná-lo ao Wallet. Esses aplicativos não precisam de nenhum provisionamento ou direito especial, mas usam alguns métodos do PassKit Framework.

Centro de desenvolvedores

Para criar um novo perfil de provisionamento a ser usado com o Wallet, faça o seguinte:

  1. Procure a seção Certificados, Identificadores e Perfis do Portal do Desenvolvedor da Apple.

  2. Em Identificadores, procure IDs do aplicativo:

    App ID selection

  3. Clique no ícone + no canto superior direito da página.

  4. Registre uma nova ID do aplicativo, dando a ela um nome e um identificador de lote. (Observe que esse identificador de lote deve corresponder à ID de lote no projeto):

    Add App ID details

  5. Selecione o serviço de aplicativo Wallet na lista de serviços:

    Select service screen

  6. Pressione Continuar e, em seguida, Registrar para criar a ID do aplicativo.

Se necessário, as IDs do aplicativo existentes poderão ser editadas para adicionar a capacidade do Wallet.

Agora esta ID do aplicativo pode ser usada para gerar, ou gerar novamente, um novo perfil de provisionamento, conforme descrito no guia Trabalhando com funcionalidades:

Using newly created App ID to create provisioning profile

Para obter mais informações de como usar o Wallet, consulte os seguintes guias:

Próximas etapas

A lista a seguir descreve as etapas adicionais que precisam ser executadas:

  • Use o namespace do framework em seu aplicativo.
  • Adicione os direitos necessários para seu aplicativo. As informações sobre os direitos necessários e como adicioná-los estão detalhadas no guia Trabalhando com direitos.
  • Na Assinatura de Pacote do iOS do aplicativo, certifique-se de que Direitos Personalizados está definido como Entitlements.plist. Esta não é a configuração padrão para builds de depuração e do simulador do iOS.

Se você encontrar problemas com serviços de aplicativos, consulte a seção Solução de problemas do guia principal.