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

Zanim zaczniesz

Z tego przewodnika dla programistów dowiesz się, jak skompilować i uruchomić grę w języku C++ na Androida, która korzysta z Google Play Interfejs API usług gier. Zanim zaczniesz, pobierz i skonfiguruj następujące wymagania:

Ten przewodnik dla programistów korzysta z pakietu Android Native Development Kit (NDK). Jeśli nie znacie NDK, zapoznaj się z dokumentacją i przykładami NDK zanim przejdziesz dalej.

Krok 1. Skonfiguruj środowisko

  1. Pobierz Android SDK oraz Android NDK i rozpakuj je na swoim komputerze. W ustaw SDK_ROOT na lokalizację folderu Android SDK, a NDK_ROOT na w której znajduje się folder NDK na Androidzie.
  2. Pobierz przykładowe gry w C++. Ten Przewodnik dla programistów to lokalizacja próbek na komputerze jako SAMPLES_DIR.
  3. Pobierz pakiet SDK C++ dla usług gier Google Play. Wyodrębnij na komputerze, na którym tworzysz pakiet SDK. W swoim środowisku ustaw zmienną NDK_MODULE_PATH na wskaż katalog nad katalogiem gpg-cpp-sdk. Powinieneś mieć: struktura katalogów: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Otwórz Eclipse. Jeśli jeszcze nie zostało to zrobione, poinformuj Eclipse, gdzie zainstalowano NDK, klikając Preferencje > Android > NDK

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

    1. W Eclipse kliknij File (Plik) > Importuj > Android > Wdrożono kod Android w 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 File (Plik) > Importuj > Android > Wdrożono kod Android w Workspace.
    2. Wybierz SAMPLES_DIR/samples-android/minimalist.
    3. Kliknij Zakończ.

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

Eclipse automatycznie skompiluje źródła projektu w Javie i na Androidzie. jednak kod natywny w folderze jni trzeba skompilować oddzielnie. Aby zrobić to ręcznie, otwórz folder jni i uruchom ndk-build. Pamiętaj, by zrobić to po wprowadzeniu zmian folder jni.

Twój projekt powinien się teraz skompilować, ale jeszcze nie 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. Spowoduje to włączenie usług gier na Twoim oraz utworzy identyfikator klienta OAuth 2.0, jeśli jeszcze go nie masz.

  1. Utwórz wpis do gry, wykonując czynności opisane na stronie Konfigurowanie usług gier Google Play
  2. W języku AndroidManifest.xml zmień atrybut package tagu <manifest> na nazwę pakietu wybraną podczas konfigurowania Konsoli Google Play. Konieczne może być poprawienie niektórych plików referencyjnych w całym projekcie po wprowadzeniu tej zmiany (zwłaszcza w wygenerowanej klasie R).
  3. Otwórz res/values/ids.xml i umieść tam swój identyfikator aplikacji. Pamiętaj, że identyfikator aplikacji to nie to samo co identyfikator klienta; jest on widoczny obok nazwy Twojej gry na stronie Szczegóły gry w Konsoli Google Play.

Krok 3. Uruchamianie przykładu

Aby uruchomić próbkę, potrzebujesz fizycznego urządzenia z Androidem lub emulatora z Zainstalowane Usługi Google Play:

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

Opcjonalnie: automatyczne kompilowanie za pomocą Eclipse

Z dalszej części artykułu dowiesz się, jak skonfigurować Eclipse tak, aby automatycznie uruchamiało się ndk-build, gdy: wprowadzić zmiany w plikach w folderze jni.

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

Od teraz za każdym razem, gdy będziesz edytować plik w folderze jni, Eclipse uruchomi ndk-build i wydrukuje plik dane wyjściowe do konsoli Eclipse.