Démarrage rapide pour les développeurs

Voici quelques informations sur la mise en oeuvre de la bibliothèque de plateformes Windows universelles.

IMPORTANT

Pour mettre en oeuvre le SDK, vous devez disposer de Visual Studio 2013 ou version ultérieure.

Obtention du kit SDK

Après avoir décompressé le fichier SDK download, vous disposez d’un dossier distinct pour chaque combinaison d’architecture et de plate-forme prise en charge. Vous aurez également un fichier ADBMobileConfig.json. Pour plus d’informations sur ce fichier, voir Fichier de configuration ADBMobileConfig.json.

Sélectionnez la version appropriée.

Différents fichiers .dll/.winmd sont fournis pour chaque architecture prise en charge (x86, x64, ARM).

IMPORTANT

La version de ADBMobile.winmd ne reflète pas la version de la bibliothèque. Le fichier .winmd contient uniquement des métadonnées et a le numéro de version 255.255.255.255, qui est accepté par Microsoft. Pour plus d'informations, voir Comment ajouter des informations d'assemblage pour une dll de composant WinRT C++ / CX ?. Pour vérifier la version de la bibliothèque que vous utilisez, vérifiez la version du fichier ADBMobile.dll sous-jacent.

Différences de syntaxe

La bibliothèque de plateformes Windows universelles peut être utilisée dans plusieurs langages de programmation. Les exemples de ce guide se trouvent dans WinJS (JavaScript), si vous utilisez un autre langage, il peut être nécessaire de le modifier. Lorsque vous utilisez des méthodes winmd de winJS, toutes les méthodes ont automatiquement leur première lettre minuscule.

La principale différence entre les implémentations est la structure de données utilisée pour les données contextuelles. De plus, lorsque vous utilisez le SDK dans un projet WinJS, utilisez une chaîne vide ( "" ou '') au lieu de null pour les valeurs de chaîne vides.

Ajouter la bibliothèque et le fichier de configuration à votre projet - C#

  1. Lancez Visual Studio et ouvrez votre solution.

  2. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur Références et sélectionnez Référence de l'Ajoute.

  3. Sélectionnez la version correcte de la bibliothèque et accédez au fichier ADBMobile.winmd associé.

    Pour plus d’informations, voir la section Sélectionner la version correcte de cette page.

  4. Cliquez sur Ajouter.

  5. Vérifiez que le fichier ADBMobile.winmd est coché dans la fenêtre Gestionnaire de références et cliquez sur OK.

  6. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur Références et sélectionnez Référence de l'Ajoute.

    Si votre solution contient également un projet C++, ignorez cette étape.

  7. Dans l'onglet Windows sur la gauche, sélectionnez Extensions, sélectionnez et ajoutez Visual C++ 2015 Runtime for Universal Windows Platform Apps.

  8. Ajoutez la ligne suivante à votre classe :

    using ADBMobile;
    
  9. Cliquez avec le bouton droit sur votre projet et cliquez sur Ajouter > Elément existant.

  10. Accédez au fichier ADBMobileConfig.json et cliquez sur Ajouter.

  11. Cliquez avec le bouton droit sur le fichier ADBMobileConfig.json dans votre solution et sélectionnez Propriétés.

  12. Remplacez Build Action par Content.

Ajouter la bibliothèque et le fichier de configuration à votre projet - C++

  1. Lancez Visual Studio et ouvrez votre solution.

  2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur votre projet et sélectionnez Ajouter > Références.

  3. Sélectionnez la version correcte de la bibliothèque et ajoutez une référence au fichier ADBMobile.winmd associé.

    Pour plus d’informations, voir la section Sélectionner la version correcte de cette page.

  4. Cliquez sur Ajouter.

  5. Vérifiez que ADBMobile.winmd est coché dans la fenêtre Gestionnaire de références et cliquez sur OK.

  6. Ajoutez la ligne suivante à votre classe :

    using namespace ADBMobile;
    
  7. Cliquez avec le bouton droit sur votre projet et sélectionnez Ajouter > Elément existant.

  8. Accédez au fichier ADBMobileConfig.json et cliquez sur Ajouter.

  9. Cliquez avec le bouton droit sur le fichier ADBMobileConfig.json dans votre solution et sélectionnez Propriétés.

  10. Sous l'onglet Général, remplacez Contenu par Oui et cliquez sur OK.

Ajouter la bibliothèque et le fichier de configuration à votre projet - WinJS

  1. Lancez Visual Studio et ouvrez votre solution.

  2. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur Références et sélectionnez Référence de l'Ajoute.

  3. Sélectionnez la version correcte de la bibliothèque et accédez au fichier ADBMobile.winmd associé.

  4. Cliquez sur Ajouter.

  5. Vérifiez que le fichier ADBMobile.winmd est coché dans la fenêtre Gestionnaire de références et cliquez sur OK.

  6. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur Références et sélectionnez Référence de l'Ajoute.

    Si votre solution contient également un projet C++, ignorez cette étape.

  7. Dans l'onglet Windows sur la gauche, sélectionnez Extensions et sélectionnez et ajoutez Visual C++ 2015 Runtime pour les applications de plateformes Windows universelles.

  8. Cliquez avec le bouton droit sur votre projet et sélectionnez Ajouter > Elément existant.

  9. Accédez au fichier ADBMobileConfig.json et cliquez sur Ajouter.

  10. Cliquez avec le bouton droit sur le fichier ADBMobileConfig.json dans votre solution et sélectionnez Propriétés.

  11. Si Propriétés du fichier est sélectionné, vérifiez que Action du package est définie sur Contenu.

    Pour les projets JavaScript, le fichier est défini sur Contenu par défaut.

Mise à jour du fichier de configuration ADBMobileConfig.json

Le fichier ADBMobileConfig.json contient des paramètres SDK globaux et se trouve à la racine de votre projet après avoir suivi les étapes de la section Ajouter le fichier de bibliothèque et de configuration à votre projet. Si votre fichier ADBMobileConfig.json n'a pas été préconfiguré par Adobe Mobile Services, vous devez mettre à jour quelques valeurs pour commencer.

Voici un exemple de fichier ADBMobileConfig.json :

{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 300, 
        "privacyDefault" : "optedin", 
        "poi" : [ 
                    ["san francisco",37.757144,-122.44812,7000], 
                    ["santa cruz",36.972935,-122.01725,600] 
                ] 
    }, 
 "target" : { 
  "clientCode" : "myTargetClientCode", 
  "timeout" : 1 
 }, 
 "audienceManager" : { 
  "server" : "myServer.demdex.com" 
 } 
}

Mettez à jour au minimum les valeurs suivantes pour les solutions que vous utilisez :

  • Adobe Analytics : rsids et server

  • Adobe Target: clientCode

  • Adobe Audience Manager: server

Pour plus d’informations, voir Méthodes SDK.

Débogage

Pour activer le débogage pour le SDK, appelez ADBMobile.Config.setDebugLogging(true);.

Pour les applications C Sharp et JavaScript, vous devez activer le débogage du code natif en procédant comme suit (le débogage du code natif est le paramètre par défaut pour les applications C++) :

C Sharp

  1. Cliquez avec le bouton droit sur le projet, cliquez sur Propriétés > onglet Débogage.

  2. Remplacez la liste déroulante du type de débogueur par Native Only.

JavaScript

  1. Cliquez avec le bouton droit sur le projet, cliquez sur Propriétés > Propriétés de configuration > Onglet Débogage.

  2. Remplacez la liste déroulante du type de débogueur par Native Only.

Vous avez terminé. Vous êtes maintenant prêt à mettre en oeuvre Analytics, Cible et Audience Management dans votre application de plateforme Windows universelle.

Sur cette page