Show Menu
主题×

Developer quick start

您将需要 Visual Studio 2013 或更高版本来实施 SDK。

获取 SDK

在解压缩 下载的 SDK 之后,对于每种支持的架构和平台组合,您都会有一个对应的单独文件夹。您还将具有 ADBMobileConfig.json 文件,该文件在本指南的后面部分进行了介绍。

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). 这些文件按照以下条件划分到文件夹结构中:
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

Windows 8.1 通用应用商店库可用于多种编程语言。本指南中的示例采用的是 WinJS (JavaScript),如果您使用其他语言,则可能需要进行修改。请注意,在使用 winJS (JavaScript) 中的 winmd 方法时,所有方法均自动将其第一个字母小写。
不同实施之间的主要差别在于上下文数据所使用的数据结构。
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. 启动 Visual Studio 并打开您的解决方案。
  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.
    有关详细信息,请参 阅下面的选择正确版本
  4. Click Add .
  5. Verify that ADBMobile.winmd is selected in the Reference Manager window and click OK .
    在添加对Windows Phone应用程序的引用时,要进行选择, ADBMobile.winmd 请将默认文件过滤器从“组件文件” 更改为“ 所有文件” 。
  6. In the Solution Explorer , right-click References and select Add Reference .
    如果您的解决方案中还有C++项目,请跳过此步骤。
  7. 在左侧的 Windows 选项卡中,选择“扩展” ,然后选择并添加“ Microsoft Visual C++ 2013 Runtime Package for Windows ”。
  8. 将以下行添加到您的类中:
    using ADBMobile;
    
    
  9. Right-click you your project and select Add > Existing Item .
  10. 浏览到您的文 ADBMobileConfig.json 件,然后单击“ 添加”
  11. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  12. Change Build Action to Content .

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

  1. 启动 Visual Studio 并打开您的解决方案。
  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.
    有关详细信息,请参阅 下面的选择正确版本
  4. Click Add .
  5. 在“参 考管理器 ”(Reference Manager ADBMobile.winmd )窗口中,验证是否已选 中,然后单击“ ​确定”(OK)。
    在添加对Windows Phone应用程序的引用时,要进行选择, ADBMobile.winmd 请将默认文件过滤器从“组件文件” 更改为“ 所有文件” 。
  6. 将以下行添加到您的类中:
    using namespace ADMS::Measurement;
    
    
  7. Right-click you your project and select Add > Existing Item .
  8. 浏览至文件 ADBMobileConfig.json 并单击“添 加”
  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. 启动 Visual Studio 并打开您的解决方案。
  2. In the Solution Explorer , right-click References and select [Add Reference .
    有关详细信息,请参 阅下面的选择正确版本
  3. Select the correct version of the library and then browse to the associated ADBMobile.winmd file.
  4. Click Add .
  5. Verify that ADBMobile.winmd is checked in the Reference Manager window and click OK .
    在添加对Windows Phone应用程序的引用时,要进行选择, ADBMobile.winmd 请将默认文件过滤器从“组件文件” 更改为“ 所有文件” 。
  6. In the Solution Explorer , right-click References and select Add Reference .
    如果您的解决方案中还有C++项目,请跳过此步骤。
  7. 在左侧的 Windows 选项卡中,选择“扩展” ,然后选择并添加“ Microsoft Visual C++ 2013 Runtime Package for Windows ”。
  8. Right-click your project and select Add > Existing Item .
  9. Browse to the file and click Add. ADBMobileConfig.json
  10. Right-click the ADBMobileConfig.json] file in your solution and select Properties .
  11. 选择“ 文件属性 ”后,确保将“ 包操作 ”设置为“ 内容”
    对于JavaScript项目,默认情况下将文件设 置为 “内容”。

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.
以下是 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" 
 } 
}

至少应为您所使用的解决方案更新以下值:
  • 分析 : rsids server
  • Target : clientCode
  • 受众管理 : server
For more details, see ADBMobileConfig.json config .

调试

如果您要对 SDK 启用调试,则必须调用 ADBMobile.Config.setDebugLogging(true);
对于C Sharp和JS应用程序,您必须完成以下步骤以启用本机代码调试(本机代码调试是C++应用程序的默认设置):

C锐化

Right-click the project, select Properties > Debug tab . 在调试器下拉框中,选择“仅 本机 ”。

JS

Right-click the project, select Properties > Configuration Properties > Debug tab . 将调试器类型下拉菜单更改为​ 仅本机
就这么简单!您现在便可以在 Windows 8.1 通用应用商店应用程序中实施 Analytics、Target 和受众管理。