Panduan memulai

Menyiapkan Android Game Development Extension di komputer Windows dan menjalankan contoh project Visual Studio C ++ di perangkat Android atau emulator.

Prasyarat

Ikuti langkah-langkah di bagian ini guna menyiapkan komputer Windows untuk menginstal ekstensi:

1. Download dan instal salah satu versi Visual Studio yang didukung:

   • Visual Studio 2017 Versi 15.4.0 (9 Oktober 2017) atau yang lebih tinggi.
   • Visual Studio 2019 Versi 16.0.0 atau yang lebih tinggi.
   • Visual Studio 2022 Versi 17.0.0 atau yang lebih tinggi.

2. Download dan instal .NET Core SDK 2.2.

3. Android Studio 3.5 atau yang lebih tinggi bersifat opsional, tetapi dapat digunakan sebagai pengganti Android Game Development Extension untuk menginstal Android SDK dan NDK.

4. Download dan instal JDK 17 untuk AGDE 23.1.82 atau yang lebih baru, atau JDK 11 hingga AGDE 22.2.71, dan tetapkan variabel lingkungan JAVA_HOME.

Menginstal ekstensi

Ikuti langkah-langkah di bagian ini untuk mendownload dan menginstal Android Game Development Extension.

1. Tutup semua instance Visual Studio.

2. Download penginstal ekstensi dan contoh terbaru dari halaman Download.

3. Dari lokasi download, klik dua kali penginstal. Penginstal memerlukan waktu beberapa menit untuk menyelesaikannya.

4. Jika memiliki lebih dari satu versi Visual Studio yang diinstal, pilih versi yang ekstensi-nya ingin Anda diinstal.

5. Klik Finish untuk menyelesaikan penginstalan.

Menginstal Android SDK dan NDK

Anda dapat menginstal Android SDK dan Native Development Kit (NDK) Android menggunakan Android Studio atau Android Game Development Extension Untuk menginstal SDK dan NDK dari ekstensi, gunakan SDK Manager, yang terletak di toolbar ekstensi Visual Studio.

Saat menginstal NDK, pastikan Anda menggunakan kotak centang NDK (Side by side) sehingga ekstensi dapat menemukannya. Anda harus menginstal versi NDK yang didukung oleh ekstensi (lihat histori revisi NDK):

Untuk menginstal SDK ke lokasi yang berbeda dengan lokasi default, tetapkan variabel lingkungan ANDROID_SDK_ROOT di komputer Anda:

1. Pastikan Visual Studio ditutup.
2. Di Penelurusan Windows, telusuri Environment Variables.
3. Pilih Edit the system environment variables.
4. Klik Environment Variables.
5. Di bagian User Variables, klik New.
6. Di kotak Variable Name, ketik ANDROID_SDK_ROOT.
7. Di kotak Variable Value, masukkan jalur ke Android SDK.
8. Reboot komputer.

Lokasi SDK tidak dapat diubah menggunakan jendela SDK Manager karena variabel lingkungan ini adalah satu-satunya sumber tepercaya untuk lokasi SDK.

Menjalankan contoh

Ikuti langkah-langkah di bagian ini untuk menjalankan contoh yang diberikan pada emulator, lalu di perangkat Android fisik.

Mengonfigurasi platform

1. Ekstrak file zip contoh ke direktori pilihan Anda. Contoh berikut disertakan:

   • endless-tunnel
   • HelloJNI
   • Teapot (menggunakan integrasi build Ninja eksperimental)

2. Mulai Visual Studio jika belum dijalankan.

3. Buka direktori contoh. Pilih File > Open > Project/Solution, lalu buka file .sln.

4. Pilih platform Android:

   1. Pilih Build > Configuration Manager.
   2. Di bagian Active solution platform, pilih Android-x86_64.

   Platform Android sudah dikonfigurasi dalam contoh (lihat menambahkan platform Android lainnya untuk menambahkan platform).

   Catatan: Image emulator umum menggunakan ABI x86 atau x86_64.

5. Pastikan properti Android SDK dan NDK project contoh telah dikonfigurasi:

   

   Gambar 1. Properti platform Android

   • Di Solution Explorer, klik kanan project, lalu pilih Properties.

   • Pilih tab properti General dan cari properti Platform untuk Android.

   Catatan: Pastikan Anda memilih NDK yang telah diinstal.

6. Pilih tab properti Android Packaging.

   

   Gambar 2. Properti paket Android

   Anda dapat mengubah nama dan direktori APK output dari tab ini. Perlu diketahui bahwa properti konfigurasi Android tertentu ditentukan di halaman properti dan diteruskan ke Gradle. Misalnya, properti nama APK MSBUILD_ANDROID_OUTPUT_APK_NAME meneruskan nama ini ke file build.gradle aplikasi.

Menyiapkan emulator

1. Mulai AVD Manager dari toolbar ekstensi di Visual Studio. Konfigurasikan perangkat virtual, lalu jalankan di emulator Android.

   1. Di Pengelola Perangkat Virtual Android, klik Create Virtual Device.
   2. Pilih definisi perangkat (misalnya, Pixel 2).
   3. Pilih image sistem. Anda harus memilih ABI x86_64 karena arsitektur ini berperforma lebih cepat di emulator.
   4. Verifikasi konfigurasi, lalu klik Finish.

2. Mulai perangkat virtual dengan mengklik tombol Run di Pengelola Perangkat Virtual Android.

3. Di Visual Studio, perangkat virtual akan muncul di samping tombol toolbar Start Debugging. Klik Start Debugging untuk meluncurkan aplikasi contoh di perangkat. Mungkin perlu waktu beberapa saat hingga debugger terpasang ke aplikasi. Jika menjalankan contoh Teapot, Anda dapat memutar teapot dengan menarik kursor mouse ke atasnya.

   
   Gambar 3. Sampel teapot yang berjalan di Android Emulator

Menyiapkan perangkat

1. Untuk menjalankan contoh di perangkat Android fisik, Anda mungkin perlu membuat platform Android baru dalam project. Platform ini harus cocok dengan arsitektur perangkat. Untuk membuat platform baru, lakukan hal berikut di Visual Studio:

   1. Pilih Build > Configuration Manager.
   2. Di bagian Active solution platform, pilih <New>.

   3. Ketik salah satu dari berikut ini untuk platform baru:

      • Android-armeabi-v7a
      • Android-arm64-v8a
      • Android-x86
      • Android-x86_64

   4. Di kotak Copy settings from, pilih platform Android lain yang ada (atau None jika Anda belum memiliki platform Android). Pastikan Anda telah mengaktifkan Create new project platform.

2. Hubungkan perangkat Android ke komputer menggunakan kabel USB. Jenis perangkat akan ditampilkan di samping tombol toolbar Start Debugging.

   
   Gambar 4. Perangkat Android yang terhubung ditampilkan di samping tombol toolbar Start Debugging

   Jika perangkat tidak ditampilkan, periksa hal berikut:

   • Pilihan platform cocok dengan ABI perangkat Anda.
   • Opsi developer dan proses debug USB diaktifkan di perangkat.
   • Kabel USB terhubung dari perangkat ke komputer.
   • Kabel USB mendukung koneksi data (dan bukan hanya daya).

3. Klik tombol toolbar Start Debugging untuk meluncurkan aplikasi contoh di perangkat. Diperlukan waktu beberapa saat hingga debugger terpasang ke aplikasi. Setelah terpasang, Anda dapat berinteraksi dengan aplikasi di perangkat.

FAQ

Berikut adalah beberapa pertanyaan umum tentang Android Game Development Extension.

Di mana lokasi log untuk plugin?

Anda dapat membuka file log untuk plugin menggunakan ikon Open Logs di toolbar Android Game Development Extension.

Variabel lingkungan apa yang digunakan plugin?

Plugin menggunakan variabel lingkungan berikut:

• ANDROID_SDK_ROOT
• ANDROID_SDK_HOME
• TEMP
• GOOGLE_ANDROID_LOG_DIR

Langkah berikutnya

Untuk menggunakan project Anda sendiri dengan ekstensi tersebut, Anda harus mengonfigurasinya sesuai dengan panduan konfigurasi project.