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:
Visual Studio'nun desteklenen sürümlerinden birini indirip yükleyin:
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.
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:
Tüm Visual Studio örneklerini kapatın.
İndirilenler sayfasından en yeni uzantı yükleyiciyi ve örnekleri indirin.
İndirme konumunuzdan yükleyiciyi çift tıklayın. Yükleyicinin tamamlanması birkaç dakika sürer.
Birden fazla Visual Studio sürümü yüklüyse uzantının yüklenmesini istediğiniz sürümleri seçin.
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:
- Visual Studio'nun kapalı olduğundan emin olun.
- Windows Arama'da
Environment Variables
araması yapın. - Sistem ortam değişkenlerini düzenleyin'i seçin.
- Ortam Değişkenleri'ni tıklayın.
- Kullanıcı Değişkenleri altında Yeni'yi tıklayın.
- Değişken Adı kutusuna
ANDROID_SDK_ROOT
yazın. - Değişken Değeri kutusuna, Android SDK'nın yolunu girin.
- 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
Ö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)
Henüz çalışmıyorsa Visual Studio'yu başlatın.
Örnekler dizinini açın. Dosya > Aç > Proje/Çözüm'ü seçin ve
.sln
dosyasına gidin.Bir Android platformu seçin:
- Build (Derleme) > Configuration Manager (Yapılandırma Yöneticisi) seçeneğini belirleyin.
- 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).
Örnek projede Android SDK ve NDK özelliklerinin yapılandırılmış olduğundan emin olun:
Şekil 1. Android platformu özellikleri Çö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.
Android Paketleme özellikleri sekmesini seçin.
Şekil 2. Android paketleme özellikleri Çı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ı uygulamabuild.gradle
dosyasına iletir.
Emülatörü ayarlama
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.
- Android Sanal Cihaz Yöneticisi'nde, Sanal Cihaz Oluştur'u tıklayın.
- Bir cihaz tanımı seçin (örneğin, Pixel 2).
- 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.
- Yapılandırmayı doğrulayın ve Son'u tıklayın.
Android Sanal Cihaz Yöneticisi'ndeki Çalıştır düğmesini tıklayarak sanal cihazı başlatın.
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
Ö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:
- Build (Derleme) > Configuration Manager (Yapılandırma Yöneticisi) seçeneğini belirleyin.
- Etkin çözüm platformu bölümünde <Yeni> seçeneğini belirleyin.
Yeni platform için aşağıdakilerden birini yazın:
- Android-armeabi-v7a
- Android-arm64-v8a
- Android x 86
- Android-x86_64
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.
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österiliyorCihaz 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).
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.