Hızlı Başlangıç

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

Ön koşullar

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

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 Sürüm 16.0.0 veya sonraki sürümler.
   • Visual Studio 2022 Sürüm 17.0.0 veya üzeri.

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 Oyun Geliştirme Uzantısı yerine kullanılabilir.

4. AGDE 23.1.82 veya daha yeni sürümleri için JDK 17'yi ya da 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ükle

Android Oyun Geliştirme Uzantısı'nı indirip yüklemek için bu bölümdeki adımları izleyin:

1. Tüm Visual Studio örneklerini kapatın.

2. İndirilenler sayfasından en yeni uzantı yükleyiciyi ve örnekleri indirin.

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

4. Birden fazla Visual Studio 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'sını ve NDK'yı yükleme

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

NDK'yı yüklerken, uzantının konumunu bulabilmesi için NDK (Yan yana) onay kutusunu kullandığınızdan emin olun. Uzantı tarafından desteklenen bir NDK sürümü yüklemeniz gerekir (NDK düzeltme geçmişi sayfasına bakın).

SDK'yı varsayılandan 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 araması yapın.
3. Sistem ortam değişkenlerini düzenleyin'i seçin.
4. Ortam Değişkenleri'ni tıklayın.
5. Kullanıcı Değişkenleri altında 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 konumu için tek doğru kaynak olduğundan SDK'nın konumu SDK Yöneticisi penceresi kullanılarak değiştirilemez.

Örneği çalıştır

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

Platformu yapılandırma

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

   • sonsuz-tünel
   • HelloJNI
   • Çaydanlık (deneysel Ninja derleme entegrasyonunu kullanır)

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 (Derleme) > Configuration Manager (Yapılandırma Yöneticisi) seçeneğini belirleyin.
   2. Etkin çözüm platformu bölümünde Android-x86_64'ü seçin.

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

5. Örnek projede Android SDK ve NDK özelliklerinin yapılandırılmış olduğundan 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 Paketleme özellikleri sekmesini seçin.

   

   Çıkış APK'sının adını ve dizinini bu sekmeden değiştirebilirsiniz. Android yapılandırma özelliklerinden bazıları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. Visual Studio'daki uzantı araç çubuğundan AVD Manager'ı başlatın. Bir sanal cihazı yapılandırın ve ardından Android emülatörde çalıştırın.

   1. Android Sanal Cihaz Yöneticisi'nde, Sanal Cihaz Oluştur'u 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ı performans gösterdiği için x86_64 ABI seçmelisiniz.
   4. Yapılandırmayı doğrulayın ve Son'u tıklayın.

2. Android Sanal Cihaz Yöneticisi'ndeki Çalıştır düğmesini tıklayarak sanal cihazı başlatın.

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

   
   Şekil 3. Android emülatörde ç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 (Derleme) > Configuration Manager (Yapılandırma Yöneticisi) seçeneğini belirleyin.
   2. Etkin çözüm platformu bölümünde <Yeni> seçeneğini belirleyin.

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

      • Android-armeabi-v7a
      • Android-arm64-v8a
      • Android x 86
      • Android-x86_64

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

2. Android cihazı USB kablosuyla 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österiliyor

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

   • Platform seçimi cihazınızın ABI'siyle eşleşir.
   • Geliştirici seçenekleri ve USB üzerinden hata ayıklama cihazda etkin olmalıdır.
   • USB kablosu cihazdan bilgisayara bağlandı.
   • USB kablosu veri bağlantısını destekler (yalnızca gücü değil).

3. Cihazda örnek uygulamayı başlatmak için Hata Ayıklamayı Başlat araç çubuğu düğmesini tıklayın. Hata ayıklayıcının uygulamaya eklenmesi birkaç dakika sürebilir. Ekledikten sonra cihazınızdaki uygulamayla etkileşimde bulunabilirsiniz.

SSS

Android Oyun Geliştirme Uzantısı ile ilgili sık sorulan bazı soruları aşağıda bulabilirsiniz.

Eklentinin günlükleri nerede bulunur?

Android Game Development Extension araç çubuğundaki Open Logging (Günlükleri Aç) simgesini kullanarak eklentinin günlük dosyasını 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?

Kendi projenizi uzantıyla kullanmak için uzantıyı proje yapılandırma kılavuzuna göre yapılandırmanız gerekir.