Начните работу с игровыми сервисами Play для C++ на Android

Внимание! Это руководство предназначено для использования Play Games Services v1. C SDK и сопровождающее руководство для Play Games Services v2 появятся в ближайшее время. А пока вы можете найти дополнительную информацию о версии 2 в руководстве по входу . Если вы заинтересованы в тестировании новой версии SDK, обратитесь к своему контактному лицу в Google для получения дополнительной информации.

Прежде чем вы начнете

В этом руководстве для разработчиков показано, как скомпилировать и запустить игру C++ на Android, использующую API игровых сервисов Google Play. Прежде чем начать, загрузите и настройте следующие требования:

• Android NDK версии 14 или выше.
• Android SDK v10 или выше и последняя версия Eclipse ADT .
• Устройство должно работать под управлением Android 4.0 (уровень API 14) или выше.
• Последняя версия SDK сервисов Google Play.

В этом руководстве для разработчиков используется Android Native Development Kit (NDK). Если вы не знакомы с NDK, обратитесь к документации и примерам NDK, прежде чем продолжить.

Шаг 1. Настройте среду

1. Загрузите Android SDK и Android NDK и извлеките их на свой компьютер. В вашей среде задайте SDK_ROOT расположение папки Android SDK, а NDK_ROOT — расположение папки Android NDK.
2. Загрузите примеры игр C++ . В этом руководстве разработчика расположение образцов на вашем компьютере называется SAMPLES_DIR .
3. Загрузите SDK C++ для сервисов Google Play Games . Извлеките SDK на свой компьютер для разработки. В вашей среде установите переменную NDK_MODULE_PATH так, чтобы она указывала на каталог над каталогом gpg-cpp-sdk . У вас должна быть следующая структура каталогов:

   NDK_MODULE_PATH/
   gpg-cpp-sdk/

4. Откройте затмение. Если вы еще этого не сделали, сообщите Eclipse, где вы установили NDK, щелкнув Preferences > Android > NDK .

5. Импортируйте проект библиотеки сервисов Google Play в рабочую область Eclipse.

   1. В Eclipse нажмите «Файл» > «Импорт» > «Android» > «Существующий код Android в рабочую область ».
   2. Выберите SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib где SDK_ROOT — это расположение вашего Android SDK.
   3. Нажмите Готово .

6. Импортируйте минималистичный пример проекта в рабочую область Eclipse.

   1. В Eclipse нажмите «Файл» > «Импорт» > «Android» > «Существующий код Android в рабочую область ».
   2. Выберите SAMPLES_DIR/samples-android/minimalist .
   3. Нажмите Готово .

7. Щелкните правой кнопкой мыши проект MinimalistActivity и выберите «Свойства» . В разделе Android прокрутите вниз до раздела «Библиотека» и убедитесь, что ссылка на проект google-play-services_lib указана правильно. Если нет, удалите ссылку и снова добавьте ее из рабочей области.

Eclipse автоматически скомпилирует исходные коды Java и Android вашего проекта; однако собственный код в папке jni необходимо скомпилировать отдельно. Чтобы сделать это вручную, перейдите в папку jni и запустите ndk-build . Не забудьте сделать это после внесения любых изменений в папку jni .

Теперь ваш проект должен скомпилироваться, хотя он еще не будет работать. Сначала необходимо настроить игру в консоли Google Play.

Шаг 2. Настройте игру в консоли Google Play.

Создайте запись для своей игры в консоли Google Play. Это включает игровые службы для вашего приложения и создает идентификатор клиента OAuth 2.0, если у вас его еще нет.

1. Создайте запись для своей игры, выполнив действия, описанные в разделе «Настройка игровых сервисов Google Play» .
2. В AndroidManifest.xml измените атрибут package тега <manifest> на имя пакета, которое вы выбрали при настройке консоли Google Play. Возможно, вам придется исправить некоторые ссылки в проекте после внесения этого изменения (особенно в сгенерированный класс R ).
3. Откройте res/values/ids.xml и поместите туда свой идентификатор приложения. Обратите внимание, что идентификатор приложения не совпадает с идентификатором клиента; это число рядом с названием вашей игры на странице сведений об игре в консоли Google Play.

Шаг 3. Запустите образец

Для запуска примера вам потребуется физическое Android-устройство или эмулятор с установленными сервисами Google Play:

1. Запустите ndk-build , чтобы скомпилировать собственный код.
2. В Eclipse выберите «Выполнить» > «Запуск от имени» > «Приложение Android» и запустите образец на своем устройстве.
3. Когда образец откроется, коснитесь экрана в любом месте. Вы должны увидеть логотип Google Play Games. Если вы правильно настроили свое приложение, вам будет предложено войти в систему.

Важно: обязательно подпишите свой APK тем же сертификатом, что и тот, чей отпечаток пальца вы настроили в консоли Google Play. Невыполнение этого требования приведет к ошибкам.

Важно: если вы тестируете неопубликованную игру, убедитесь, что учетная запись, с которой вы собираетесь войти (обычно это учетная запись на тестовом устройстве), указана в качестве тестера в проекте. Откройте страницу «Тестирование» на вложенной вкладке «Игровые сервисы» консоли Google Play, чтобы проверить или внести в белый список. Невыполнение этого шага приводит к тому, что сервер ведет себя так, как будто ваш проект не существует, и возвращает ошибки.

Необязательно: Автоматическое построение с помощью Eclipse

Следующие шаги показывают, как настроить Eclipse для автоматического запуска ndk-build при внесении изменений в файлы в папке jni .

1. Щелкните правой кнопкой мыши проект MinimalistActivity и выберите пункт Свойства . В окне свойств выберите панель Builders .
2. Нажмите «Создать» , чтобы добавить новый Builder, и выберите «Программа» , затем нажмите «ОК» .
3. В поле «Имя» введите «NDK Builder».
4. В разделе «Расположение» нажмите «Обзор файловой системы» , перейдите в каталог NDK_ROOT и выберите команду ndk-build .
5. В разделе «Рабочий каталог» нажмите «Обзор рабочей области» и выберите папку проекта MinimalistActivity.
6. Щелкните вкладку «Обновить» . Убедитесь, что установлен флажок Обновлять ресурсы после завершения .
7. Выберите переключатель «Конкретные ресурсы» и нажмите «Указать ресурсы» . В появившемся диалоговом окне выберите папку jni в разделе MinimalActivity.
8. Нажмите «Применить» , а затем «ОК» , чтобы завершить создание вашего Builder.

Теперь каждый раз, когда вы редактируете файл в папке jni , Eclipse будет запускать ndk-build и выводить результат на консоль Eclipse.

Примечание. Если вы видите ошибки при редактировании файлов C или C++ в Eclipse, которые мешают вам построить проект, вы можете отключить отчеты об ошибках C/C++ в Eclipse. В свойствах проекта перейдите в C/C++ General > Code Analysis > Launching и убедитесь, что оба флажка сняты. Затем нажмите «Применить» и «ОК» . Это обходной путь, позволяющий Eclipse не проверять ваш собственный код, он не исправляет какие-либо реальные базовые ошибки, которые могут у вас возникнуть.