Show Menu
TÓPICOS×

Developer quick start

Será necessário o Visual Studio 2013 ou posteriores para implementar o SDK.

Obter o SDK

Após descompactar o download do SDK , você terá uma pasta separada para cada combinação de arquitetura e plataforma compatível. Você também terá um arquivo ADBMobileConfig.json que será explicado mais tarde neste guia.

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). Os arquivos são separados em uma estrutura de pastas de acordo com o seguinte:
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

É possível usar a biblioteca da loja de aplicativos universal do Windows 8.1 em várias linguagens de programação. Os exemplos neste guia estão em WinJS (JavaScript) e pode ser necessário modificá-los se você estiver usando uma linguagem diferente. Observe que ao consumir métodos winmd do winJS (JavaScript), todos os métodos passam a ter a primeira letra em minúsculas automaticamente.
A diferença principal entre as implementações é a estrutura de dados usada para dados 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 o Visual Studio e abra sua solução.
  2. In the Solution Explorer , right-click References and select #.
  3. Select the correct version of the library and browse to the associated ADBMobile.winmd file.
    For more information, see the Select the correct version section below.**
  4. Clique em Adicionar .
  5. Verify that ADBMobile.winmd is selected in the Reference Manager window and click OK .
    Ao adicionar uma referência a um aplicativo do Windows Phone, para selecionar ADBMobile.winmd , altere o filtro de arquivo padrão de Arquivos de componentes para Todos os arquivos .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Ignore esta etapa se você também tiver um projeto C++ em sua solução.
  7. Na guia Windows à esquerda, selecione Extensões e, em seguida, selecione e adicione Microsoft Visual C++ 2013 Runtime Package for Windows .
  8. Adicione a seguinte linha à sua classe:
    using ADBMobile;
    
    
  9. Right-click you your project and select Add > Existing Item .
  10. Navegue até o seu ADBMobileConfig.json arquivo e clique em Adicionar .
  11. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  12. Altere Ação de montagem para Conteúdo .

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

  1. Inicie o Visual Studio e abra sua solução.
  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 obter mais informações, consulte a seção Selecionar a versão correta abaixo.
  4. Clique em Adicionar .
  5. Na janela Gerenciador de referência, verifique se ADBMobile.winmd está selecionado e clique em OK .
    Ao adicionar uma referência a um aplicativo do Windows Phone, para selecionar ADBMobile.winmd , altere o filtro de arquivo padrão de Arquivos de componentes para Todos os arquivos .
  6. Adicione a seguinte linha à sua classe:
    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 o Visual Studio e abra sua solução.
  2. In the Solution Explorer , right-click References and select [Add Reference .
    Para obter mais informações, consulte a seção Selecionar a versão correta abaixo.
  3. Select the correct version of the library and then browse to the associated ADBMobile.winmd file.
  4. Clique em Adicionar .
  5. Verifique se ADBMobile.winmd está selecionada na janela Reference Manager (Gerenciador de referência e clique em OK .
    Ao adicionar uma referência a um aplicativo do Windows Phone, para selecionar ADBMobile.winmd , altere o filtro de arquivo padrão de Arquivos de componentes para Todos os arquivos .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Ignore esta etapa se você também tiver um projeto C++ em sua solução.
  7. In the Windows tab on the left, select Extensions and select and add Microsoft Visual C++ 2013 Runtime Package for 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. With File Properties selected, ensure Package Action is set to Content.
    Para projetos JavaScript, o arquivo é definido como Conteúdo por padrão.

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.
A seguir, um exemplo de um arquivo 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" 
 } 
}

No mínimo, atualize os seguintes valores para as soluções que estiver usando:
  • Analytics: and rsids``server
  • Target : clientCode
  • Gerenciamento de público-alvo : server
For more details, see ADBMobileConfig.json config .

Depuração

Quando quiser habilitar a depuração no SDK, você deve chamar ADBMobile.Config.setDebugLogging(true); .
Para aplicativos C Sharp e JS, é necessário ativar a depuração de código nativa completando as seguintes etapas (a depuração de código nativa é a configuração padrão para aplicativos C++):

C Sharp

Right-click the project, select Properties > Debug tab . In the debugger drop-down, select Native Only.

JS

Right-click the project, select Properties > Configuration Properties > Debug tab . Altere o menu suspenso do tipo de depurador para Apenas nativo .
Pronto! Agora você está pronto para implementar o Analytics, o Target e o Gerenciamento de público-alvo no seu aplicativo da loja de aplicativos universal do Windows 8.1.