Google Play Oyun Hizmetleri ile Android oyun geliştirmeye hoş geldiniz.
Play Games SDK'sı, tablet ve mobil oyunlarınıza başarılar, skor tabloları ve kayıtlı oyunlar gibi popüler oyun özelliklerini kolayca entegre etmenizi sağlayan platformlar arası Google Play Games Hizmetleri sağlar.
Bu eğitim, Android için örnek bir oyun uygulaması yüklemenize ve kendi Android oyununuzu hızlı bir şekilde oluşturmaya başlamanıza rehberlik eder. "Sayı Yazma Yarışması" örnek uygulaması, başarıları ve lider tablolarını oyununuza nasıl entegre edebileceğinizi gösterir.
Başlamadan önce
Uygulamanızı hazırlamak için aşağıdaki bölümlerdeki adımları tamamlayın.
Uygulama ön koşulları
Uygulamanızın derleme dosyasında aşağıdaki değerlerin kullanıldığından emin olun:
19
veya daha yüksek birminSdkVersion
28
veya daha fazla öğedecompileSdkVersion
Oyununuzu Google Play Console'da ayarlama
Google Play Console, oyununuz için Google Play oyun hizmetlerini yönettiğiniz ve oyununuzu yetkilendirmek ve kimlik doğrulaması yapmak için meta verileri yapılandırdığınız yerdir. Daha fazla bilgi için Google Play Games Hizmetleri'ni kurma başlıklı makaleyi inceleyin.
Uygulamanızı yapılandırma
Proje düzeyindeki build.gradle
dosyanızda, Google'ın Maven deposunu ve Maven merkezi deposunu hem buildscript
hem de allprojects
bölümünüze ekleyin:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
Play Games SDK'sına ait Google Play Hizmetleri bağımlılığını, modülünüzün Gradle derleme dosyasına ekleyin. Bu dosya genellikle app/build.gradle
:
dependencies {
implementation 'com.google.android.gms:play-services-games:23.2.0'
}
Örnek uygulama kılavuzu
Bu eğitim, Android için örnek bir oyun uygulaması yüklemenize ve kendi Android oyununuzu hızlı bir şekilde oluşturmaya başlamanıza rehberlik eder. "Sayı Yazma Yarışması" örnek uygulaması, başarıları ve lider tablolarını oyununuza nasıl entegre edebileceğinizi gösterir.
1. adım: Örnek uygulamayı indirin
Bu geliştirici kılavuzu için Sayı Yazma yarışması örnek Android uygulamasını indirmeniz gerekir.
Android Studio'da örnek uygulamayı indirip ayarlamak için:
- Android örneklerini örnek indirme sayfasından indirin.
android-basic-samples
projesini içe aktarın. Bu projedeTypeANumber
ve diğer Android oyun örnekleri yer alıyor. Android Studio'da bunu yapmak için:- Dosya > Projeyi İçe Aktar'ı tıklayın.
- Geliştirme makinenizde
android-basic-samples
dosyasını indirdiğiniz dizine gidin. Dosyayıandroid-basic-samples/build.gradle
seçin ve Tamam'ı tıklayın.
TypeANumber
modülündeAndroidManifest.xml
'u açın vecom.google.example.games.tanc
olan paket adını kendi belirlediğiniz farklı bir paket adına değiştirin. Yeni paket adıcom.google
,com.example
veyacom.android
ile başlamamalıdır.
2. adım: Oyunu Google Play Console'da ayarlayın
Google Play Console, oyununuz için Google Play Oyun Hizmetleri'ni yönettiğiniz ve oyununuzu yetkilendirmek ve kimlik doğrulaması yapmak için meta verileri yapılandırdığınız yerdir.
Örnek oyunu Google Play Console'da ayarlamak için:
- Web tarayıcınızı Google Play Console'a yönlendirin ve oturum açın. Daha önce Google Play Console'a kaydolmadıysanız kaydolmanız istenir.
- Oyununuzu Google Play Console'a eklemek için aşağıdaki talimatları uygulayın.
- Uygulamanızda Google API'leri kullanıp kullanmadığınız sorulduğunda Oyunumda henüz Google API'si kullanmıyorum'u seçin.
- Bu geliştirici kılavuzu için formu kendi oyun ayrıntılarınızla doldurabilirsiniz. Kolaylık sağlamak için İndirilenler sayfasında bulunan yer tutucu simgeleri ve ekran görüntülerini kullanabilirsiniz.
- Android uygulamanız için OAuth 2.0 istemci kimliği oluşturmak üzere aşağıdaki talimatları uygulayın.
- Android uygulamanızı bağlarken, daha önce örnek paketi yeniden adlandırırken kullandığınız paket adını tam olarak belirttiğinizden emin olun.
- Henüz yoksa yeni bir anahtar mağazası ve imzalı sertifika oluşturmak için Android Studio'daki İmzalı APK Oluştur Sihirbazı'nı kullanabilirsiniz. İmzalı APK Oluşturma Sihirbazı'nı nasıl çalıştıracağınızı öğrenmek için Android Studio'da Uygulamanızı İmzalama başlıklı makaleyi inceleyin.
- Aşağıdaki bilgileri daha sonra kullanabileceğiniz için kaydetmeyi unutmayın:
- Uygulama kimliğiniz: İstemci kimliğinizin başında yer alan ve yalnızca rakamlardan (genellikle 12 veya daha fazla) oluşan bir dizedir.
- İmzalama sertifikanız: API erişiminizi ayarlarken hangi sertifikayı kullandığınızı (SHA1 parmak izini sağladığınız sertifika) not edin. Uygulamanızı test ederken veya yayınlarken uygulamanızı imzalamak için aynı sertifikayı kullanmanız gerekir.
- Sayı Yazma Yarışması için başarıları yapılandırın:
- Google Play Console'da Başarıları sekmesini seçin.
- Aşağıdaki örnek başarıları ekleyin:
Ad Açıklama Özel Talimatlar Prime Asal sayı olan bir puan alın. Yok Humble 0 puan isteğinde bulunun. Yok Kendine güvenme, çocuk Her iki modda da 9999 puan isteğinde bulunun. Yok OMG U R TEH UBER LEET! 1337 puan alırsınız. Bu başarıyı gizli hale getirin. Sıkılmış Oyunu 10 kez oynayın. Bu başarıyı, kilidini açmak için 10 adım içeren artımlı bir başarı haline getirin. Çok Sıkılmış Oyunu 100 kez oynayın. Bu başarıyı, kilidini açmak için 100 adım içeren artımlı bir başarı haline getirin. - Oluşturduğunuz her başarının kimliklerini (uzun alfanümerik dizeler) kaydedin.
- Oyununuza uygun başarıları yapılandırın. Daha fazla bilgi edinmek için başarıların temelindeki kavramlar ve Android'de başarıları uygulama başlıklı makaleleri inceleyin.
- Sayı Yazma Yarışması için skor tablolarını yapılandırın:
- Google Play Console'da Sıralama tabloları sekmesini seçin.
- İki örnek skor tablosu ekleyin: Biri "Kolay Yüksek Puanlar", diğeri "Zor Yüksek Puanlar". Her iki skor tablosunda da 0 ondalık basamak içeren tam sayı puan biçimlendirmesi ve Daha yüksek puanlar daha iyidir sıralama türü kullanılmalıdır.
- Oluşturduğunuz her lider tablosunun kimliklerini (uzun alfanümerik dizeler) kaydedin.
- Oyununuza uygun skor tabloları yapılandırın. Daha fazla bilgi edinmek için sıralama tablolarının temel kavramlarını ve Android'de skor tablolarını uygulama konusunu inceleyin.
- Oyununuz için test hesapları ekleyin. Bu adım yalnızca henüz Google Play Console'da yayınlanmamış uygulamalar için gereklidir. Uygulama yayınlanmadan önce yalnızca Google Play Console'da listelenen test hesapları giriş yapabilir. Ancak bir uygulama yayınlandıktan sonra herkes giriş yapabilir.
3. Adım: Kodunuzu değiştirin
Oyunu çalıştırmak için Android projenizde uygulama kimliğini bir kaynak olarak yapılandırmanız gerekir. Ayrıca AndroidManifest.xml
dosyasına oyun meta verilerini eklemeniz gerekir.
res/values/ids.xml
dosyasını açın ve yer tutucu kimliklerini değiştirin. Android oyununu sıfırdan oluşturuyorsanız önce bu dosyayı oluşturmanız gerekir.app_id
kaynağında uygulama kimliğinizi belirtin.- Daha önce oluşturduğunuz her başarı kimliğini ilgili
achievement_*
kaynağında belirtin. - Daha önce oluşturduğunuz her bir liderlik tablosu kimliğini ilgili
leaderboard_*
kaynağında belirtin.
AndroidManifest.xml
dosyasını açın ve <manifest
> öğesininpackage
özelliğine paket adınızı girin. Sıfırdan bir Android oyunu oluşturuyorsanız <application
> öğesine aşağıdaki kodu da eklediğinizden emin olun:<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"/>
4. Adım: Oyununuzu test edin
Google Play Games Hizmetleri'nin oyununuzda düzgün çalıştığından emin olmak için uygulamayı Google Play'de yayınlamadan önce test edin.
Oyununuzu fiziksel test cihazınızda çalıştırmak için:
- Uygulamaya giriş yapmak için kullandığınız test hesabını (2. adımda açıklandığı şekilde) oluşturduğunuzdan emin olun.
- Bir APK dışa aktarın ve Google Play Console'da projeyi oluşturmak için kullandığınız sertifikayla imzalayın. Android Studio'da imzalanmış bir APK'yı dışa aktarmak için Derle > İmzalanmış APK Oluştur'u tıklayın.
- İmzalı APK'yı
adb
aracını kullanarak fiziksel test cihazınıza yükleyin. Uygulamaları nasıl yükleyeceğinizi öğrenmek için Cihazlarda çalıştırma başlıklı makaleyi inceleyin.