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

В связи с прекращением поддержки API входа Google мы удалим SDK для игр v1 в 2026 году. После февраля 2025 года вы не сможете публиковать в Google Play игры, недавно интегрированные с SDK для игр v1. Вместо этого мы рекомендуем использовать SDK для игр v2.
Хотя существующие игры с интеграцией предыдущих игр v1 продолжат функционировать еще пару лет, вам рекомендуется перейти на v2, начиная с июня 2025 года.
Это руководство по использованию Play Games Services v1 SDK. C++ SDK для Play Games Services v2 пока недоступен.

Это руководство разработчика покажет вам, как скомпилировать и запустить игру на C++ на Android, использующую API игровых сервисов 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. Загрузите C++ SDK для сервисов Google Play Games . Распакуйте SDK на компьютер, где вы работаете с разработкой. В вашей среде разработки установите переменную NDK_MODULE_PATH так, чтобы она указывала на каталог, расположенный выше каталога gpg-cpp-sdk . Должна получиться следующая структура каталогов: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Откройте Eclipse. Если вы ещё этого не сделали, укажите Eclipse, куда установлен NDK, нажав «Настройки» > «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 Console.

Шаг 2: Настройте игру в Google Play Console

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

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

Шаг 3: Запуск образца

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

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

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

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

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

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