Pierwsze kroki z usługami gier Play na Androida

Witamy w tworzeniu gier na Androida dzięki usługom gier Google Play.

Pakiet SDK Gier Play zapewnia wiele platform Google Play dla gier, dzięki którym możesz łatwo integrować popularne funkcje gier, takie jak osiągnięcia, tabele wyników zapisane gry na tablecie i w grach mobilnych;

Z tego szkolenia dowiesz się, jak zainstalować przykładową grę na Androida możesz szybko zacząć tworzyć własną grę na Androida. Typ liczby Przykładowa aplikacja z wyzwaniem pokazuje, jak łączyć osiągnięcia tablice wyników w grze.

Zanim zaczniesz

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

Wymagania wstępne aplikacji

Upewnij się, że plik kompilacji aplikacji zawiera te wartości:

  • minSdkVersion z 19 większego
  • wartość compileSdkVersion wynosząca co najmniej 28,

Skonfiguruj grę w Konsoli Google Play

Konsola Google Play to miejsce, w którym zarządzasz Usługami gier Google Play na swoim gry oraz skonfigurować metadane do autoryzacji i uwierzytelniania gry. Dla: więcej informacji znajdziesz w Konfigurowanie usług gier Google Play

Konfiguracja aplikacji

W pliku build.gradle na poziomie projektu umieść Repozytorium Google Maven 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 Gier Play do pliku build.gradle modułu, który jest często app/build.gradle:

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

Przykładowy przewodnik po aplikacjach

Z tego szkolenia dowiesz się, jak zainstalować przykładową grę na Androida możesz szybko zacząć tworzyć własną grę na Androida. Typ liczby Przykładowa aplikacja z wyzwaniem pokazuje, jak łączyć osiągnięcia tablice wyników w grze.

Krok 1. Pobierz przykładową aplikację

Aby zapoznać się z tym przewodnikiem dla programistów, musisz pobrać próbkę wyzwania typu „Type-a-Number”. Aplikacja na Androida.

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

  1. Pobierz przykłady na Androida ze stronie pobierania przykładów.
  2. Zaimportuj projekt android-basic-samples. Ten projekt obejmuje grę TypeANumber i inną grę na Androida przykłady. Aby to zrobić w Android Studio:
    1. Kliknij Plik > Importuj projekt.
    2. Przejdź do katalogu, do którego został pobrany android-basic-samples na komputerze. 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ę pakietu. Nowa nazwa pakietu musi nie zaczyna się od com.google, com.example ani com.android.

Krok 2. Skonfiguruj grę w Konsoli Google Play

Konsola Google Play to miejsce, w którym zarządzasz usługami gier Google Play dotyczącymi Twojej gry. skonfigurować metadane do autoryzacji i uwierzytelniania gry.

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

  1. Otwórz w przeglądarce stronę Konsoli Google Play; zaloguj się. Jeśli nie masz jeszcze rejestracji w Konsoli Google Play, pojawi się prośba, by to zrobić.
  2. Wykonaj te instrukcje, aby dodaj grę do Konsoli Google Play.
    1. Gdy pojawi się pytanie, czy w swojej aplikacji korzystasz z interfejsów API Google, wybierz Nie używam jeszcze żadnych interfejsów API Google w mojej grze.
    2. Na potrzeby tego przewodnika dla programistów możesz wypełnić formularz własnymi szczegóły gry. Dla wygody możesz użyć ikon zastępczych i zrzutów ekranu dostępne na stronie Pobrane.
  3. Wykonaj te instrukcje, aby wygeneruj identyfikator klienta OAuth 2.0 dla aplikacji na Androida.
    1. Podczas łączenia aplikacji na Androida upewnij się, że dokładnie określono pakiet nazwa użyta wcześniej przy zmianie nazwy pakietu przykładowego.
    2. Możesz użyć kreatora generowania podpisanego pliku APK w Android Studio, aby wygeneruj nowy magazyn kluczy i podpisany certyfikat, jeśli jeszcze ich nie masz. Aby dowiedzieć się, jak: uruchomić kreator generowania podpisanego pliku APK, zapoznaj się z Podpisywanie aplikacji w Android Studio.
  4. Zapisz te informacje na później:
    1. Identyfikator aplikacji: to jest ciąg znaków. składające się tylko z cyfr (zwykle 12 lub więcej) na początku identyfikatora klienta.
    2. Twój certyfikat podpisywania: zapisz, który certyfikat został użyty podczas konfigurowania dostęp do interfejsu API (certyfikat, którego odcisk cyfrowy SHA1 został podany). Ty powinna używać tego samego certyfikatu do podpisywania aplikacji podczas testowania lub publikowania aplikacji.
  5. Konfigurowanie osiągnięć w wyzwaniu typu-a-number
    1. W Konsoli Google Play wybierz kartę Osiągnięcia.
    2. Dodaj te przykładowe osiągnięcia:
      Nazwa Opis Specjalne instrukcje
      Prim Uzyskaj wynik, który jest liczbą pierwszą. Brak
      Humble Poproś o wynik 0. Brak
      Nie rób się, dzieciaku Poproś o wynik 9999 w obu trybach. Brak
      O JO LET! Wynik 1337. Niech to będzie ukryte osiągnięcie.
      Nudny Zagrać w grę 10 razy. Niech to będzie osiągnięcie stopniowe – trzeba będzie jeszcze wykonać 10 kroków.
      Bardzo się nudzi zagrać w grę 100 razy; Niech to będzie osiągnięcie stopniowe. Musisz zdobyć jeszcze 100 kroków.
    3. Zapisuj identyfikatory (długie ciągi alfanumeryczne) każdego osiągnięcia, Utworzono.
    4. Skonfiguruj osiągnięcia odpowiednie dla Twojej gry. Aby dowiedzieć się więcej, zobacz pojęcia związane z osiągnięciami oraz jak implementować osiągnięcia na Androidzie.
  6. Skonfiguruj tabele wyników w wyzwaniu typu „Type-a-Number”:
    1. Wybierz kartę Tabele wyników w Konsoli Google Play.
    2. Dodaj 2 przykładowe tabele wyników: jedną o nazwie „Łatwe wyniki” i drugą pod nazwą „Hard High Scores”. W obu tabelach wyników należy użyć formatu liczby całkowitej z 0 miejsc po przecinku i typem kolejności Większe, tym lepsze.
    3. Zanotuj identyfikatory (długie ciągi alfanumeryczne) każdej utworzonej tabeli wyników.
    4. Skonfiguruj tabele wyników odpowiednie dla Twojej gry. Aby dowiedzieć się więcej, zapoznaj się z pojęciami stojącymi za tablicami wyników oraz jak zaimplementować tabele wyników na Androidzie.
  7. Dodaj konta testowe gry. Ten krok jest wymagany tylko w przypadku aplikacji, które nie zostały jeszcze opublikowane w w Konsoli Google Play. Przed opublikowaniem aplikacji widoczne są tylko wymienione konta testowe w Konsoli Google Play. Jednak po opublikowaniu aplikacji każdy może się zalogować.

Krok 3. Zmodyfikuj kod

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

  1. Otwórz plik res/values/ids.xml i zastąp identyfikatory zastępcze. Jeśli jesteś podczas tworzenia gry na Androida od podstaw, musisz najpierw utworzyć ten plik.
    1. Podaj identyfikator aplikacji w zasobie app_id.
    2. Podaj każdy utworzony wcześniej identyfikator osiągnięcia w odpowiednim polu achievement_* zasób.
    3. Podaj każdy utworzony wcześniej identyfikator tabeli wyników w odpowiednich leaderboard_* zasób.
  2. Otwórz aplikację AndroidManifest.xml i wpisz nazwę pakietu w polu package. atrybutu <manifest> . Jeśli tworzysz grę na Androida na podstawie pamiętaj, aby dodać ten kod również do tagu <application> element: 
    <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 upewnić się, że Usługi gier Google Play w grze działają prawidłowo, przetestuj 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 do aplikacji (jak opisano w kroku 2).
  2. Wyeksportuj plik APK i podpisz go tym samym certyfikatem, który został użyty do skonfigurowania projekt w Konsoli Google Play. Aby wyeksportować podpisany pakiet APK w Android Studio, kliknij Kompilacja > 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ę, zobacz Działanie na urządzeniu.