시작하기 전에
이 개발자 가이드에서는 Google Play를 사용하는 Android에서 C++ 게임을 컴파일하고 실행하는 방법을 보여줍니다. 게임 서비스 API 시작하기 전에 다음 요구사항을 다운로드하고 구성합니다.
- Android NDK, 버전 14 이상
- Android SDK v10 이상 및 Eclipse ADT의 최신 버전
- 기기에서 Android 4.0 (API 수준 14) 이상을 실행해야 합니다.
- 최신 버전의 Google Play 서비스 SDK
이 개발자 가이드에서는 Android NDK (Native Development Kit)를 사용합니다. NDK에 익숙하지 않다면 NDK 문서 및 샘플을 참고하세요. 를 선택합니다.
1단계: 환경 설정
- Android SDK 및 Android NDK를 다운로드하고 컴퓨터에 압축을 풉니다.
SDK_ROOT
를 Android SDK 폴더의 위치로 설정하고NDK_ROOT
를 Android NDK 폴더의 위치입니다. - C++ 샘플 게임을 다운로드합니다. 이
개발자 가이드에서는 컴퓨터에 있는 샘플의 위치를
SAMPLES_DIR
라고 합니다. - Google Play 게임즈 서비스 C++ SDK를 다운로드합니다. 추출
배포할 수 있습니다 환경에서
NDK_MODULE_PATH
변수를 다음과 같이 설정합니다.gpg-cpp-sdk
디렉터리 위 디렉터리를 가리킵니다. 다음이 있어야 합니다. 디렉터리 구조는 다음과 같습니다.NDK_MODULE_PATH/ gpg-cpp-sdk/
- Eclipse를 엽니다. 아직 하지 않은 경우 다음을 수행하여 NDK를 설치한 위치를 Eclipse에 알립니다. 환경설정 > Android > NDK입니다.
Google Play 서비스 라이브러리 프로젝트를 Eclipse 작업공간으로 가져옵니다.
- Eclipse에서 파일 > 가져오기 > Android > Workspace의 기존 Android 코드
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
선택 여기서SDK_ROOT
는 Android SDK의 위치입니다.- 마침을 클릭합니다.
미니멀리스트 샘플 프로젝트를 Eclipse 작업공간으로 가져옵니다.
- Eclipse에서 파일 > 가져오기 > Android > Workspace의 기존 Android 코드
SAMPLES_DIR/samples-android/minimalist
를 선택합니다.- 마침을 클릭합니다.
miniistActivity 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 Properties를 클릭합니다. Android 아래에서 스크롤합니다. 라이브러리 섹션으로 이동하여 google-play-services_lib 프로젝트가 올바른지 확인합니다. 참조됩니다. 그렇지 않은 경우 참조를 삭제하고 작업공간에서 다시 추가합니다.
Eclipse가 프로젝트의 Java 및 Android 소스를 자동으로 컴파일합니다. 하지만
jni
폴더의 네이티브 코드는 별도로 컴파일해야 합니다. 수동으로 이 작업을 수행하려면 다음으로 이동하세요.
jni
폴더를 열고 ndk-build
를 실행합니다. 내부에서 변경사항을 적용한 후 이 작업을 수행해야 합니다.
jni
폴더
이제 프로젝트가 컴파일되지만 아직 작동하지는 않습니다. 먼저 게임을 구성해야 합니다. 하세요.
2단계: Google Play Console에서 게임 설정하기
Google Play Console에서 게임의 항목을 만듭니다. 이렇게 하면 하고 OAuth 2.0 클라이언트 ID를 만듭니다(아직 없는 경우).
- 다음에 설명된 단계에 따라 게임의 항목을 만듭니다. Google Play 게임즈 서비스 설정
AndroidManifest.xml
에서<manifest>
태그의package
속성을 Google Play Console을 설정할 때 선택한 패키지 이름입니다. 일부 참조를 수정해야 할 수 있습니다. 프로젝트 전체에서 (특히 생성된R
클래스)res/values/ids.xml
을 열고 여기에 앱 ID를 배치합니다. 앱 ID는 클라이언트 ID 게임 세부정보 페이지에서 게임 이름 옆에 있는 숫자입니다 Google Play Console로 이동합니다.
3단계: 샘플 실행
샘플을 실행하려면 실제 Android 기기나 설치된 Google Play 서비스:
ndk-build
를 실행하여 네이티브 코드를 컴파일합니다.- Eclipse에서 실행 > 다음으로 실행 > Android 애플리케이션을 다운로드하고 기기에서 샘플을 실행합니다.
- 샘플이 열리면 화면의 아무 곳이나 탭합니다. Google Play 게임즈 로고가 표시됩니다. 나타납니다. 앱을 올바르게 구성했다면 로그인하라는 메시지가 표시됩니다.
선택사항: Eclipse를 사용하여 자동으로 빌드
다음 단계는 다음을 실행할 때 ndk-build
를 자동으로 실행하도록 Eclipse를 구성하는 방법을 보여줍니다.
jni
폴더의 파일을 변경합니다.
- miniistActivity 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 Properties를 클릭합니다. 속성 창에서 Builders 창을 선택합니다.
- New(새로 만들기)를 클릭하여 새 빌더를 추가하고 Program(프로그램)을 선택한 다음 OK(확인)를 클릭합니다.
- 이름 입력란에 'NDK Builder'를 입력합니다.
- Location(위치)에서 Browse File System(파일 시스템 찾아보기)을 클릭하고
NDK_ROOT
디렉터리로 이동한 다음ndk-build
명령어를 선택합니다. - 작업 디렉터리에서 작업공간 둘러보기를 클릭하고 미니멀리스트 활동을 선택합니다. 프로젝트 폴더로 이동합니다.
- 새로고침 탭을 클릭합니다. 완료 시 리소스 새로고침 체크박스가 선택되어 있는지 확인합니다.
- 특정 리소스 라디오 버튼을 선택한 다음 리소스 지정을 클릭합니다.
표시되는 대화상자에서 minimumActivity에서
jni
폴더를 선택합니다. - Apply를 클릭한 후 OK를 클릭하여 빌더 만들기를 완료합니다.
이제 jni
폴더 내의 파일을 수정할 때마다 Eclipse가 ndk-build
를 실행하고 다음을 출력합니다.
Eclipse Console에 출력됩니다.