ArcGIS AppStudio include ArcGIS Runtime, immediatamente utilizzabile nell'app. Tuttavia, alle mappe nell'app viene applicata una filigrana e vengono visualizzati messaggi di debug che indicano che l'app è concessa in licenza solo per uso da parte degli sviluppatori.
Per distribuire un'app, è necessario utilizzare uno dei livelli di licenza di ArcGIS Runtime. Durante la distribuzione della tecnologia ArcGIS Runtime, sono previsti costi solo a livello di licenza Basic e superiore. Anche l'utilizzo dei servizi di ArcGIS Online può prevedere costi specifici. Per ulteriori dettagli, consultare Licenze sulla pagina delle FAQ sviluppatori e confrontare i piani sulla pagina Creare soluzioni ArcGIS. Per una panoramica del modello corrente di licenza per ArcGIS Runtime, consultare la pagina di ArcGIS Developers per la Licenza o guardare questo video.
È necessaria una licenza per distribuire l'app anche si sta utilizzando una chiave API. Le chiavi API offrono accesso a contenuti e servizi, mentre una licenza abilita le funzionalità SDK e rimuove la filigrana sviluppatore. Per ulteriori dettagli, consultare Funzionalità di licenza.
Assegnare una licenza all'app inserendo la chiave di licenza in Impostazioni di AppStudio. Dopo aver eseguito questa operazione, la filigrana e i messaggi di debug non saranno più visualizzati e l'app sarà pronta per la distribuzione.
Nella tabella seguente sono indicate le funzionalità abilitate per ogni livello di licenza.
Livello di licenza | Funzionalità disponibile |
---|---|
Sviluppatore (solo per sviluppo e test) | Tutte le funzionalità (verranno generati filigrane e messaggi di debug) |
Lite |
|
Base |
|
Standard |
|
Avanzato |
|
Nota:
I server avanzato e locale di ArcGIS Runtime non sono supportati in AppStudio.
AppStudio Player 3.0 e versioni successive applica il livello di licenza dell'app in esecuzione al suo interno. Se non è stata fornita alcuna chiave di licenza, l'app viene eseguita in modalità sviluppatore.
Assegnare una licenza di livello Lite all'app
Per assegnare una licenza di livello Lite all'app, occorre una chiave di licenza gratuita che ArcGIS AppStudio è in grado di generare automaticamente. Passare a Impostazioni > Licenze per l’app e fare clic sul pulsante Imposta licenza Lite. Accedere ad ArcGIS Online se non è già stato fatto. Il campo Chiave di licenza verrà compilato automaticamente. Quindi, fare clic sul pulsante Applica in Impostazioni per salvare le modifiche.
È inoltre possibile assegnare una licenza di livello Lite all'app, accedendo all'app con un named user di ArcGIS del tipo utente Viewer.
Nota:
ArcGIS Runtime 100.1 o app successive all'interno di AppStudio Player vengono eseguite in modalità sviluppatore e includono la filigrana Ad uso esclusivo dello sviluppatore. La filigrana scompare quando si fornisce una licenza ArcGIS Runtime nelle impostazioni dell’app.
Assegnare all'app una licenza di livello Basic o superiore
È possibile assegnare all'app una licenza di livello Basic o superiore utilizzando un account di tipo named user di ArcGIS. Il livello della licenza dipende dal tipo di utente che ha effettuato l'accesso:
- Editor e Field Worker hanno una licenza di livello Basic.
- Creator e GIS Professional - Basic hanno una licenza di livello Standard.
- GIS Professional - Standard e GIS Professional - Advanced hanno una licenza di livello Advanced.
L'uso di un account di tipo named user implica l'aggiunta di codice per abilitare l'accesso utilizzando un account aziendale ArcGIS.
Nota:
Prima di inizializzare uno dei due processi, caricare l'app di AppStudio in ArcGIS Online. A tale scopo, accedere ad AppStudio, e fare clic sull'app cui si desidera assegnare la licenza, quindi cliccare sul pulsante di upload e infine su Aggiungi (oppure su Aggiorna). Leggere inoltre il contratto di licenza riportato nei file PDF EULA allegati ad AppStudio. Questi file si trovano in ArcGIS/AppStudio/Licenses nella cartella delle applicazioni dell’utente.
- Individuare una posizione nel codice in esecuzione prima di utilizzare qualsiasi funzionalità di ArcGIS Runtime.
- Consentire all'utente dell'app di eseguire l'autenticazione con un account dell'organizzazione ArcGIS. Dopo che il portale è stato caricato, impostare la licenza sul portale.
var portal = ArcGISRuntimeEnvironment.createObject("Portal", {url: url}); var credential = ArcGISRuntimeEnvironment.createObject("Credential"); credential.username = username; credential.password = pwd; portal.credential = credential; portal.fetchLicenseInfoStatusChanged.connect(function(){ if (portal.fetchLicenseInfoStatus === Enums.TaskStatusCompleted) { signedIn = true; var licenseInfo = portal.fetchLicenseInfoResult; licInfo.json = licenseInfo.json; var result = ArcGISRuntimeEnvironment.setLicense(licenseInfo); setLicenseData(result); } }); portal.fetchLicenseInfo();
- Salvare il file JSON contenente le informazioni sulla licenza per l'uso futuro.
Button { id: savePortalInfo text: "Save Portal Info" onClicked: { System.settings.setValue("ArcGIS/Runtime/License/LicenseInfoJson", licInfo.json); } }
- Se le informazioni di licenza sono state salvate nell'archivio locale, l'app può essere avviata e concessa in licenza in un ambiente offline utilizzando le informazioni sulla licenza salvate. Questo è importante se l'app viene utilizzata in un ambiente offline per un massimo di 30 giorni.
Button { id: loadFromLicenseInfoButton text: "Load from LicenseInfo" onClicked: { licInfo.json = System.settings.value("ArcGIS/Runtime/License/LicenseInfoJson"); var licenseInfo = ArcGISRuntimeEnvironment.createObject("LicenseInfo"); licenseInfo.json = licInfo.json; var result = ArcGISRuntimeEnvironment.setLicense(licenseInfo); setLicenseData(result); // Sets UI elements based on result }
Il livello di licenza assegnato all'app è il Basic, che offre la possibilità di rimanere offline per un massimo di 30 giorni, e l'app è pronta per essere creata in AppStudio.
Utilizzare una chiave di licenza per l'app
È necessario utilizzare una chiave di licenza per l’app di livello Standard o Advanced. Per ottenere una chiave di licenza, contattare Esri. Negli Stati Uniti, chiamare il Servizio Clienti Esri al numero 1-888-377-4575.
Dopo aver ricevuto la chiave di licenza, è possibile associarla all'app tramite AppStudio. Passare a Impostazioni > Licenze e copiare la chiave di licenza nel campo Chiave di licenza. Quindi, fare clic sul pulsante Applica per salvare le modifiche.
Attribuire il credito Esri nell'app
È necessario eseguire l'attribuzione a Esri nell'app seguendo le linee guida per ArcGIS Maps SDK. Le proprietà disponibili sono riportate di seguito: