Show Menu
SUJETS×

Début rapide des développeurs

Vous aurez besoin de Visual Studio 2013 ou version ultérieure pour mettre en oeuvre le SDK.

Obtention du kit SDK

Après avoir décompressé le téléchargement du SDK, vous disposez d’un dossier distinct pour chaque combinaison d’architecture et de plate-forme prise en charge. Vous disposerez également d’un ADBMobileConfig.json fichier qui est expliqué plus loin dans ce guide.

Sélectionner la version correcte

Différents .dll / .winmd fichiers sont fournis pour chaque plate-forme de cible (Windows 8.1, Windows Phone 8.1) et l’architecture prise en charge (x86, x64, ARM). Les fichiers sont séparés dans une structure de dossiers selon les éléments suivants :
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, en tant que tel, aura un numéro de version du comportement accepté par Microsoft (voir 255.255.255.255 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 Windows 8.1 Universal App Store peut être utilisée dans plusieurs langages de programmation. Les exemples de ce guide se trouvent dans WinJS (JavaScript) et doivent peut-être être modifiés si vous utilisez un autre langage. Notez que lorsque vous utilisez des méthodes winmd de winJS (JavaScript), toutes les méthodes ont automatiquement leur première lettre avec un caractère 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.

ajouter la bibliothèque et le fichier de configuration à votre projet - C Sharp

  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 recherchez le ADBMobile.winmd fichier associé.
    Pour plus d’informations, voir la section Sélectionner la version correcte ci-dessous.
  4. Cliquez sur Ajouter .
  5. Vérifiez que ADBMobile.winmd est sélectionné dans la fenêtre Gestionnaire de références, puis cliquez sur OK .
    Lors de l’ajout d’une référence à une application Windows Phone, pour sélectionner ADBMobile.winmd , remplacez le filtre de fichiers par défaut par Fichiers ​composants par Tous les fichiers .
  6. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références et sélectionnez Ajouter la référence .
    Ignorez cette étape si votre solution contient également un projet C++.
  7. Dans l’onglet Windows sur la gauche, sélectionnez Extensions , puis sélectionnez et ajoutez le package d’exécution Microsoft Visual C++ 2013 pour Windows .
  8. ajoutez la ligne suivante à votre classe :
    using ADBMobile;
    
    
  9. Cliquez avec le bouton droit de la souris sur votre projet et sélectionnez Ajouter > Elément ​existant.
  10. Recherchez votre ADBMobileConfig.json fichier et cliquez sur Ajouter .
  11. Cliquez avec le bouton droit sur le ADBMobileConfig.json fichier dans 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, puis ajoutez une référence au ADBMobile.winmd fichier associé.
    Pour plus d’informations, voir la section Sélectionner la version appropriée ci-dessous.
  4. Cliquez sur Ajouter .
  5. Dans la fenêtre Gestionnaire de références, vérifiez que ADBMobile.winmd est sélectionné, puis cliquez sur OK .
    Lors de l’ajout d’une référence à une application Windows Phone, pour sélectionner ADBMobile.winmd , remplacez le filtre de fichiers par défaut par Fichiers ​composants par Tous les fichiers .
  6. ajoutez la ligne suivante à votre classe :
    using namespace ADMS::Measurement;
    
    
  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 , puis 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 .
    Pour plus d’informations, voir Sélection de la version appropriée ci-dessous.
  3. Sélectionnez la version correcte de la bibliothèque, puis recherchez le ADBMobile.winmd fichier associé.
  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 .
    Lors de l’ajout d’une référence à une application Windows Phone, pour sélectionner ADBMobile.winmd , remplacez le filtre de fichiers par défaut par Fichiers ​composants par Tous les fichiers .
  6. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références et sélectionnez Ajouter la référence .
    Ignorez cette étape si votre solution contient également un projet C++.
  7. Dans l’onglet Windows sur la gauche, sélectionnez Extensions , puis sélectionnez et ajoutez le package d’exécution Microsoft Visual C++ 2013 pour Windows .
  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 par défaut sur Contenu .

Mise à jour du fichier de configuration ADBMobileConfig.json

Le ADBMobileConfig.json fichier contient des paramètres SDK globaux et se trouve à la racine du projet une fois que vous avez terminé les étapes de la section Ajouter la bibliothèque et le fichier de configuration à votre projet . Si votre ADBMobileConfig.json fichier n’a pas été préconfiguré par Adobe Mobile Services, vous devez mettre à jour quelques valeurs pour commencer.
The following is an example of an ADBMobileConfig.json file:
{ 
    "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" 
 } 
}

Au minimum, mettez à jour les valeurs suivantes pour les solutions que vous utilisez :
  • Analytics : rsids et server
  • Target : clientCode
  • Gestion des Audiences : server
Pour plus d’informations, voir la configuration SDK methods ADBMobileConfig.json.

Débogage

Pour activer le débogage pour le SDK, vous devez appeler ADBMobile.Config.setDebugLogging(true); .
Pour les applications C Sharp et JS, 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

Cliquez avec le bouton droit sur le projet, sélectionnez Propriétés > onglet ​Débogage. Dans la liste déroulante Débogueur, sélectionnez natif uniquement .

JS

Cliquez avec le bouton droit sur le projet, sélectionnez Propriétés > Propriétés de configuration > Onglet ​Débogage. 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 Windows 8.1 Universal App Store.