Octroyer une licence à votre application

ArcGIS AppStudio inclut ArcGIS Runtime, que vous pouvez utiliser immédiatement dans votre application. Toutefois, les cartes dans votre application seront filigranées et des messages de débogage indiquant que la licence de votre application est destinée aux développeurs uniquement apparaîtront.

Pour déployer une application, vous devez utiliser un des niveaux de licence ArcGIS Runtime. Lorsque vous déployez ArcGIS Runtime, des frais sont encourus au niveau Basic et au niveau supérieur. Des frais peuvent également être encourus en cas d’utilisation des services ArcGIS Online. Pour en savoir plus, reportez-vous à la rubrique Octroi de license sur la page de la FAQ des développeurs et comparer les plans sur la page Créer des solutions ArcGIS. Pour obtenir une vue d’ensemble du modèle de licence ArcGIS Runtime actuel, reportez-vous à la section Licence de la page ArcGIS Developers ou regardez cette vidéo.

Il est obligatoire d’avoir une license pour déployer votre application, même si vous utilisez une clé API. Les clés API donnent accès au contenu et aux services, tandis que la license active les fonctionnalités SDK et supprime le filigrane indiquant que l’application est destinée aux développeurs. Pour plus d’informations, reportez-vous à la rubrique Octroi de license et fonctionnalités.

Octroyez une licence à votre application en saisissant une clé de licence dans les paramètres AppStudio. Une fois cette étape effectuée, le filigrane et les messages de débogage n’apparaissent plus et votre application est prête à être déployée.

La table suivante indique les fonctionnalités propres à chaque niveau de licence :

Niveau de licenceFonctionnalités disponibles

Développeur (développement et test uniquement)

Toutes les fonctionnalités (des filigranes et messages de débogage seront générés)

Lite

  • Afficher des cartes, des scènes, des couches et des paquetages depuis ArcGIS
  • Mettre à jour des entités dans des services d’entités publics
  • Générer une géodatabase mobile à partir d’un service d’entités dans lequel la synchronisation est activée
  • Télécharger des mises à jour à partir d’un service d’entités pour lequel la synchronisation est activée dans une géodatabase mobile
  • Itinéraire
  • Recherche de lieux
  • Calculer des zones de desserte et rechercher les ressources les plus proches à l’aide d’un service réseau

Basic

  • Toutes les fonctionnalités de Lite
  • Mise à jour d’entités dans des géodatabases mobiles et des services d’entités en ligne
  • Ajouter, mettre à jour ou supprimer du contenu sur les portails
  • Synchroniser les mises à jour apportées à la géométrie des entités, aux attributs et aux pièces jointes à partir d’une géodatabase mobile dans un service d’entités

Standard

  • Toutes les fonctionnalités de Basic
  • Accès à des données supplémentaires
    • Fichier de formes
    • Paquetages géographiques
    • Couches ENC (S-57)
    • Couches raster locales
    • Utiliser les fonctions raster
    • Sources d’altitude raster locales
  • Analyse visuelle
    • Ligne de visée
    • Champ de vision
  • Serveur local ArcGIS Runtime
    • Services de carte
    • Services d’entités
      • Mise à jour des géodatabases fichier
    • Services de géotraitement
      • Prend en charge un sous-ensemble d’outils ArcGIS Desktop de base pouvant être intégrés dans un paquetage de géotraitement

Advanced

  • Toutes les fonctionnalités de Standard
  • Serveur local ArcGIS Runtime
    • Services d’entités
      • Mettre à jour des géodatabases d’entreprise
    • Services de géotraitement
      • Prend en charge un sous-ensemble d’outils ArcGIS Desktop de base et avancés pouvant être intégrés dans un paquetage de géotraitement

Remarque :

Les serveurs local et avancé ArcGIS Runtime ne sont pas pris en charge dans AppStudio.

AppStudio Player 3.0 et version ultérieure applique le niveau de licence de l’application qui s’exécute en son sein. Si aucune clé de licence n’a été fournie, l’application s’exécute en mode de développement.

Octroyer une licence à votre application de niveau Lite

Pour octroyer une licence à votre application de niveau Lite, vous avez uniquement besoin d’une clé de licence gratuite que ArcGIS AppStudio est capable de générer automatiquement. Accédez à Settings (Paramètres) > Licensing (Licences) pour votre application, puis cliquez sur le bouton Set Lite license (Définir la licence Lite). Connectez-vous à ArcGIS Online si ce n’est pas déjà fait. Le champ License key (Clé de licence) est automatiquement renseigné. Cliquez ensuite sur le bouton Apply (Appliquer) dans Settings (Paramètres) pour enregistrer les modifications.

Vous pouvez également octroyer à votre application une licence de niveau Lite en vous connectant à l’application avec un compte d’utilisateur nommé ArcGIS de type Viewer.

Remarque :

Les applications ArcGIS Runtime 100.1 ou ultérieures dans AppStudio Player sont exécutées en mode de développement et incluent un filigrane For Developer Use Only (Licence destinée uniquement aux développeurs). Ce filigrane disparaît lorsque vous fournissez une licence ArcGIS Runtime dans les paramètres de l’application.

Octroyer une licence à votre application de niveau Basic ou de niveau supérieur

Vous pouvez octroyer une licence à votre application de niveau Basic ou supérieur via un compte utilisateur ArcGIS nommé. Le niveau de licence dépend du type d’utilisateur connecté :

  • Licence Editor et Field Worker au niveau Basic
  • Creator et GIS Professional : licence Basic au niveau Standard
  • GIS Professional - Standard et GIS Professional : licence Advanced au niveau Advanced.

Le recours à un compte utilisateur nommé implique l’ajout d’un code pour activer la connexion à l’aide d’un compte d’organisation ArcGIS.

Remarque :

Avant d’initier l’un de ces processus, chargez votre application AppStudio dans ArcGIS Online. Pour ce faire, connectez-vous à AppStudio, cliquez sur l’application à laquelle vous voulez octroyer une licence, cliquez sur le bouton de chargement, puis sur Add (Ajouter) (ou Update (Mettre à jour)). Lisez en outre le contrat de licence du fichier PDF EULA inclus dans AppStudio. Ces fichiers se trouvent dans le répertoire ArcGIS/AppStudio/Licenses de votre dossier d’applications utilisateur.

  1. Recherchez un emplacement dans votre code qui s’exécute avant que des fonctionnalités ArcGIS Runtime ne soient utilisées.
  2. Autorisez l’utilisateur de l’application à s’authentifier avec un compte d’organisation ArcGIS. Une fois le portail chargé, définissez la licence sur le portail.
    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();
  3. Enregistrez le fichier JSON contenant les informations de licence pour l’utiliser ultérieurement.
    Button {
        id: savePortalInfo
        text: "Save Portal Info"
        onClicked: {
            System.settings.setValue("ArcGIS/Runtime/License/LicenseInfoJson", licInfo.json);
        }
    }
  4. Si vous avez enregistré les informations de licence sur un espace de stockage local, votre application peut être démarrée et concédée sous licence dans un environnement hors connexion à l’aide des informations de licence enregistrées. Ceci est important si votre application est utilisée dans un environnement hors connexion pendant 30 jours au maximum.
    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
    
    
        }

Votre application détient désormais une licence de niveau Basic, capable de demeurer hors connexion pendant 30 jours au maximum, et est prête à être générée dans AppStudio.

Utiliser une clé de licence pour octroyer une licence à votre application

Vous devez utiliser une clé de licence pour octroyer à votre application une licence de niveau Standard ou Advanced. Pour recevoir une clé de licence, contactez Esri. Si vous résidez aux États-Unis, appelez le service client Esri au 1-888-377-4575.

Une fois la clé de licence reçue, vous pouvez l’associer à votre application via AppStudio. Accédez à Settings (Paramètres) > Licensing (Licences), puis copiez la clé de licence dans le champ License key (Clé de licence). Cliquez ensuite sur le bouton Apply (Appliquer) pour enregistrer les modifications.

Attribuer Esri dans votre application

Vous êtes tenu d’attribuer Esri dans votre application conformément aux instructions d’ArcGIS Maps SDK. On compte les suivantes :