Show Menu
TEMAS×

Developer quick start

Necesitará Visual Studio 2013 o posterior para implementar el SDK.

Obtención del SDK

Después de descomprimir la descarga del SDK , tendrá una carpeta independiente para cada combinación compatible de arquitectura y plataforma. También tendrá un archivo ADBMobileConfig.json que se explica más adelante en esta guía.

Select the correct version

Different .dll / .winmd files are provided for each target platform (Windows 8.1, Windows Phone 8.1), and supported architecture (x86, x64, ARM). Estos archivos se organizan en una estructura de carpetas del siguiente modo:
The version of ADBMobile.winmd does not reflect the version of the library. The .winmd file contains metadata only, and as such will have a version number of 255.255.255.255 which is accepted behavior according to Microsoft (see How do I add assembly information for a WinRT C++ / CX component dll? ). To check the version of the library you are using, check the version of the underlying ADBMobile.dll file.

Syntax differences

La biblioteca Universal App Store para Windows 8.1 se puede utilizar en varios lenguajes de programación. Los ejemplos de esta guía corresponden a WinJS (JavaScript) y puede que deban modificarse si emplea un lenguaje distinto. Tenga en cuenta que, cuando consume métodos winmd desde winJS (JavaScript), la primera letra de todos los métodos se hace minúscula automáticamente.
La diferencia principal entre las implementaciones radica en la estructura de datos usada para los datos de contexto.
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 Sharp

  1. Inicie Visual Studio y abra la solución.
  2. En el Explorador de soluciones , haga clic con el botón derecho en Referencias y seleccione #.
  3. Select the correct version of the library and browse to the associated ADBMobile.winmd file.
    Para obtener más información, consulte la sección Seleccionar la versión correcta a continuación.
  4. Haga clic en Agregar .
  5. Verify that ADBMobile.winmd is selected in the Reference Manager window and click OK .
    Al agregar una referencia a una aplicación de Windows Phone, para seleccionarla ADBMobile.winmd , cambie el filtro de archivos predeterminado de Archivos de componentes a Todos los archivos .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Omita este paso si también tiene un proyecto de C++ en la solución.
  7. En la ficha Windows de la izquierda, seleccione Extensiones y, a continuación, seleccione y agregue Paquete de tiempo de ejecución de Microsoft Visual C++ 2013 para Windows .
  8. Agregue la siguiente línea a la clase:
    using ADBMobile;
    
    
  9. Right-click you your project and select Add > Existing Item .
  10. Vaya al ADBMobileConfig.json archivo y haga clic en Agregar .
  11. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  12. Cambie Acción de compilación a Contenido .

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

  1. Inicie Visual Studio y abra la solución.
  2. In the Solution Explorer , right-click your project and select Add > References .
  3. Select the correct version of the library and then add a reference to the associated ADBMobile.winmd file.
    Para obtener más información, consulte la sección Seleccionar la versión correcta a continuación.
  4. Haga clic en Agregar .
  5. En la ventana Administrador de referencias, verifique que ADBMobile.winmd esté seleccionado y haga clic en Aceptar .
    Al agregar una referencia a una aplicación de Windows Phone, para seleccionarla ADBMobile.winmd , cambie el filtro de archivos predeterminado de Archivos de componentes a Todos los archivos .
  6. Agregue la siguiente línea a la clase:
    using namespace ADMS::Measurement;
    
    
  7. Right-click you your project and select Add > Existing Item .
  8. Browse to the 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. Inicie Visual Studio y abra la solución.
  2. In the Solution Explorer , right-click References and select [Add Reference .
    Para obtener más información, consulte Seleccionar la sección Versión correcta más abajo.
  3. Select the correct version of the library and then browse to the associated ADBMobile.winmd file.
  4. Haga clic en Agregar .
  5. Verifique que ADBMobile.winmd esté marcado en la ventana Administrador de referencias y haga clic en Aceptar .
    Al agregar una referencia a una aplicación de Windows Phone, para seleccionarla ADBMobile.winmd , cambie el filtro de archivos predeterminado de Archivos de componentes a Todos los archivos .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Omita este paso si también tiene un proyecto de C++ en la solución.
  7. En la ficha Windows de la izquierda, seleccione Extensiones y seleccione y agregue Paquete de tiempo de ejecución de Microsoft Visual C++ 2013 para Windows .
  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. Una vez seleccionadas las propiedades del archivo, asegúrese de que la acción de paquete está establecida en Contenido .
    Para proyectos JavaScript, el archivo se establece en Contenido de forma predeterminada.

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.
Esto es un ejemplo de archivo 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" 
 } 
}

Como mínimo, actualice los siguientes valores en función de las soluciones que utilice:
  • Analytics : rsids y server
  • Target : clientCode
  • Gestión de público : server
For more details, see ADBMobileConfig.json config .

Depuración

Cuando quiera activar la depuración para el SDK, tendrá que realizar una llamada a ADBMobile.Config.setDebugLogging(true); .
Para las aplicaciones de C Sharp y JS, debe activar la depuración de código nativo completando los siguientes pasos (la depuración de código nativo es la configuración predeterminada para las aplicaciones de C++):

C

Right-click the project, select Properties > Debug tab . En la lista desplegable del depurador, seleccione Solo nativo .

JS

Right-click the project, select Properties > Configuration Properties > Debug tab . Cambie el menú desplegable de tipo de depurador a Solo nativo .
¡Ya está! Ya está preparado para implementar Analytics, Target y Gestión de público en su aplicación Universal App Store para Windows 8.1.