Zacznij korzystać z usług gier Play w C++ na Androidzie

Zanim zaczniesz

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

W tym przewodniku dla programistów wykorzystano pakiet Android Native Development Kit (NDK). Jeśli nie znasz NDK, zanim przejdziesz dalej, zapoznaj się z dokumentacją i przykładami NDK.

Krok 1. Skonfiguruj środowisko

  1. Pobierz pakiet Android SDK i pakiet Android NDK na urządzenie. W środowisku ustaw SDK_ROOT na lokalizację folderu Android SDK, a NDK_ROOT na lokalizację folderu NDK Androida.
  2. Pobierz przykładowe gry w C++. Ten przewodnik dla programistów określa lokalizację próbek na komputerze jako SAMPLES_DIR.
  3. Pobierz pakiet SDK usług gier Google Play w C++. Rozpakuj pakiet SDK na swoim komputerze. W środowisku ustaw zmienną NDK_MODULE_PATH tak, aby wskazywała katalog powyżej katalogu gpg-cpp-sdk. Struktura katalogu powinna wyglądać tak:
    NDK_MODULE_PATH/
    gpg-cpp-sdk/
  4. Otwórz Eclipse Jeśli nie zostało to jeszcze zrobione, powiedz Eclipse gdzie zainstalowano NDK, klikając Preferencje > Android > NDK.
  5. Zaimportuj projekt z biblioteki Usług Google Play do obszaru roboczego Eclipse.

    1. W Eclipse kliknij Plik > Importuj > Android > Istniejący kod Androida w Workspace.
    2. Wybierz SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, gdzie SDK_ROOT to lokalizacja Twojego pakietu Android SDK.
    3. Kliknij Zakończ.
  6. Zaimportuj minimalistyczny przykładowy projekt do obszaru roboczego Eclipse.

    1. W Eclipse kliknij Plik > Importuj > Android > Istniejący kod Androida w Workspace.
    2. Wybierz SAMPLES_DIR/samples-android/minimalist.
    3. Kliknij Zakończ.
  7. Kliknij prawym przyciskiem myszy projekt MinimalistActivity i wybierz Properties (Właściwości). W sekcji Android przewiń w dół do sekcji Biblioteka i upewnij się, że projekt google-play-services_lib zawiera prawidłowe odwołania. Jeśli tak nie jest, usuń plik referencyjny i dodaj go ponownie z obszaru roboczego.

Eclipse automatycznie skompiluje źródła Java i Android w Twoim projekcie. Kod natywny w folderze jni należy skompilować oddzielnie. Aby to zrobić ręcznie, przejdź do folderu jni i uruchom ndk-build. Pamiętaj, aby to zrobić po wprowadzeniu zmian w folderze jni.

Twój projekt powinien się skompilować, ale nie będzie jeszcze działać. Najpierw musisz skonfigurować grę w Konsoli Google Play.

Krok 2. Skonfiguruj grę w Konsoli Google Play

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

  1. Utwórz wpis swojej gry, wykonując czynności opisane w artykule Konfigurowanie usług gier Google Play.
  2. W AndroidManifest.xml zmień wartość atrybutu package tagu <manifest> na nazwę pakietu wybraną podczas konfigurowania Konsoli Google Play. Po wprowadzeniu tej zmiany może być konieczne naprawienie pewnych odwołań w całym projekcie (zwłaszcza w wygenerowanej klasie R).
  3. Otwórz aplikację res/values/ids.xml i umieść tam identyfikator aplikacji. Identyfikator aplikacji to coś innego niż identyfikator 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, musisz mieć fizyczne urządzenie z Androidem lub emulator z zainstalowanymi usługami Google Play:

  1. Uruchom ndk-build, aby skompilować kod natywny.
  2. W Eclipse kliknij Uruchom > Uruchom jako > Aplikacja na Androida i uruchom przykład na urządzeniu.
  3. Po otwarciu przykładu kliknij dowolne miejsce na ekranie. Powinno pojawić się logo Gier Google Play. Jeśli aplikacja jest prawidłowo skonfigurowana, zobaczysz prośbę o zalogowanie się.

Opcjonalnie: automatyczne tworzenie za pomocą Eclipse

Poniżej znajdziesz instrukcje konfigurowania Eclipse pod kątem automatycznego uruchamiania ndk-build podczas wprowadzania zmian w plikach w folderze jni.

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

Za każdym razem, gdy edytujesz plik w folderze jni, narzędzie Eclipse uruchomi polecenie ndk-build i wyświetli dane wyjściowe w konsoli Eclipse.