Show Menu
SUJETS×

Developer quick start

Voici quelques informations sur la mise en oeuvre de la bibliothèque de plateformes Windows universelles.
Pour mettre en oeuvre le SDK, vous devez disposer de Visual Studio 2013 ou version ultérieure.

Obtention du kit SDK

After you unzip the SDK download file, you will have a separate folder for each supported architecture and platform combination. Vous aurez également un ADBMobileConfig.json fichier. Pour plus d’informations sur ce fichier, voir Fichier de configuration ADBMobileConfig.json.

Select the correct version

Different .dll/.winmd files are provided for each supported architecture (x86, x64, ARM).
The version of ADBMobile.winmd does not reflect the version of the library. Le .winmd fichier contient uniquement des métadonnées et possède un numéro de version de 255.255.255.255 , qui est accepté par Microsoft. Pour plus d'informations, consultez Comment ajouter des informations d'assemblage pour une dll de composant WinRT C++ / CX ? . To check the version of the library you are using, check the version of the underlying ADBMobile.dll file.

Différences de syntaxe

La bibliothèque Plateforme Windows universelle peut être utilisée dans plusieurs langages de programmation. Les exemples de ce guide sont dans WinJS (JavaScript). Si vous utilisez un autre langage, il se peut que vous deviez le modifier. Lorsque vous utilisez des méthodes winmd de winJS, toutes les méthodes ont automatiquement leur première lettre lue.
La principale différence entre les mises en œuvre réside dans la structure des données utilisée pour les données contextuelles. Additionally, when using the SDK in a WinJS project, use an empty string ( "" or '' ) instead of null for empty string values.

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

  1. Lancez Visual Studio, puis ouvrez la solution.
  2. In the Solution Explorer , right-click References and select Add Reference .
  3. Select the correct version of the library and browse to the associated ADBMobile.winmd file.
    Pour plus d’informations, voir Sélection de la section Version correcte sur cette page.
  4. Cliquez sur Ajouter .
  5. Verify that the ADBMobile.winmd file is checked in the Reference Manager window and click OK .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Si votre solution contient également un projet C++, ignorez cette étape.
  7. Dans l’onglet Windows de 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. Right-click your project and click Add > Existing Item .
  10. Browse to the ADBMobileConfig.json file and click Add .
  11. Cliquez avec le bouton droit sur le ADBMobileConfig.json fichier dans votre solution et sélectionnez Propriétés .
  12. Définissez Action de génération sur Contenu .

Add the library and config file to your project - C++

  1. Lancez Visual Studio, puis ouvrez la solution.
  2. In the Solution Explorer , right-click your project and select Add > References .
  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 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. Right-click your project and select Add > Existing Item .
  8. Browse to ADBMobileConfig.json file and click Add .
  9. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  10. On the General tab, change Content to Yes and click OK .

Add the library and config file to your project - WinJS

  1. Lancez Visual Studio, puis ouvrez la solution.
  2. In the Solution Explorer , right-click References and select Add Reference .
  3. Sélectionnez la version correcte de la bibliothèque et accédez au fichier ADBMobile.winmd associé.
  4. Cliquez sur Ajouter .
  5. Verify that the ADBMobile.winmd file is checked in the Reference Manager window and click OK .
  6. In the Solution Explorer , right-click References and select Add Reference .
    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. Right-click your project and select Add > Existing Item .
  9. Browse to the ADBMobileConfig.json file and click Add .
  10. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  11. Les propriétés du fichier étant sélectionnées, assurez-vous que l’action du package est définie sur Contenu .
    Pour les projets JavaScript, le fichier est défini sur Contenu par défaut.

Update The ADBMobileConfig.json config file

The ADBMobileConfig.json file contains global SDK settings and is located at your project root after you complete the steps in the Add the library and config file to your project section. If your ADBMobileConfig.json file was not pre-configured by Adobe Mobile Services, you need to update a few values to get started.
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: and rsids``server
  • Adobe Target : clientCode
  • Adobe Audience Manager : server
Pour plus d’informations, voir Méthodes de SDK.

Débogage

To enable debugging for the SDK, call 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. Right-click the project, click Properties > Debug tab .
  2. Définissez le menu déroulant du type de débogueur sur Natif uniquement .

JavaScript

  1. Right-click the project, click Properties > Configuration Properties > Debug tab .
  2. Définissez le menu déroulant du type de débogueur sur Natif uniquement .
Vous avez terminé ! Vous êtes maintenant prêt à mettre en œuvre Analytics, Target et la gestion de l’audience dans votre application Plateforme Windows universelle.