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:
- Android NDK w wersji 14 lub nowszej.
- Pakiet Android SDK w wersji 10 lub nowszej i najnowsza wersja ADP Eclipse
- Na urządzeniu musi być zainstalowany Android 4.0 (poziom interfejsu API 14) lub nowszy.
- Najnowsza wersja pakietu SDK usług Google Play.
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
- Pobierz pakiet Android SDK i pakiet Android NDK na urządzenie. W środowisku ustaw
SDK_ROOT
na lokalizację folderu Android SDK, aNDK_ROOT
na lokalizację folderu NDK Androida. - Pobierz przykładowe gry w C++. Ten przewodnik dla programistów określa lokalizację próbek na komputerze jako
SAMPLES_DIR
. - 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 katalogugpg-cpp-sdk
. Struktura katalogu powinna wyglądać tak:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Otwórz Eclipse Jeśli nie zostało to jeszcze zrobione, powiedz Eclipse gdzie zainstalowano NDK, klikając Preferencje > Android > NDK.
Zaimportuj projekt z biblioteki Usług Google Play do obszaru roboczego Eclipse.
- W Eclipse kliknij Plik > Importuj > Android > Istniejący kod Androida w Workspace.
- Wybierz
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
, gdzieSDK_ROOT
to lokalizacja Twojego pakietu Android SDK. - Kliknij Zakończ.
Zaimportuj minimalistyczny przykładowy projekt do obszaru roboczego Eclipse.
- W Eclipse kliknij Plik > Importuj > Android > Istniejący kod Androida w Workspace.
- Wybierz
SAMPLES_DIR/samples-android/minimalist
. - Kliknij Zakończ.
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.
- Utwórz wpis swojej gry, wykonując czynności opisane w artykule Konfigurowanie usług gier Google Play.
- W
AndroidManifest.xml
zmień wartość atrybutupackage
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 klasieR
). - 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:
- Uruchom
ndk-build
, aby skompilować kod natywny. - W Eclipse kliknij Uruchom > Uruchom jako > Aplikacja na Androida i uruchom przykład na urządzeniu.
- 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
.
- Kliknij prawym przyciskiem myszy projekt MinimalistActivity i wybierz Properties (Właściwości). W oknie Właściwości wybierz panel Konstruktorzy.
- Kliknij Nowy, aby dodać nowego konstruktora i wybierz Program, a następnie kliknij OK.
- W polu Nazwa wpisz „NDK Builder”.
- W sekcji Lokalizacja kliknij Przeglądaj system plików, przejdź do katalogu
NDK_ROOT
i wybierz poleceniendk-build
. - W sekcji Katalog roboczy kliknij Przeglądaj obszar roboczy i wybierz folder projektu MinimalistActivity.
- Kliknij kartę Odśwież. Zaznacz pole Odśwież zasoby po zakończeniu.
- Wybierz opcję Określone zasoby, a następnie kliknij Określ zasoby. W wynikowym oknie wybierz folder
jni
w sekcji MinimalActivity. - 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.