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

Ten przewodnik dla deweloperów pokazuje, jak skompilować i uruchomić na urządzeniu z Androidem grę w C++, która korzysta z interfejsu API Usług gier Google Play. Zanim zaczniesz, pobierz i skonfiguruj te wymagania:

Ten przewodnik dla deweloperów korzysta z pakietu Native Development Kit (NDK) na Androida. Jeśli nie znasz NDK, przed kontynuacją zapoznaj się z dokumentacją i przykładami NDK.

Krok 1. Skonfiguruj środowisko

  1. Pobierz pakiet Android SDK i Android NDK, a potem rozpakuj je na komputerze. W swoim środowisku ustaw SDK_ROOT jako lokalizację folderu Android SDK, a NDK_ROOT jako lokalizację folderu Android NDK.
  2. Pobierz przykładowe gry w C++. W tym przewodniku dla deweloperów lokalizacja próbek na komputerze jest określana jako SAMPLES_DIR.
  3. Pobierz pakiet C++ SDK usług gier Google Play. Wypakuj pakiet SDK na komputerze programistycznym. W swoim środowisku ustaw zmienną NDK_MODULE_PATH tak, aby wskazywała katalog powyżej katalogu gpg-cpp-sdk. Powinna powstać taka struktura katalogów: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Otwórz Eclipse. Jeśli nie zostało to jeszcze zrobione, podaj Eclipse informacje o miejscu instalacji NDK, klikając Ustawienia > Android > NDK.

  5. Zaimportuj projekt biblioteki usług Google Play do środowiska Eclipse.

    1. W Eclipse kliknij Plik > Importuj > Android > Istniejący kod Androida do Workspace.
    2. Wybierz SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, gdzie SDK_ROOT to lokalizacja 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 do Workspace.
    2. Wybierz SAMPLES_DIR/samples-android/minimalist.
    3. Kliknij Zakończ.

  7. Kliknij prawym przyciskiem projekt MinimalistActivity i wybierz Właściwości. W sekcji Android przewiń w dół do sekcji Biblioteka i upewnij się, że projekt google-play-services_lib jest poprawnie zaimportowany. Jeśli nie, usuń odwołanie i ponownie dodaj je do obszaru roboczego.

Eclipse automatycznie skompiluje źródła kodu Java i Androida w Twoim projekcie, ale kod natywny w folderze jni musi zostać skompilowany osobno. Aby to zrobić ręcznie, przejdź do folderu 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 o grze w Konsoli Google Play. W ten sposób włączysz usługi Gier w swojej aplikacji i utworzysz 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 Google 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 całym projekcie (zwłaszcza w generowanej klasie R).
  3. Otwórz res/values/ids.xml i wpisz 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 kod

Aby uruchomić ten 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 Uruchom > Uruchom jako > Aplikacja na Androida i uruchom przykład na urządzeniu.
  3. Gdy otworzy się próbka, kliknij dowolne miejsce na ekranie. Powinno pojawić się logo Gier Google Play. Jeśli aplikacja jest prawidłowo skonfigurowana, pojawi się prośba o logowanie.

Opcjonalnie: kompilacja automatyczna za pomocą Eclipse

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

  1. Kliknij prawym przyciskiem projekt MinimalistActivity i wybierz Właściwości. W oknie Właściwości wybierz panel Twórcy.
  2. Kliknij Nowy, aby dodać nowy kreator, 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. Kliknij kolejno opcję Konkretne zasoby i Określ zasoby. W wyświetlonym oknie wybierz folder jni w sekcji Minimalna aktywność.
  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 dane wyjściowe w konsoli Eclipse.