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 de téléchargement du SDK, vous disposez d’un dossier distinct pour chaque combinaison d’architecture et de plate-forme prise en charge. Vous aurez également un ADBMobileConfig.json fichier. Pour plus d’informations sur ce fichier, voir le fichier de configurationADBMobileConfig.json.

Select the correct version

Différents .dll/.winmd fichiers 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 .winmd fichier contient uniquement des métadonnées et un numéro de version de 255.255.255.255, ce qui est accepté par Microsoft. Pour plus d'informations, consultez 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 ADBMobile.dll fichier 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, lors de l’utilisation du SDK dans un projet WinJS, utilisez une chaîne vide ( "" ou '') au lieu de null valeurs de chaîne vides.

Add the library and config File to your project - C#

  1. Lancez Visual Studio et ouvrez votre solution.

  2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références et sélectionnez Ajouter la référence.

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

    Pour plus d’informations, voir Sélection de la section de version correcte sur 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 sur Références et sélectionnez Ajouter la référence.

    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 pour les applications de plateformes Windows universelles.

  8. Ajoutez la ligne suivante à votre classe :

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

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

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

  12. Remplacez l’action ​Build par Contenu.

Add the library and config file to your project - 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 Sélection de la section de version correcte sur cette page.

  4. Cliquez sur Ajouter.

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

  6. Ajoutez la ligne suivante à votre classe :

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

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

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

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

Add the library and config file to your project - WinJS

  1. Lancez Visual Studio et ouvrez votre solution.

  2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références et sélectionnez Ajouter la référence.

  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 sur Références et sélectionnez Ajouter la référence.

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

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

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

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

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

  11. Lorsque les propriétés ​de fichier sont sélectionnées, vérifiez que l’action de 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 ADBMobileConfig.json fichier contient les paramètres du SDK global et se trouve à la racine du projet une fois que vous avez terminé les étapes de l’ Ajoute de la bibliothèque et du fichier de configuration à la section du projet . Si votre ADBMobileConfig.json fichier 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

For more information, see SDK methods.

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. La liste déroulante Type de débogueur devient natif uniquement.

JavaScript

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

  2. La liste déroulante Type de débogueur devient natif uniquement.

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