Selamat datang di pengembangan game Android dengan Layanan game Google Play!
SDK Play Game menyediakan Layanan game Google Play lintas platform yang memungkinkan Anda mengintegrasikan fitur-fitur game populer seperti pencapaian, papan peringkat, dan Game Tersimpan ke game tablet dan seluler dengan mudah.
Pelatihan ini akan memandu Anda menginstal contoh aplikasi game untuk Android, dan mulai membuat game Android Anda sendiri dengan cepat. Contoh aplikasi Type-a-Number Challenge menunjukkan cara mengintegrasikan fitur pencapaian dan papan peringkat ke dalam game.
Sebelum memulai
Untuk mempersiapkan aplikasi Anda, selesaikan langkah-langkah di bagian berikut ini.
Prasyarat aplikasi
Pastikan bahwa file build aplikasi Anda menggunakan nilai berikut:
minSdkVersion
dari19
yang lebih tinggicompileSdkVersion
dari28
atau yang lebih tinggi
Menyiapkan game Anda di Konsol Google Play
Konsol Google Play adalah tempat Anda mengelola layanan game Google Play untuk game, dan mengonfigurasi metadata untuk memberikan otorisasi dan mengautentikasi game. Untuk informasi selengkapnya, lihat Menyiapkan Layanan game Google Play.
Mengonfigurasi aplikasi Anda
Dalam file build.gradle
level project, sertakan
repositori Maven Google
dan repositori pusat Maven
di bagian buildscript
dan allprojects
:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
Tambahkan dependensi layanan Google Play untuk Play Game SDK ke
file build Gradle modul Anda, yang biasanya
app/build.gradle
:
dependencies {
implementation 'com.google.android.gms:play-services-games:23.2.0'
}
Panduan aplikasi contoh
Pelatihan ini akan memandu Anda menginstal contoh aplikasi game untuk Android, dan mulai membuat game Android Anda sendiri dengan cepat. Contoh aplikasi Type-a-Number Challenge menunjukkan cara mengintegrasikan fitur pencapaian dan papan peringkat ke dalam game.
Langkah 1: Download contoh aplikasi
Untuk panduan developer ini, Anda perlu mendownload contoh aplikasi Android Type-a-Number Challenge.
Untuk mendownload dan menyiapkan contoh aplikasi ini di Android Studio:
- Download contoh game Android dari halaman hasil download contoh.
- Impor project
android-basic-samples
. Project ini menyertakanTypeANumber
dan contoh game Android lainnya. Untuk melakukannya di Android Studio:- Klik File > Impor Project.
- Buka direktori tempat Anda mendownload
android-basic-samples
di mesin pengembangan Anda. Pilih fileandroid-basic-samples/build.gradle
, lalu klik OK.
- Dalam modul
TypeANumber
, bukaAndroidManifest.xml
dan ubah nama paket daricom.google.example.games.tanc
menjadi nama paket Anda sendiri. Nama paket yang baru tidak boleh diawali dengancom.google
,com.example
, ataucom.android
.
Langkah 2: Siapkan game di Konsol Google Play
Konsol Google Play adalah tempat Anda mengelola Layanan game Google Play untuk game Anda, dan mengonfigurasi metadata untuk memberikan otorisasi dan mengautentikasi game Anda.
Untuk menyiapkan contoh game di Konsol Google Play:
- Arahkan browser web Anda ke Konsol Google Play, lalu login. Jika belum pernah mendaftar untuk Konsol Google Play, Anda akan diminta untuk melakukannya.
- Ikuti petunjuk ini untuk
menambahkan game ke Konsol Google Play.
- Saat ditanya apakah Anda menggunakan Google API pada aplikasi Anda, pilih Saya belum menggunakan Google API apa pun dalam game saya.
- Untuk keperluan panduan developer ini, Anda dapat mengisi formulir ini dengan detail game Anda sendiri. Untuk memudahkan, Anda dapat menggunakan ikon placeholder dan screenshot yang disediakan di halaman Hasil download.
- Ikuti petunjuk ini untuk
membuat client ID OAuth 2.0
untuk aplikasi Android Anda.
- Saat menautkan aplikasi Android, pastikan untuk menentukan nama paket yang sama persis dengan yang Anda gunakan sebelumnya saat mengganti nama paket contoh.
- Anda dapat menggunakan Wizard Membuat APK Bertanda Tangan di Android Studio untuk membuat keystore baru dan sertifikat bertanda tangan, jika Anda belum memilikinya. Untuk mempelajari cara menjalankan Wizard Membuat APK Bertanda Tangan, lihat Menandatangani Aplikasi di Android Studio.
- Pastikan untuk mencatat informasi berikut untuk digunakan nanti:
- ID aplikasi Anda: Ini adalah string yang hanya terdiri dari angka (biasanya 12 digit atau lebih), di awal client ID Anda.
- Sertifikat penandatanganan: Catat sertifikat yang Anda gunakan saat menyiapkan akses API (sertifikat yang sidik jari SHA1-nya Anda sediakan). Anda harus menggunakan sertifikat yang sama untuk menandatangani aplikasi saat menguji atau merilis aplikasi.
- Konfigurasi pencapaian untuk Type-a-Number Challenge:
- Pilih tab Pencapaian di Konsol Google Play.
- Tambahkan contoh pencapaian berikut:
Nama Deskripsi Petunjuk Khusus Prime Mendapatkan skor yang berupa bilangan prima. None Humble Meminta skor 0. None Don't get cocky, kid Meminta skor 9999 dalam mode mana pun. None OMG U R TEH UBER LEET! Menerima skor 1337. Jadikan ini pencapaian tersembunyi. Bored Memainkan game 10 kali. Jadikan ini sebagai pencapaian tambahan dengan 10 langkah untuk membuka kunci. Really Really Bored Memainkan game 100 kali. Jadikan ini sebagai pencapaian tambahan dengan 100 langkah untuk membuka kunci. - Catat ID (string alfanumerik panjang) untuk setiap pencapaian yang Anda buat.
- Konfigurasi pencapaian yang sesuai untuk game Anda. Untuk mempelajari lebih lanjut, lihat konsep di balik pencapaian dan cara menerapkan pencapaian di Android.
- Konfigurasi papan peringkat untuk Type-a-Number Challenge:
- Pilih tab Papan peringkat di Konsol Google Play.
- Tambahkan dua contoh papan peringkat: satu dengan nama “Skor Tinggi Mudah” dan satu lagi dengan nama “Skor Tinggi Sulit”. Keduanya harus menggunakan pemformatan skor Bilangan Bulat dengan 0 angka di belakang koma, dan jenis pengurutan Lebih besar lebih baik.
- Catat ID (string alfanumerik panjang) untuk setiap papan peringkat yang Anda buat.
- Konfigurasi papan peringkat yang sesuai untuk game Anda. Untuk mempelajari lebih lanjut, lihat konsep di balik papan peringkat dan cara menerapkan papan peringkat di Android.
- Tambahkan akun uji untuk game Anda. Langkah ini diperlukan hanya untuk aplikasi yang belum dipublikasikan di Konsol Google Play. Sebelum aplikasi dipublikasikan, hanya akun uji yang terdaftar di Konsol Google Play yang dapat login. Namun, setelah dipublikasikan, semua orang diizinkan untuk login.
Langkah 3: Ubah kode Anda
Untuk menjalankan game, Anda harus mengonfigurasi ID aplikasi sebagai resource dalam project Android. Anda juga harus menambahkan metadata game di AndroidManifest.xml
.
- Buka
res/values/ids.xml
dan ganti ID placeholder. Jika membuat game Android dari awal, Anda harus membuat file ini terlebih dahulu.- Tentukan ID aplikasi Anda di resource
app_id
. - Tentukan setiap ID pencapaian yang Anda buat sebelumnya di resource
achievement_*
yang sesuai. - Tentukan setiap ID papan peringkat yang Anda buat sebelumnya pada resource
leaderboard_*
yang sesuai.
- Tentukan ID aplikasi Anda di resource
- Buka
AndroidManifest.xml
dan masukkan nama paket Anda dalam atributpackage
elemen <manifest
>. Jika membuat game Android dari awal, pastikan Anda juga menambahkan kode berikut di dalam elemen <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"/>
Langkah 4: Uji game Anda
Untuk memastikan Layanan game Google Play berfungsi dengan benar dalam game Anda, uji aplikasi sebelum memublikasikannya di Google Play.
Untuk menjalankan game Anda di perangkat uji fisik:
- Pastikan Anda telah menyiapkan akun uji yang akan digunakan untuk login ke aplikasi (seperti yang dijelaskan pada Langkah 2).
- Ekspor APK dan tanda tangani dengan sertifikat yang sama yang Anda gunakan untuk menyiapkan project di Konsol Google Play. Untuk mengekspor APK bertanda tangan di Android Studio, klik Build > Buat APK Bertanda Tangan.
- Instal APK yang ditandatangani di perangkat pengujian fisik menggunakan alat
adb
. Untuk mempelajari cara menginstal aplikasi, lihat Menjalankan di Perangkat.