개발자 빠른 시작

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

중요

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

SDK 가져오기

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

올바른 버전 선택

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

중요

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

구문 차이

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

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

프로젝트에 라이브러리 및 구성 파일 추가 - C#

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

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

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

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

  4. 추가를 클릭합니다.

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

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

    솔루션에 C++ 프로젝트도 있는 경우 이 단계를 건너뛰십시오.

  7. 왼쪽의 Windows 탭에서 확장​을 선택하고 Visual C++ 2015 Runtime for Universal Windows 플랫폼 앱​을 선택하고 추가합니다.

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

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

  10. ADBMobileConfig.json 파일을 탐색하고 추가​를 클릭합니다.

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

  12. 빌드 작업​을 컨텐트​로 변경합니다.

프로젝트에 라이브러리 및 구성 파일 추가 - C++

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

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

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

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

  4. 추가를 클릭합니다.

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

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

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

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

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

  10. 일반 탭에서 컨텐트​를 ​로 변경하고 확인​을 클릭합니다.

프로젝트에 라이브러리 및 구성 파일 추가 - WinJS

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

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

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

  4. 추가를 클릭합니다.

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

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

    솔루션에 C++ 프로젝트도 있는 경우 이 단계를 건너뛰십시오.

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

  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

자세한 내용은 SDK 메서드를 참조하십시오.

디버깅

SDK에 대한 디버깅을 사용하려면 ADBMobile.Config.setDebugLogging(true);을(를) 호출합니다.

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

C 샤프

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

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

JavaScript

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

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

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

이 페이지에서는