설치 방법

이 페이지에서는 YouTube Android Player API의 샘플 애플리케이션을 실행하기 위해 Eclipse 또는 IntelliJ를 설정하는 방법을 설명합니다.

두 가지 안내 모두 API 사용과 연결된 개발자 키가 필요합니다. 개발자 키를 받으려면 애플리케이션을 등록한 다음 Google APIs Console에서 Android API 키를 받으면 됩니다.

중요: 애플리케이션을 등록할 때 프로젝트에 YouTube Data API v3 서비스가 추가되었는지 확인하세요. YouTube Android Player API는 YouTube 콘텐츠 검색 시 Data API를 사용합니다.

또한 샘플 애플리케이션 문서에서는 API 라이브러리와 함께 제공되는 애플리케이션을 간략하게 소개하고, Android 개발자 가이드에서는 연결된 Android 기기에서 앱을 디버그하는 방법을 설명합니다.

Eclipse

다음 단계에서는 API와 함께 배포된 샘플 프로젝트를 구축하고 실행하기 위한 Eclipse 환경을 설정하는 방법을 설명합니다. 여기에서는 Eclipse SDK 버전 3.8.0을 사용하는 단계를 안내합니다.

  1. Eclipse IDE용 ADT 플러그인을 설치합니다. 플러그인 버전 20 이상을 설치해야 합니다.

  2. 최신 버전의 YouTube Android Player API를 다운로드한 후 다운로드 파일의 압축을 풉니다.

  3. Eclipse에서 YouTube Android Player API 코드와 함께 배포된 샘플 애플리케이션에 대한 새 프로젝트를 만듭니다.

    1. File 메뉴에서 New를 선택하고 하위 메뉴에서 Project를 선택합니다.
    2. Select a wizard 창에서 Android -> Android Project from Existing Code를 선택합니다.
    3. 프로젝트를 가져오려면 다운로드한 YouTube Android Player API 파일의 압축을 풀었던 디렉토리로 이동하여 루트 디렉토리를 선택합니다.
    4. Eclipse에서 선택한 디렉토리를 검색하여 YouTubeAPIDemoActivity 프로젝트를 찾습니다. 해당 프로젝트를 선택한 후 Finish를 클릭하여 가져오기를 완료합니다.

    새 프로젝트를 만들 때 라이브러리가 빌드 경로에 포함되도록 클라이언트 라이브러리 YouTubeAndroidPlayerApi.jar 파일을 <project_root>/libs 디렉토리로 가져와야 합니다. 또한 .jar 파일을 직접 빌드 경로에 추가할 수도 있습니다.

  4. YouTubeAndroidAPIDemo 패키지(YouTubeAndroidAPIDemo/src/com/examples/youtubeapidemo/DeveloperKey.java)에 있는 DeveloperKey.java 파일을 열고 null을 다음 줄에 있는 유효한 YouTube 개발자 키로 교체합니다.

    public static final String DEVELOPER_KEY = null;

    개발자 키를 설정하지 않으면 샘플은 java.lang.NullPointerException을 표시하며 실행하려고 하면 닫힙니다.

  5. 연결된 Android 기기에서 샘플을 실행합니다. 에뮬레이터가 필요한 버전의 YouTube 앱을 실행할 수 없을 수 있으며 이로 인해 샘플이 실행되지 않을 수 있습니다.

    1. YouTube 앱 버전 4.2.16 이상을 실행 중인 Android 기기를 연결합니다.
    2. Run 메뉴에서 Run Configurations를 선택합니다.
    3. Target 창에서 연결된 Android 기기에서 샘플 애플리케이션을 실행하도록 설정했는지 확인합니다.
    4. Run을 클릭하여 연결된 기기에서 샘플을 실행합니다.

IntelliJ

다음 단계에서는 API와 함께 배포된 샘플 프로젝트를 구축하고 실행하기 위한 IntelliJ 환경을 설정하는 방법을 설명합니다. 여기에서는 IntelliJ IDEA 12.0 커뮤니티 버전을 사용하는 단계를 안내합니다.

  1. Android SDK를 다운로드합니다.

  2. IntelliJ에서 전체(IDE) 수준으로 Android SDK를 구성합니다.

  3. 최신 버전의 YouTube Android Player API를 다운로드한 후 IntelliJ가 액세스할 위치에 다운로드한 파일의 압축을 풉니다.

  4. IntelliJ를 엽니다.

    1. File 메뉴에서 Import Project를 선택합니다. 가져올 파일이나 디렉토리를 선택하라는 메시지가 표시되면 압축을 푼 파일 콘텐츠에 있는 sample 디렉토리로 이동합니다.
    2. 기존 소스에서 프로젝트를 만들도록 선택합니다.
    3. 프로젝트의 이름과 프로젝트 위치를 설정합니다. (프로젝트 위치는 sample 디렉토리를 지정해야 합니다.)
    4. 프로젝트와 관련하여 찾은 소스 파일을 모두 프로젝트 루트에 추가하도록 선택합니다.
    5. 프로젝트와 관련하여 찾은 라이브러리를 검토한 후 다음 단계로 진행합니다.
    6. 프로젝트와 관련하여 검색한 모듈 구조를 검토한 후 다음 단계로 진행합니다.
    7. Android 4.2 이상 플랫폼 SDK를 프로젝트 SDK로 선택합니다.
    8. 프로젝트와 관련하여 감지된 프레임워크를 검토한 후 프로젝트 가져오기를 종료합니다.

  5. com.examples.youtubeapidemo 패키지(sample/src/com/examples/youtubeapidemo/DeveloperKey.java)에 있는 DeveloperKey.java 파일을 열고 null을 다음 줄에 있는 유효한 YouTube 개발자 키로 교체합니다.

    public static final String DEVELOPER_KEY = null;

    개발자 키를 설정하지 않으면 샘플은 java.lang.NullPointerException을 표시하며 실행하려고 하면 닫힙니다.

  6. Build 메뉴에서 Make project를 선택하여 프로젝트를 만듭니다.

  7. 연결된 Android 기기에서 샘플을 실행합니다. 에뮬레이터가 필요한 버전의 YouTube 앱을 실행할 수 없을 수 있으며 이로 인해 샘플이 실행되지 않을 수 있습니다.

    1. YouTube 앱 버전 4.2.16 이상을 실행 중인 Android 기기를 연결합니다.
    2. Run 메뉴에서 Run을 선택합니다.
    3. 샘플 애플리케이션 실행과 관련된 설정을 수정합니다.
    4. General 탭에서 Target Device 섹션 아래에 있는 USB device를 선택합니다.
    5. Run을 클릭하여 연결된 기기에서 샘플을 실행합니다.