Android에서 C++용 Play 게임즈 서비스 시작하기

시작하기 전에

이 개발자 가이드에서는 Google Play 게임즈 서비스 API를 사용하는 Android에서 C++ 게임을 컴파일하고 실행하는 방법을 보여줍니다. 시작하기 전에 다음 요구사항을 다운로드하고 구성합니다.

이 개발자 가이드에서는 Android 네이티브 개발 키트 (NDK)를 사용합니다. NDK에 익숙하지 않은 경우 계속 진행하기 전에 NDK 문서 및 샘플을 참고하세요.

1단계: 환경 설정하기

  1. Android SDK 및 Android NDK를 다운로드하고 머신에 추출합니다. 환경에서 SDK_ROOT을 Android SDK 폴더의 위치로 설정하고 NDK_ROOT를 Android NDK 폴더의 위치로 설정합니다.
  2. C++ 샘플 게임을 다운로드합니다. 이 개발자 가이드에서는 머신에서 샘플 위치를 SAMPLES_DIR라고 합니다.
  3. Google Play 게임즈 서비스 C++ SDK를 다운로드합니다. SDK를 개발 머신에 추출합니다. 환경에서 gpg-cpp-sdk 디렉터리 위를 가리키도록 NDK_MODULE_PATH 변수를 설정합니다. 디렉터리 구조는 다음과 같아야 합니다.
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Eclipse를 엽니다. 아직 그렇게 하지 않았다면 Preferences > Android > NDK를 클릭하여 NDK를 설치한 위치를 Eclipse에 알립니다.

  5. Google Play 서비스 라이브러리 프로젝트를 Eclipse 작업공간으로 가져옵니다.

    1. Eclipse에서 파일 > 가져오기 > Android > 기존 Android 코드를 Workspace로를 클릭합니다.
    2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib를 선택합니다. 여기서 SDK_ROOT는 Android SDK의 위치입니다.
    3. Finish를 클릭합니다.

  6. 미니멀리스트 샘플 프로젝트를 Eclipse 작업공간으로 가져옵니다.

    1. Eclipse에서 파일 > 가져오기 > Android > 기존 Android 코드를 Workspace로를 클릭합니다.
    2. SAMPLES_DIR/samples-android/minimalist를 선택합니다.
    3. Finish를 클릭합니다.

  7. MinimalistActivity 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 Properties를 클릭합니다. Android 아래에서 라이브러리 섹션까지 아래로 스크롤하여 google-play-services_lib 프로젝트가 올바르게 참조되었는지 확인합니다. 그렇지 않은 경우 참조를 삭제하고 작업공간에서 다시 추가합니다.

Eclipse는 프로젝트의 자바 및 Android 소스를 자동으로 컴파일합니다. 하지만 jni 폴더의 네이티브 코드는 별도로 컴파일해야 합니다. 이 작업을 수동으로 수행하려면 jni 폴더로 이동하여 ndk-build를 실행하세요. jni 폴더 내에서 변경한 후 이 작업을 실행해야 합니다.

이제 프로젝트가 컴파일되지만 아직 작동하지 않습니다. 먼저 Google Play Console에서 게임을 구성해야 합니다.

2단계: Google Play Console에서 게임 설정하기

Google Play Console에서 게임 항목을 만듭니다. 이렇게 하면 애플리케이션의 게임 서비스가 사용 설정되고 OAuth 2.0 클라이언트 ID가 없는 경우 생성됩니다.

  1. Google Play 게임즈 서비스 설정에 설명된 단계에 따라 게임 항목을 만듭니다.
  2. AndroidManifest.xml에서 <manifest> 태그의 package 속성을 Google Play Console을 설정할 때 선택한 패키지 이름으로 변경합니다. 변경 후 (특히 생성된 R 클래스) 프로젝트 전체에서 일부 참조를 수정해야 할 수도 있습니다.
  3. res/values/ids.xml를 열고 앱 ID를 배치합니다. 앱 ID는 클라이언트 ID와 동일하지 않습니다. Google Play Console의 게임 세부정보 페이지에서 게임 이름 옆의 번호입니다.

3단계: 샘플 실행

샘플을 실행하려면 실제 Android 기기 또는 Google Play 서비스가 설치된 에뮬레이터가 필요합니다.

  1. ndk-build를 실행하여 네이티브 코드를 컴파일합니다.
  2. Eclipse에서 Run > Run As(다음으로 실행) > Android Application을 클릭하고 기기에서 샘플을 실행합니다.
  3. 샘플이 열리면 화면에서 아무 곳이나 탭합니다. Google Play 게임즈 로고가 표시됩니다. 앱을 올바르게 구성했다면 로그인하라는 메시지가 표시됩니다.

선택사항: Eclipse로 자동 빌드

다음 단계에서는 jni 폴더의 파일을 변경할 때 ndk-build가 자동으로 실행되도록 Eclipse를 구성하는 방법을 보여줍니다.

  1. MinimalistActivity 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 Properties를 클릭합니다. 속성 창에서 빌더 창을 선택합니다.
  2. 새로 만들기를 클릭하여 새 빌더를 추가하고 프로그램을 선택한 다음 확인을 클릭합니다.
  3. Name 필드에 'NDK Builder'를 입력합니다.
  4. 위치에서 파일 시스템 찾아보기를 클릭하고 NDK_ROOT 디렉터리로 이동하여 ndk-build 명령어를 선택합니다.
  5. 작업 디렉터리에서 작업공간 찾아보기를 클릭하고 MinimalistActivity 프로젝트 폴더를 선택합니다.
  6. 새로고침 탭을 클릭합니다. 완료 시 리소스 새로고침 체크박스가 선택되어 있는지 확인합니다.
  7. 특정 리소스 라디오 버튼을 선택한 다음 리소스 지정을 클릭합니다. 결과 대화상자의 MinimalActivity에서 jni 폴더를 선택합니다.
  8. 적용을 클릭한 다음 확인을 클릭하여 빌더 만들기를 완료합니다.

이제 jni 폴더 내의 파일을 수정할 때마다 Eclipse가 ndk-build를 실행하고 출력을 Eclipse 콘솔에 출력합니다.