Pierwsze kroki z usługami gier Play dla języka C++ na Androidzie

Po wycofaniu interfejsu Google Sign-In API w 2026 roku usuniemy pakiet SDK do gier w wersji 1. Z końcem lutego 2025 r. nie będzie już można publikować w Google Play nowych tytułów, w których zastosowano integrację z wersją 1 pakietu SDK gier. Zamiast tego zalecamy używanie pakietu SDK do gier w wersji 2.
Dotychczasowe tytuły z integracjami gier w wersji 1 będą działać jeszcze przez kilka lat, ale zachęcamy do przejścia na wersję 2 od czerwca 2025 r.
Ten przewodnik dotyczy korzystania z pakietu SDK usług gier Play w wersji 1. Pakiet C++ SDK usług gier Play w wersji 2 nie jest jeszcze dostępny.

Z tego przewodnika dla deweloperów dowiesz się, jak skompilować i uruchomić na Androidzie grę w C++, która korzysta z interfejsu API usług gier Google Play. Zanim zaczniesz, pobierz i skonfiguruj te wymagania:

W tym przewodniku dla deweloperów używany jest pakiet Android Native Development Kit (NDK). Jeśli nie znasz NDK, przed kontynuowaniem zapoznaj się z dokumentacją i przykładami NDK.

Krok 1. Skonfiguruj środowisko

  1. Pobierz pakiet Android SDK i Android NDK, a następnie rozpakuj je na komputerze. W swoim środowisku ustaw SDK_ROOT na lokalizację folderu Android SDK, a NDK_ROOT na lokalizację folderu Android NDK.
  2. Pobierz przykładowe gry w C++. W tym przewodniku dla deweloperów lokalizacja przykładów na komputerze jest oznaczana jako SAMPLES_DIR.
  3. Pobierz pakiet SDK C++ usług gier Google Play. Rozpakuj pakiet SDK na komputerze deweloperskim. W swoim środowisku ustaw zmienną NDK_MODULE_PATH tak, aby wskazywała katalog nad katalogiem gpg-cpp-sdk. Powinna pojawić się ta struktura katalogów: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Otwórz Eclipse. Jeśli jeszcze tego nie zrobiono, wskaż Eclipse, gdzie zainstalowano NDK, klikając Preferences > Android > NDK (Ustawienia > Android > NDK).

  5. Zaimportuj projekt biblioteki usług Google Play do obszaru roboczego Eclipse.

    1. W Eclipse kliknij File > Import > Android > Existing Android Code into Workspace (Plik > Importuj > Android > Istniejący kod Androida do obszaru roboczego).
    2. Wybierz SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib gdzie SDK_ROOT to lokalizacja pakietu SDK na Androida.
    3. Kliknij Zakończ.

  6. Zaimportuj minimalistyczny przykładowy projekt do obszaru roboczego Eclipse.

    1. W Eclipse kliknij File > Import > Android > Existing Android Code into Workspace (Plik > Importuj > Android > Istniejący kod Androida do obszaru roboczego).
    2. Wybierz SAMPLES_DIR/samples-android/minimalist.
    3. Kliknij Zakończ.

  7. Kliknij prawym przyciskiem myszy projekt MinimalistActivity i kliknij Właściwości. W sekcji Android przewiń w dół do sekcji Library i upewnij się, że projekt google-play-services_lib jest prawidłowo przywoływany. Jeśli nie, usuń odwołanie i dodaj je ponownie z obszaru roboczego.

Eclipse automatycznie skompiluje źródła Java i Androida w Twoim projekcie, ale kod natywny w folderze jni musi zostać skompilowany oddzielnie. Aby to zrobić ręcznie, otwórz folder jni i uruchom ndk-build. Pamiętaj, aby to zrobić po wprowadzeniu zmian w folderze jni.

Projekt powinien się teraz skompilować, ale jeszcze nie będzie działać. Najpierw musisz skonfigurować grę w Konsoli Google Play.

Krok 2. Skonfiguruj grę w Konsoli Google Play

Utwórz wpis dotyczący gry w Konsoli Google Play. Włącza to usługi gier w Twojej aplikacji i tworzy identyfikator klienta OAuth 2.0, jeśli jeszcze go nie masz.

  1. Utwórz wpis dla swojej gry, wykonując czynności opisane w artykule Konfigurowanie usług gier Play.
  2. W AndroidManifest.xml zmień atrybut package tagu <manifest> na nazwę pakietu wybraną podczas konfigurowania Konsoli Google Play. Po wprowadzeniu tej zmiany może być konieczne poprawienie niektórych odwołań w projekcie (zwłaszcza do wygenerowanej klasy R).
  3. Otwórz res/values/ids.xml i wklej tam identyfikator aplikacji. Pamiętaj, że identyfikator aplikacji nie jest tożsamy z identyfikatorem klienta. Jest to numer obok nazwy gry na stronie Szczegóły gry w Konsoli Google Play.

Krok 3. Uruchom przykład

Aby uruchomić przykład, potrzebujesz fizycznego urządzenia z Androidem lub emulatora z zainstalowanymi Usługami Google Play:

  1. Uruchom ndk-build, aby skompilować kod natywny.
  2. W Eclipse kliknij Run > Run As > Android Application (Uruchom > Uruchom jako > Aplikacja na Androida) i uruchom aplikację próbną na urządzeniu.
  3. Gdy próbka się otworzy, kliknij dowolne miejsce na ekranie. Powinno pojawić się logo Gier Google Play. Jeśli aplikacja została prawidłowo skonfigurowana, pojawi się prośba o zalogowanie się.

Opcjonalnie: automatyczne kompilowanie za pomocą Eclipse

Poniższe instrukcje pokazują, jak skonfigurować Eclipse, aby automatycznie uruchamiać ndk-build po wprowadzeniu zmian w plikach w folderze jni.

  1. Kliknij prawym przyciskiem myszy projekt MinimalistActivity i kliknij Właściwości. W oknie Właściwości wybierz panel Kreatory.
  2. Kliknij Nowy, aby dodać nowego kreatora, wybierz Program, a potem kliknij OK.
  3. W polu Nazwa wpisz „NDK Builder”.
  4. W sekcji Lokalizacja kliknij Przeglądaj system plików i przejdź do katalogu NDK_ROOT, a następnie wybierz polecenie ndk-build.
  5. W sekcji Katalog roboczy kliknij Przeglądaj obszar roboczy i wybierz folder projektu MinimalistActivity.
  6. Kliknij kartę Odśwież. Sprawdź, czy zaznaczone jest pole Refresh resources upon completion (Odśwież zasoby po zakończeniu).
  7. Kliknij przycisk Określone zasoby, a następnie Określ zasoby. W wyświetlonym oknie wybierz folder jni w sekcji MinimalActivity.
  8. Aby zakończyć tworzenie Kreatora, kliknij Zastosuj, a potem OK.

Teraz za każdym razem, gdy edytujesz plik w folderze jni, Eclipse uruchomi ndk-build i wyświetli wynik w konsoli Eclipse.