Hızlı Başlangıç

Android Game Development Extension'ı Windows bilgisayara kurun ve bir Android cihazda veya emülatörde örnek bir Visual Studio C++ projesi çalıştırın.

Ön koşullar

Windows bilgisayarınızı uzantının yüklenmesine hazırlamak için bu bölümdeki adımları uygulayın:

1. Visual Studio'nun desteklenen sürümlerinden birini indirip yükleyin:

   • Visual Studio 2017 Sürüm 15.4.0 (9 Ekim 2017) veya sonraki sürümler.
   • Visual Studio 2019 16.0.0 veya sonraki bir sürüm.
   • Visual Studio 2022 17.0.0 veya sonraki bir sürüm.

2. .NET Core SDK 2.2'yi indirip yükleyin.

3. Android Studio 3.5 veya sonraki sürümler isteğe bağlıdır ancak Android SDK ve NDK'yı yüklemek için Android Game Development Extension yerine kullanılabilir.

4. AGDE 23.1.82 veya daha yeni sürümler için JDK 17'yi, AGDE 22.2.71'e kadar olan sürümler için JDK 11'i indirip yükleyin ve JAVA_HOME ortam değişkeninizi ayarlayın.

Uzantıyı yükleme

Android Game Development Extension'ı indirip yüklemek için bu bölümdeki adımları uygulayın:

1. Visual Studio'nun tüm örneklerini kapatın.

2. En son uzantı yükleyiciyi ve örnekleri İndirilenler sayfasından indirin.

3. İndirme konumunuzda yükleyiciyi çift tıklayın. Yükleyicinin tamamlanması birkaç dakika sürer.

4. Visual Studio'nun birden fazla sürümü yüklüyse uzantının yüklenmesini istediğiniz sürümleri seçin.

5. Yükleme işlemini tamamlamak için Bitir'i tıklayın.

Android SDK ve NDK'yı yükleme

Android SDK'yı ve Android Native Development Kit'i (NDK) Android Studio veya Android Game Development Extension ile yükleyebilirsiniz. SDK ve NDK'yı uzantıdan yüklemek için Visual Studio'nun uzantı araç çubuğunda bulunan SDK Yöneticisi'ni kullanın.

NDK'yı yüklerken uzantının NDK'yı bulabilmesi için NDK (Yan yana) onay kutusunu işaretlediğinizden emin olun. Uzantı tarafından desteklenen bir NDK sürümü yüklemeniz gerekir (NDK revizyon geçmişi başlıklı makaleyi inceleyin).

SDK'yı varsayılan konumdan farklı bir konuma yüklemek için bilgisayarınızda ANDROID_SDK_ROOT ortam değişkenini ayarlayın:

1. Visual Studio'nun kapalı olduğundan emin olun.
2. Windows Arama'da Environment Variables ifadesini arayın.
3. Sistem ortamı değişkenlerini düzenle'yi seçin.
4. Ortam Değişkenleri'ni tıklayın.
5. Kullanıcı Değişkenleri bölümünde Yeni'yi tıklayın.
6. Değişken Adı kutusuna ANDROID_SDK_ROOT yazın.
7. Değişken Değeri kutusuna Android SDK'nın yolunu girin.
8. Bilgisayarınızı yeniden başlatın.

Bu ortam değişkeni, SDK konumunun tek doğru kaynağı olduğundan SDK'nın konumu SDK Yöneticisi penceresi kullanılarak değiştirilemez.

Örneği çalıştırma

Sağlanan bir örneği emülatörde ve ardından fiziksel bir Android cihazda çalıştırmak için bu bölümdeki adımları uygulayın.

Platformu yapılandırma

1. Örnekler zip dosyasını istediğiniz bir dizine açın. Aşağıdaki örnekler dahildir:

   • endless-tunnel
   • HelloJNI
   • Demlik

2. Henüz çalışmıyorsa Visual Studio'yu başlatın.

3. Örnekler dizinini açın. Dosya > Aç > Proje/Çözüm'ü seçin ve .sln dosyasına gidin.

4. Bir Android platformu seçin:

   1. Build > Configuration Manager'ı (Oluştur > Yapılandırma Yöneticisi) seçin.
   2. Etkin çözüm platformu bölümünde Android-x86_64'ü seçin.

   Android platformları örneklerde önceden yapılandırılmıştır (platform eklemek için daha fazla Android platformu ekleme bölümüne bakın).

5. Örnek projenin Android SDK ve NDK özelliklerinin yapılandırıldığından emin olun:

   

   • Çözüm Gezgini'nde projeyi sağ tıklayın ve Özellikler'i seçin.

   • Genel özellikler sekmesini seçin ve Android için Platform özelliklerini bulun.

6. Android Packaging (Android Paketleme) özellikler sekmesini seçin.

   

   Bu sekmeden çıkış APK'sının adını ve dizinini değiştirebilirsiniz. Android yapılandırma özelliklerinin bir kısmının özellik sayfalarında tanımlandığını ve Gradle'a iletildiğini unutmayın. Örneğin, APK adı özelliği MSBUILD_ANDROID_OUTPUT_APK_NAME bu adı uygulama build.gradle dosyasına iletir.

Emülatörü ayarlama

1. AVD Manager'ı Visual Studio'daki uzantı araç çubuğundan başlatın. Sanal cihazı yapılandırın ve Android emülatöründe çalıştırın.

   1. Android Virtual Device Manager'da Create Virtual Device'ı (Sanal Cihaz Oluştur) tıklayın.
   2. Bir cihaz tanımı seçin (örneğin, Pixel 2).
   3. Bir sistem görüntüsü seçin. Bu mimari, emülatörde daha hızlı çalıştığı için x86_64 ABI'yi seçmelisiniz.
   4. Yapılandırmayı doğrulayın ve Son'u tıklayın.

2. Android Virtual Device Manager'da Run (Çalıştır) düğmesini tıklayarak sanal cihazı başlatın.

3. Visual Studio'da sanal cihaz, Hata Ayıklamayı Başlat araç çubuğu düğmesinin yanında görünmelidir. Örnek uygulamayı cihazda başlatmak için Hata Ayıklamayı Başlat'ı tıklayın. Hata ayıklayıcının uygulamaya bağlanması birkaç dakika sürebilir. Teapot örneğini çalıştırıyorsanız fare imlecinizi sürükleyerek çaydanlığı döndürebilirsiniz.

   
   Şekil 3. Android emülatöründe çalışan çaydanlık örneği

Cihazı kurma

1. Örneği fiziksel bir Android cihazda çalıştırmak için projede yeni bir Android platformu oluşturmanız gerekebilir. Bu platform, cihazın mimarisiyle eşleşmelidir. Yeni bir platform oluşturmak için Visual Studio'da aşağıdakileri yapın:

   1. Build > Configuration Manager'ı (Oluştur > Yapılandırma Yöneticisi) seçin.
   2. Etkin çözüm platformu bölümünde <Yeni>'yi seçin.

   3. Yeni platform için aşağıdakilerden birini yazın:

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

   4. Ayarları kopyala kutusunda, mevcut başka bir Android platformunu (henüz Android platformunuz yoksa Yok'u) seçin. Yeni proje platformları oluştur'u etkinleştirdiğinizden emin olun.

2. USB kablosu kullanarak bir Android cihazı bilgisayarınıza bağlayın. Cihaz türü, Hata Ayıklamayı Başlat araç çubuğu düğmesinin yanında gösterilmelidir.

   
   Şekil 4. Bağlı Android cihaz, Hata Ayıklamayı Başlat araç çubuğu düğmesinin yanında gösterilir.

   Cihaz gösterilmiyorsa aşağıdakileri kontrol edin:

   • Platform seçimi, cihazınızın ABI'siyle eşleşmelidir.
   • Cihazda geliştirici seçenekleri ve USB üzerinden hata ayıklama etkin olmalıdır.
   • USB kablosu cihazdan bilgisayara bağlı olmalıdır.
   • USB kablosu, veri bağlantısını (yalnızca güç bağlantısını değil) destekliyor olmalıdır.

3. Örnek uygulamayı cihazda başlatmak için Hata Ayıklamayı Başlat araç çubuğu düğmesini tıklayın. Hata ayıklayıcının uygulamaya bağlanması birkaç dakika sürebilir. Bağlandıktan sonra cihazınızda uygulamayla etkileşimde bulunabilirsiniz.

SSS

Android Game Development Extension hakkında sık sorulan bazı soruları aşağıda bulabilirsiniz.

Eklentinin günlükleri nerede bulunur?

Eklentinin günlük dosyasını, Android Game Development Extension araç çubuğundaki Open Logs (Günlükleri Aç) simgesini kullanarak açabilirsiniz.

Eklenti hangi ortam değişkenlerini kullanır?

Eklenti aşağıdaki ortam değişkenlerini kullanır:

• ANDROID_SDK_ROOT
• ANDROID_SDK_HOME
• TEMP
• GOOGLE_ANDROID_LOG_DIR

Sırada ne var?

Uzantıyla kendi projenizi kullanmak için projenizi proje yapılandırması kılavuzuna göre yapılandırmanız gerekir.