개발자 빠른 시작

다음은 범용 Windows 플랫폼 라이브러리를 구현하는 방법에 대한 몇 가지 정보입니다.

중요

SDK를 구현하려면 Visual Studio 2013 이상이 필요합니다.

SDK 다운로드

SDK 다운로드 파일의 압축을 해제하면 지원되는 각 아키텍처 및 플랫폼 조합에 대해 별도의 폴더를 갖게 됩니다. 또한 ADBMobileConfig.json 파일이 있습니다. 이 파일에 대한 자세한 내용은 ADBMobileConfig.json 구성 파일을 참조하십시오.

올바른 버전 선택

지원되는 각 아키텍처(x86, x64, ARM)에 대해 서로 다른 .dll/.winmd 파일이 제공됩니다.

중요

버전 ADBMobile.winmd 은 라이브러리 버전을 반영하지 않습니다. 이 .winmd 파일에는 메타데이터만 들어 있으며 버전 번호가 255.255.255.255있으며 Microsoft에 따라 허용되는 비헤이비어가 있습니다. 자세한 내용은 WinRT C++/CX 구성 요소 dll에 대한 어셈블리 정보를 어떻게 추가합니까? 를 참조하십시오. 질문에 답합니다. 사용 중인 라이브러리 버전을 확인하려면 기본 ADBMobile.dll 파일의 버전을 확인하십시오.

구문 차이

유니버설 Windows 플랫폼 라이브러리는 여러 프로그래밍 언어에서 사용할 수 있습니다. 이 안내서의 예제는 WinJS(JavaScript)이며, 다른 언어를 사용하는 경우 수정해야 할 수 있습니다. winJS에서 winmd 메서드를 사용하는 경우 모든 메서드는 자동으로 첫 번째 문자를 소문자로 바꿉니다.

구현 간의 주요 차이점은 컨텍스트 데이터에 사용되는 데이터 구조입니다. 또한 WinJS 프로젝트에서 SDK를 사용할 때는 빈 문자열 값 대신 빈 문자열( "" 또는 '') null 을 사용하십시오.

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

  1. Visual Studio를 실행하고 솔루션을 엽니다.

  2. 솔루션 탐색기에서​참조를 마우스 오른쪽 으로 클릭하고 참조 추가​를선택합니다.

  3. 라이브러리의 올바른 버전을 선택하고 관련 ADBMobile.winmd 파일을 찾습니다.

    자세한 내용은 이 페이지에서 올바른 버전 선택 섹션을 참조하십시오.

  4. 추가를 클릭합니다.

  5. ADBMobile.winmd 파일이 참조 관리자 창에서 선택되었는지 확인하고 확인을 클릭합니다.

  6. 솔루션 탐색기에서​참조를 마우스 오른쪽 으로 클릭하고 참조 추가​를선택합니다.

    솔루션에 C++ 프로젝트도 있는 경우 이 단계를 건너뛸 수 있습니다.

  7. 왼쪽의 Windows 탭에서 확장을​선택하고 유니버설 Windows 플랫폼 앱용 Visual C++ 2015 런타임을 선택하여 추가합니다.

  8. 다음 줄을 클래스에 추가합니다.

    using ADBMobile;
    
  9. 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가 > 기존 항목을 클릭합니다.

  10. 파일을 ADBMobileConfig.json 찾아 추가를 클릭합니다.

  11. 솔루션에서 ADBMobileConfig.json 파일을 마우스 오른쪽 단추로 클릭하고 속성 을 선택합니다.

  12. 빌드 작업을 내용으로 변경합니다.

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

  1. Visual Studio를 실행하고 솔루션을 엽니다.

  2. 솔루션 탐색기에서​프로젝트를 마우스 오른쪽 단추로 클릭하고 추가 > 참조​를선택합니다.

  3. 라이브러리의 올바른 버전을 선택하고 관련 ADBMobile.winmd 파일에 참조를 추가합니다.

    자세한 내용은 이 페이지에서 올바른 버전 선택 섹션을 참조하십시오.

  4. 추가를 클릭합니다.

  5. 참조 관리자 창 ADBMobile.winmd 에서 체크 인되었는지 확인하고 확인클릭합니다.

  6. 다음 줄을 클래스에 추가합니다.

    using namespace ADBMobile;
    
  7. 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가 > 기존 항목을 선택합니다.

  8. 파일을 찾아 ADBMobileConfig.json 추가를 클릭합니다.

  9. 솔루션에서 ADBMobileConfig.json 파일을 마우스 오른쪽 단추로 클릭하고 속성 을 선택합니다.

  10. [ 일반 ] 탭에서 컨텐츠변경하고​확인을 클릭합니다.

Add the library and config file to your project - WinJS

  1. Visual Studio를 실행하고 솔루션을 엽니다.

  2. 솔루션 탐색기에서​참조를 마우스 오른쪽 으로 클릭하고 참조 추가​를선택합니다.

  3. 라이브러리의 올바른 버전을 선택하고 관련 ADBMobile.winmd 파일을 찾습니다.

  4. 추가를 클릭합니다.

  5. ADBMobile.winmd 파일이 참조 관리자 창에서 선택되었는지 확인하고 확인을 클릭합니다.

  6. 솔루션 탐색기에서​참조를 마우스 오른쪽 으로 클릭하고 참조 추가​를선택합니다.

    솔루션에 C++ 프로젝트도 있는 경우 이 단계를 건너뛸 수 있습니다.

  7. 왼쪽의 Windows 탭에서 확장을 선택하고 유니버설 Windows 플랫폼 앱용 Visual C++ 2015 Runtime을 선택하여 추가합니다.

  8. 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가 > 기존 항목을 선택합니다.

  9. 파일을 ADBMobileConfig.json 찾아 추가를 클릭합니다.

  10. 솔루션에서 ADBMobileConfig.json 파일을 마우스 오른쪽 단추로 클릭하고 속성 을 선택합니다.

  11. [ 파일 속성 ]을 선택한 상태에서 [ 패키지 작업 ]이 콘텐트​로 설정되어 있는지확인합니다.

    JavaScript 프로젝트의 경우 기본적으로 파일이 컨텐츠로 설정됩니다.

ADBMobileConfig.json 구성 파일 업데이트

ADBMobileConfig.json 파일은 전역 SDK 설정을 포함하며 프로젝트에 라이브러리 및 구성 파일 추가 섹션의 단계를 완료한 후 프로젝트 루트에 있습니다 . Adobe Mobile Services에서 파일을 미리 구성하지 않은 경우 시작하려면 몇 개의 값을 업데이트해야 합니다. ADBMobileConfig.json

다음은 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" 
 } 
}

최소한 사용 중인 솔루션에 대해 다음 값을 업데이트합니다.

  • Adobe Analytics: rsids and server

  • Adobe Target: clientCode

  • Adobe Audience Manager: server

For more information, see SDK methods.

디버깅

SDK에 대한 디버깅을 활성화하려면 전화 ADBMobile.Config.setDebugLogging(true);로 문의하십시오.

C Sharp 및 JavaScript 앱의 경우 다음 단계를 완료하여 기본 코드 디버깅을 활성화해야 합니다(기본 코드 디버깅은 C++ 앱에 대한 기본 설정).

C 샤프

  1. 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성 > 디버그 탭을 클릭합니다.

  2. 디버거 유형 드롭다운을 기본 전용으로 변경합니다.

JavaScript

  1. 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성 > 구성 속성 > 디버그 탭​클릭합니다.

  2. 디버거 유형 드롭다운을 기본 전용으로 변경합니다.

됐습니다. 이제 유니버설 Windows 플랫폼 앱에서 분석, Target 및 고객 관리를 구현할 준비가 되었습니다.

이 페이지에서는