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:
- Android NDK, wersja 14 lub nowsza.
- Android SDK w wersji 10 lub nowszej oraz najnowsza wersja Eclipse ADT.
- Na urządzeniu musi być zainstalowany Android 4.0 (poziom interfejsu API 14) lub nowszy.
- Najnowsza wersja pakietu SDK Usług Google Play
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
- Pobierz Android SDK oraz Android NDK i rozpakuj je na swoim komputerze. W
ustaw
SDK_ROOT
na lokalizację folderu Android SDK, aNDK_ROOT
na w której znajduje się folder NDK na Androidzie. - Pobierz przykładowe gry w C++. Ten
Przewodnik dla programistów to lokalizacja próbek na komputerze jako
SAMPLES_DIR
. - 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 katalogiemgpg-cpp-sdk
. Powinieneś mieć: struktura katalogów:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Otwórz Eclipse. Jeśli jeszcze nie zostało to zrobione, poinformuj Eclipse, gdzie zainstalowano NDK, klikając Preferencje > Android > NDK
Zaimportuj projekt biblioteki Usług Google Play do obszaru roboczego Eclipse.
- W Eclipse kliknij File (Plik) > Importuj > Android > Wdrożono kod Android w Workspace.
- Wybierz
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
gdzieSDK_ROOT
to lokalizacja pakietu Android SDK. - Kliknij Zakończ.
Zaimportuj minimalistyczny przykładowy projekt do obszaru roboczego Eclipse.
- W Eclipse kliknij File (Plik) > Importuj > Android > Wdrożono kod Android w Workspace.
- Wybierz
SAMPLES_DIR/samples-android/minimalist
. - Kliknij Zakończ.
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.
- Utwórz wpis do gry, wykonując czynności opisane na stronie Konfigurowanie usług gier Google Play
- W języku
AndroidManifest.xml
zmień atrybutpackage
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 klasieR
). - 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:
- Uruchom
ndk-build
, aby skompilować kod natywny. - W Eclipse kliknij Uruchom > Uruchom jako > aplikacji na Androida i uruchom ją na swoim urządzeniu.
- 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
.
- Kliknij prawym przyciskiem myszy projekt MinimalistActivity i wybierz Właściwości. W oknie Właściwości kliknij panel Kompilatory.
- Kliknij Nowy, aby dodać nowy kreator, i wybierz Program, a następnie kliknij OK.
- W polu Nazwa wpisz „NDK Builder”.
- W obszarze Lokalizacja kliknij Przeglądaj system plików, przejdź do katalogu
NDK_ROOT
i wybierz poleceniendk-build
. - W sekcji Working Directory (Katalog roboczy) kliknij Przeglądaj obszar roboczy i wybierz opcję MinimalistActivity. folderu projektu.
- Kliknij kartę Odśwież. Upewnij się, że pole Odśwież zasoby po zakończeniu jest zaznaczone.
- Zaznacz opcję Określone zasoby, a następnie kliknij Określ zasoby. W
w wyświetlonym oknie wybierz folder
jni
w sekcji MinimalActivity. - 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.