Funzionalità Portafoglio in Xamarin.iOS

L'aggiunta di funzionalità a un'applicazione spesso richiede un'ulteriore configurazione del provisioning. Questa guida illustra la configurazione necessaria per le funzionalità Portafoglio.

Portafoglio è un'app che consente di archiviare e visualizzare codici a barre e altro contenuto consentendo agli utenti di visualizzare biglietti, carte d'imbarco e buoni sconto direttamente dal dispositivo. Queste informazioni vengono archiviate in un pass. Una carta d'imbarco o un singolo biglietto, ad esempio, costituiscono un singolo pass.

Gli sviluppatori possono operare con Portafoglio in diversi modi:

• Per creare un pass non è necessario compilare l'applicazione. Un Passfile è un archivio compresso che contiene alcuni file JSON e file di metadati facoltativi. Per prepararlo sono necessari un ID del tipo di pass e un certificato per il pass. Queste informazioni vengono quindi dichiarate in un file JSON. Altre informazioni sul provisioning di un Passfile sono disponibili nella guida Introduction to PassKit (Introduzione a PassKit).

• Per distribuire pass è possibile scrivere app complementari che includono anche le funzionalità necessarie per creare, modificare e aggiornare i pass e per aggiungerli quindi all'app Portafoglio. Un buon esempio di questo tipo di app è un'app per il cinema: dopo che un utente ha acquistato un biglietto tramite l'app, questo potrà essere aggiunto a Portafoglio direttamente dall'app. Per usare un'app complementare, il profilo di provisioning deve includere un ID app con le funzionalità Portafoglio che è possibile impostare seguendo i passaggi indicati di seguito. L'app deve includere anche gli entitlement necessari.

• Le app Conduit sono app che non modificano direttamente i pass. A parte la possibilità di ricevere il pass e offrire all'utente l'opzione di aggiungerlo all'app Portafoglio, l'interazione di queste app con il pass è minima. Non necessitano di provisioning o entitlement speciali, ma usano alcuni metodi del framework di PassKit.

Centro per sviluppatori

Per creare un nuovo profilo di provisioning per l'uso con Portafoglio, seguire questa procedura:

1. Passare alla sezione Certificates, Identifiers & Profiles (Certificati, identificatori e profili) del portale per sviluppatori Apple.

2. In Identifiers (Identificatori) passare a App IDs (ID app):

   

3. Fare clic sull'icona + nell'angolo superiore destro della pagina.

4. Registrare un nuovo ID app assegnandogli un valore nel campo Name (Nome) e un identificatore del bundle. Si noti che questo identificatore del bundle deve corrispondere all'ID bundle presente nel progetto:

   

5. Selezionare il servizio app Wallet (Portafoglio) dall'elenco dei servizi:

   

6. Premere Continue (Continua) e quindi Register (Registra) per creare l'ID app.

Se necessario, è possibile modificare gli ID app esistenti per aggiungere la funzionalità Portafoglio.

Questo ID app può ora essere usato per generare o rigenerare un nuovo profilo di provisioning, come descritto nella guida Working with Capabilities (Uso delle funzionalità):

Per altre informazioni sull'uso di Portafoglio, vedere le guide seguenti:

• Introduction to PassKit (Introduzione a PassKit)

Passaggi successivi

Nell'elenco seguente vengono descritti i passaggi aggiuntivi che potrebbero essere necessari:

• Usare lo spazio dei nomi del framework nell'app.
• Aggiungere all'app gli entitlement necessari. Per informazioni dettagliate sugli entitlement necessari e su come aggiungerli, vedere la guida Uso degli entitlement.
• In Firma del bundle iOS dell'app assicurarsi che Entitlement personalizzati sia impostato su Entitlements.plist. Questa non è l'impostazione predefinita per le build di debug e del simulatore iOS.

In caso di problemi con i servizi app, vedere la sezione Troubleshooting (Risoluzione dei problemi) della guida principale.