Pierwsze kroki z usługami gier Play na Androida

Witamy w rozwoju gier na Androida z użyciem Usług gier Google Play

Pakiet SDK Play Games udostępnia usługi gier Google Play na różne platformy, dzięki którym możesz łatwo integrować popularne funkcje gier, takie jak osiągnięcia, tablice wyników i zapisane gry, w swoich grach na tablety i urządzenia mobilne.

W tym szkoleniu dowiesz się, jak zainstalować przykładową aplikację do gier na Androida i szybko rozpocząć tworzenie własnej gry na Androida. Przykładowa aplikacja Type-a-Number Challenge pokazuje, jak zintegrować osiągnięcia i tablice liderów ze swoją grą.

Zanim zaczniesz

Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.

Wymagania wstępne dotyczące aplikacji

Sprawdź, czy w pliku kompilacji Twojej aplikacji znajdują się te wartości:

  • wartość minSdkVersion wynosząca co najmniej 19.
  • wartość compileSdkVersion wynosząca co najmniej 28.

Konfigurowanie gry w Konsoli Google Play

W Konsoli Google Play możesz zarządzać usługami gier Google Play dotyczącymi swojej gry oraz konfigurować metadane służące do autoryzacji i uwierzytelniania gry. Więcej informacji znajdziesz w artykule Konfigurowanie Usług gier Google Play.

Konfigurowanie aplikacji

W pliku build.gradle na poziomie projektu dodaj repozytorium Maven firmy Google i centralne repozytorium Maven w sekcjach buildscript i allprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Dodaj zależność Usług Google Play do pakietu SDK Usług gier Google Play do pliku build.gradle modułu. Jest to zwykle app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

Przewodnik po przykładowej aplikacji

W tym szkoleniu dowiesz się, jak zainstalować przykładową aplikację z grą na Androida i szybko rozpocząć tworzenie własnej gry na Androida. Przykładowa aplikacja Type-a-Number Challenge pokazuje, jak zintegrować osiągnięcia i tablice liderów ze swoją grą.

Krok 1. Pobierz przykładową aplikację

Aby skorzystać z tego przewodnika dla deweloperów, musisz pobrać przykładową aplikację na Androida Type-a-Number Challenge.

Aby pobrać i skonfigurować przykładową aplikację w Android Studio:

  1. Pobierz przykłady na Androida ze strony z przykładami do pobrania.
  2. Zaimportuj projekt android-basic-samples. Ten projekt zawiera TypeANumber i inne przykładowe gry na Androida. Aby to zrobić w Android Studio:
    1. Kliknij Plik > Importuj projekt.
    2. Na komputerze z programem do tworzenia aplikacji odszukaj katalog, do którego został pobrany plik android-basic-samples. Wybierz plik android-basic-samples/build.gradle i kliknij OK.
  3. W module TypeANumber otwórz AndroidManifest.xml i zmień nazwę pakietu z com.google.example.games.tanc na inną nazwę. Nowa nazwa pakietu nie może zaczynać się od com.google, com.example ani com.android.

Krok 2. Skonfiguruj grę w Konsoli Google Play

W Konsoli Google Play możesz zarządzać usługami gier Google Play dotyczącymi swojej gry oraz konfigurować metadane służące do autoryzacji i uwierzytelniania gry.

Aby skonfigurować przykładową grę w Konsoli Google Play:

  1. Otwórz Konsolę Google Play w przeglądarce i zaloguj się. Jeśli nie masz jeszcze konta w Konsoli Google Play, pojawi się prośba o jego utworzenie.
  2. Aby dodać grę do Konsoli Google Play, postępuj zgodnie z tymi instrukcjami.
    1. Gdy pojawi się pytanie, czy w aplikacji używasz interfejsów API Google, wybierz Nie korzystam jeszcze w swojej grze z interfejsów API Google.
    2. W tym przewodniku dla deweloperów możesz wypełnić formularz, podając własne dane dotyczące gry. Dla wygody możesz użyć ikon i zrzutów ekranu udostępnionych na stronie Pobrane.
  3. Aby utworzyć identyfikator klienta OAuth 2.0 dla aplikacji na Androida, wykonaj te czynności:
    1. Podczas łączenia aplikacji na Androida podaj dokładnie tę samą nazwę pakietu, której użyłaś/używałeś podczas zmiany nazwy przykładowego pakietu.
    2. Jeśli nie masz jeszcze nowego repozytorium kluczy i podpisanego certyfikatu, możesz użyć kreatora wygenerowania podpisanego pliku APK w Android Studio. Aby dowiedzieć się, jak uruchomić kreatora generowania podpisanego pliku APK, przeczytaj artykuł Podpisywanie aplikacji w Android Studio.
  4. Zapisz te informacje na później:
    1. Identyfikator aplikacji: ciąg znaków składający się wyłącznie z cyfr (zazwyczaj co najmniej 12 cyfr) na początku identyfikatora klienta.
    2. Twój certyfikat podpisujący: zwróć uwagę, którego certyfikatu użyłeś podczas konfigurowania dostępu do interfejsu API (certyfikatu, którego odcisk cyfrowy SHA1 został podany). Podczas testowania i publikowania aplikacji należy używać tego samego certyfikatu do podpisywania aplikacji.
  5. Konfigurowanie osiągnięć w wyzwaniu „Wpisz numer”:
    1. W Konsoli Google Play wybierz kartę Osiągnięcia.
    2. Dodaj te przykładowe osiągnięcia:
      Nazwa Opis Instrukcje specjalne
      Prim Uzyskaj wynik, który jest liczbą pierwszą. Brak
      Skromność Poproś o wynik 0. Brak
      Nie bądź arogancki, dzieciaku. W dowolnym trybie poproś o wynik 9999. Brak
      OMG U R TEH UBER LEET! Otrzymaj wynik 1337. Ustaw to osiągnięcie jako ukryte.
      Znudzenie Zagraj w grę 10 razy. Ustaw to osiągnięcie jako wielostopniowe, w którym odblokowanie wymaga 10 kroków.
      Really Really Bored Zagraj w grę 100 razy. Ustaw to osiągnięcie jako wielostopniowe, z 100 krokami do odblokowania.
    3. Zanotuj identyfikatory (długie ciągi alfanumeryczne) każdego utworzonego osiągnięcia.
    4. Skonfiguruj osiągnięcia odpowiednie do Twojej gry. Więcej informacji znajdziesz w artykule Osiągnięcia – podstawy oraz Wdrażanie osiągnięć na Androida.
  6. Skonfiguruj tabele wyników dla wyzwania „Wpisz liczbę”:
    1. W Konsoli Google Play kliknij kartę Listy liderów.
    2. Dodaj 2 przykładowe tabele wyników: jedną o nazwie „Łatwe wysokie wyniki” i drugą o nazwie „Trudne wysokie wyniki”. Obie tabele powinny używać formatu wyników całkowitych z 0 miejscami po przecinku i typu sortowania Więcej punktów jest lepsze.
    3. Zanotuj identyfikatory (długie ciągi alfanumeryczne) każdej utworzonej przez siebie tablicy liderów.
    4. Skonfiguruj tabele wyników odpowiednie dla Twojej gry. Więcej informacji znajdziesz w artykułach Koncepcje stojące za tabelami wyników i Jak wdrożyć tabele wyników na Androidzie.
  7. Dodaj do gry konta testowe. Ten krok jest potrzebny tylko w przypadku aplikacji, które nie zostały jeszcze opublikowane w Konsoli Google Play. Zanim aplikacja zostanie opublikowana, logować się mogą tylko konta testowe wymienione w Konsoli Google Play. Jednak po opublikowaniu aplikacji każdy może się zalogować.

Krok 3. Zmień kod

Aby uruchomić grę, musisz skonfigurować identyfikator aplikacji jako zasób w projekcie Androida. Musisz też dodać metadane gier w pliku AndroidManifest.xml.

  1. Otwórz plik res/values/ids.xml i zastąp identyfikatory obiektów zastępczych. Jeśli tworzysz grę na Androida od podstaw, musisz najpierw utworzyć ten plik.
    1. Wpisz identyfikator aplikacji w zasobie app_id.
    2. W odpowiednim zasobie achievement_* określ identyfikator każdego wcześniej utworzonego osiągnięcia.
    3. Współczynniki wskaźnika wyników, które zostały utworzone wcześniej, należy określić w odpowiednich zasobach leaderboard_*.
  2. Otwórz plik AndroidManifest.xml i w atrybut package elementu <manifest> wpisz nazwę pakietu. Jeśli tworzysz grę na Androida od podstaw, pamiętaj też o dodaniu tego kodu w elemencie <application>: 
    <meta-data android:name="com.google.android.gms.games.APP_ID"
    android:value="@string/app_id" />
<meta-data android:name="com.google.android.gms.version"
   android:value="@integer/google_play_services_version"/>

Krok 4. Przetestuj grę

Aby mieć pewność, że Usługi Google Play Games działają prawidłowo w Twojej grze, przetestuj aplikację przed opublikowaniem jej w Google Play.

Aby uruchomić grę na fizycznym urządzeniu testowym:

  1. Sprawdź, czy masz skonfigurowane konto testowe, którego używasz do logowania się w aplikacji (jak opisano w kroku 2).
  2. Wyeksportuj plik APK i podpisz go tym samym certyfikatem, którego użyłeś/użyłaś do skonfigurowania projektu w Konsoli Google Play. Aby wyeksportować podpisany pakiet APK w Android Studio, kliknij Utwórz > Wygeneruj podpisany pakiet APK.
  3. Zainstaluj podpisany plik APK na fizycznym urządzeniu testowym za pomocą narzędzia adb. Aby dowiedzieć się, jak zainstalować aplikację, przeczytaj artykuł Uruchamianie na urządzeniu.