Firmare l'app

I sistemi operativi hanno procedure di firma diverse, anche se concettualmente sono simili. È necessario firmare le app che vengono distribuite per l'utilizzo da parte di altri utenti. Anche se ArcGIS AppStudio eseguirà automaticamente il processo di firma e generazione delle app, sarà tuttavia necessario ottenere i file di firma da ogni fornitore del sistema operativo come input per AppStudio.

Preparare una nuova app

Prima di firmare e rilasciare la propria app, dovrebbe essere fornito un ID ArcGIS Client, un URI di reindirizzamento e una stringa di licenza. Mentre un'app può ancora essere costruita con senza un D ArcGIS Client o un URI di reindirizzamento, entrambi sono importanti in un'app che utilizza servizi ArcGIS.

È necessario un ID client ArcGIS, denominato anche AppID, per accesso di tipo named user per tutte le app. Per ottenere un ID Client, andare alla pagina https://developers.arcgis.com, accedere con le proprie credenziali di utenza sviluppatore, cliccare sul menu a discesa accanto alla Dashboard e scegliere Nuova Applicazione. Dopo la registrazione, si riceverà un ID client che può essere copiato nell'app AppStudio. Se si sta utilizzando ArcGIS AppStudio, un ID client può essere generato anche in Impostazioni > Licenzefacendo clic sul pulsante Registra.

Se l'app richiede l'accesso tramite utente già identificato, è necessario fornire anche un URI di reindirizzamento. Gli URI di reindirizzamento rappresentano posti validi a cui un utente può essere reindirizzato dopo aver completato l'accesso Oauth Per aggiungere un nuovo URI di reindirizzamento dell'app, andare sulla scheda Autenticazione della propria applicazione su https://developers.arcgis.com. Una volta nella scheda, registrare la propria app qualora non sia stato già fatto, e aggiungere il proprio URI di indirizzamento o aggiungere urn:ietf:wg:oauth:2.0:oob per utilizzare una pagina di reindirizzamento di host su ArcGIS Online. L'URI urn:ietf:wg:oauth:2.0:oob è inoltre automaticamente impostata per ogni app creata e registrata in ArcGIS AppStudio.

È richiesta una stringa di licenza per costruire app che utilizzano ArcGIS Runtime versione 100.x. Un'app non può essere costruita senza una stringa di licenza, che indica inoltre quali funzioni della piattaforma ArcGIS l'app è autorizzata a eseguire. Per informazioni su come ottenere una stringa di licenza, consultare Assegnare una licenza all'app.

Firmare l'app iOS

Tutte le app iOS devono essere firmate. Le app create a scopo di test devono essere firmate da un certificato dello sviluppatore, che dovrà essere associato all'account dello sviluppatore Apple e al dispositivo su cui viene eseguito il test. Un certificato di produzione è associato solo all'account sviluppatore Apple specifico.

Prima di eseguire lo strumento Crea situato nel pannello laterale della galleria di AppStudio, nel cloud o a livello locale, assicurarsi di aver impostato le seguenti informazioni nella scheda iOS di Impostazioni, nell’intestazione Piattaforme:

• ID bundle: utilizzare sempre un nome di dominio internet inverso, ad esempio com.nomeazienda.nomeapplicazione. Il nome del pacchetto è un identificativo univoco per l'app e rappresenta il nome predefinito per il processo dell'applicazione. Una volta pubblicata l'app, non sarà più possibile modificare il nome del pacchetto. Per ulteriori informazioni, si veda la spiegazione dell'ID bundle in Preparare la distribuzione dell'app.
• Profilo provisioning: indica i dispositivi in cui si prevede di eseguire l'app.
• Certificato (file .p12): certificato per la distribuzione interna o su App Store. Questo file viene creato nella utility Accesso Portachiavi. Se non vengono fornite entrambe le informazioni e l'ID bundle in AppStudio, il file di installazione non verrà generato. Per ulteriori informazioni, consultare Che cos'è la firma dell'app?

Quando si esegue lo strumento Compila, verrà richiesto di fornire la password del certificato.

Per creare il file certificato necessario per la firma, per ogni sviluppatore è necessario eseguire la seguente procedura con un computer Mac:

1. Scaricare il certificato sviluppatore (ad esempio, ios_developer.cer) da iOS Dev Center.
2. Scaricare il profilo di provisioning mobile (ad esempio, ios_developer.mobileprovision) da iOS Dev Center.
3. Usare il Finder per passare a Applicazioni > Utility > Accesso Portachiavi.
4. Importare il certificato nella utility Accesso Portachiavi.
5. In Accesso Portachiavi, nell'elenco Portachiavi scegliere login e nell'elenco Categoria scegliere I miei certificati. Scegliere il certificato denominato phone Developer: nome, quindi esportare il certificato con chiave privata e password (ad esempio, john_doe_private_key.p12).

   In questo modo verrà creato il file di certificato.

6. In AppStudio, andare su Impostazioni > Piattaforme > iOS.
7. Impostare il percorso del profilo di provisioning.
8. Impostare il tipo di distribuzione per l'app. Per maggiori informazioni sulle opzioni, consultare la documentazione Xcode sui metodi di distribuzione.

Nota:

Fare doppio clic sul file del certificato .p12 e sul profilo di provisioning mobile per importare i file.

Se si sta utilizzando AppStudio su macOS, è necessario impostare due proprietà aggiuntive per creare app iOS con Make in locale. I contenuti di questi campi possono essere trovati nel certificato di sviluppo o distribuzione, visibile utilizzando il Finder per passare a Applicazioni > Utility > Accesso Portachiavi.

Fornire l'unità organizzativa del certificato nel campo ID Team.

Fornire il nome comune del certificato nel campo Identità firma codice.

Firmare l'app Android

Per preparare la creazione di una versione per Android, è innanzitutto necessario generare un file di archivio delle chiavi di firma. Per informazioni dettagliate sulla procedura necessaria per creare questo file, consultare la documentazione di Android.

Prima di eseguire lo strumento Crea, nel cloud o a livello locale, assicurarsi di aver impostato le seguenti informazioni nella scheda Android di Impostazioni, nell'intestazione Piattaforme:

• Nome pacchetto: utilizzare sempre un nome di dominio internet inverso, ad esempio com.nomeazienda.nomeapplicazione. Il nome del pacchetto è un identificativo univoco per l'app e rappresenta il nome predefinito per il processo dell'applicazione. Una volta pubblicata l'app, non sarà più possibile modificare il nome del pacchetto. Per ulteriori informazioni, fare riferimento alla descrizione del nome del pacchetto nell'elemento manifesto dell'SDK per Android.
• Percorso del file di archivio delle chiavi: posizione del file di archivio delle chiavi sul dispositivo desktop in uso.
• Alias principale: nome della chiave creata durante la creazione dell'archivio chiavi.

Se queste informazioni non vengono fornite, verranno creati file di installazione senza firma. I file non firmati possono essere installati a scopo di test, ma non possono essere inviati allo store di Google Play o ad Amazon Appstore.

Quando si esegue lo strumento Compila, verrà richiesto di fornire le password dell'archivio chiavi e della chiave.

Per creare un archivio chiavi, per ogni sviluppatore è necessario eseguire la seguente procedura:

1. Scaricare ed installare Java Development Kit da http://www.oracle.com/technetwork/java/javase/downloads/index.html.
2. Creare una variabile di ambiente denominata JAVA_HOME sul computer desktop in uso: http://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/index.html.
3. Aggiungere il percorso della cartella bin di JDK alla variabile di ambiente PATH.
4. In una finestra di comando usare il seguente comando per creare la chiave: keytool -genkey -v -keystore [nome_archivio_chiavi].keystore -alias [nome_alias] -keyalg RSA -keysize 2048 -validity 10000, dove nome_archivio_chiavi rappresenta il nome scelto per il file dell'archivio chiavi risultante e alias_name rappresenta il nome scelto come alias.
5. Immettere la password dell'archivio chiavi, quindi confermare.
6. Immettere le informazioni aggiuntive, quindi confermare.
7. Immettere una password per la chiave. Questa password può essere univoca. In alternativa, premere Enter per utilizzare la stessa password dell'archivio chiavi.

   Il file dell'archivio chiavi verrà creato nella cartella in cui viene eseguito questo comando.

Firmare l'app macOS

Analogamente ad Android, se non viene fornito un certificato quando si richiedono i file di installazione macOS, questi verranno ancora creati ma saranno senza firma. I file non firmati possono essere installati a scopo di test, ma non possono essere inviati al Mac Store. I seguenti passaggi sono simili a iOS; tuttavia, un profilo di provisioning non è richiesto per macOS. Per ulteriori informazioni, consultare Che cos'è la firma dell'app?

Prima di eseguire lo strumento Crea, nel cloud o a livello locale, assicurarsi di aver impostato le seguenti informazioni nella scheda macOS di Impostazioni nell’intestazione Piattaforme:

• ID bundle: utilizzare sempre un nome di dominio internet inverso, ad esempio com.nomeazienda.nomeapplicazione. Il nome del pacchetto è un identificativo univoco per l'app e rappresenta il nome predefinito per il processo dell'applicazione. Una volta pubblicata l'app, non sarà più possibile modificare il nome del pacchetto. Per ulteriori informazioni, si veda la spiegazione dell'ID bundle in Preparare la distribuzione dell'app.
• Certificato (file .p12): certificato per la distribuzione interna o su App Store. Questo file viene creato nella utility Accesso Portachiavi. Se non vengono fornite entrambe le informazioni e l'ID bundle in AppStudio, il file di installazione non verrà generato. Per ulteriori informazioni, consultare Che cos'è la firma dell'app?

Quando si esegue lo strumento Compila, verrà richiesto di fornire la password del certificato.

Per creare il file certificato necessario per firmare un'app macOS, seguire gli stessi passaggi descritti in precedenza per le app iOS.

Firmare l'app Windows

Analogamente ad Android, se non viene fornito un certificato quando si richiedono i file di installazione Windows, questi verranno ancora creati ma saranno senza firma.

Prima di eseguire lo strumento Crea, nel cloud o a livello locale, assicurarsi di aver fornito un file certificato nella scheda Windows di Impostazioni nell’intestazione Piattaforme: Questo certificato (file .p12 o .pfx) è per la distribuzione interna o su Windows Store. Per ulteriori informazioni, consultare Creare un certificato per la firma del pacchetto nella documentazione per sviluppatori di Microsoft.