Android Studio için build.gradle dosyalarını değiştirme

Bu kılavuzda, Android Studio'da açabilmeniz için AGDE projelerinden build.gradle dosyalarının nasıl değiştirileceği açıklanmaktadır. Ağırlıklı olarak AGDE projelerini yöneten yapı mühendisleri için tasarlanmıştır.

Bu kılavuzdaki değişikliklerden sonra şunları yapabileceksiniz:

  • Komut satırından ve Android Studio'dan Gradle ile geliştirme yapın.
  • Çoklu ABI APK'ları ve App Bundle'ları oluşturun.
  • Kaynakları Android Studio'da tam dil hizmeti desteğiyle (ilgili tanım vb.) düzenleyin.
  • Yerel ve karma işlemlerde hata ayıklamak için Android Studio hata ayıklayıcılarını kullanın.

Bu AGDE özelliği, derleme sistemi olarak Ninja'yı destekleyen deneysel Android Gradle eklentisi özelliği üzerine inşa edilmiştir.

Proje düzeyindeki build.gradle dosyasını değiştirme

Android Gradle eklentisi 7.3.0-alpha02 veya sonraki bir sürümü referans almak için proje düzeyi build.gradle değerini değiştirin. Örneğin:

buildscript {
    repositories {
       google()
       mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.3.0-alpha02'
    }
}

Bu değişiklikten sonra da projenizi Visual Studio'da oluşturabilirsiniz. Aşağıdaki değişiklikleri yapmadan önce hata ayıklama işlemi daha kolay olacağından bunu hemen denemenizi öneririz.

Run-msbuild.bat'ı projenize kopyalayın

AGDE'nin en yeni sürümleriyle birlikte gönderilen Teapot örneğinde run-msbuild.bat adlı bir komut dosyası bulunur. Bu komut dosyası AGP'den çağrılır ve MSBuild'in yerini bulup çağırmaktan sorumludur.

run-msbuild.bat dosyasını, uygulama düzeyindeki build.gradle dosyasını içeren klasöre kopyalayın.

Uygulama düzeyindeki build.gradle dosyasını değiştirin

Bu adımın ana hedefleri, run-msbuild.bat çağrısını yapılandırmak ve MSBUILD_* değişkenine yönelik referansları kaldırmaktır.

ndkVersion'ı ayarlayın

ndkVersion dosyasını belirli bir NDK sürümüyle değiştirin. Örneğin:

  android {
      ndkVersion "22.1.7171670"
  }

minSdkVersion'ı ayarlama

minSdkVersion öğesini belirli bir minimum SDK sürümüyle değiştirin. Örneğin:

  android {
      defaultConfig {
          minSdkVersion 30
      }
  }

run-msbuild.bat komutunu çağırma

  1. Projenin çözüm dosyasında run-msbuild.bat yöntemini çağırmak için bir bölüm ekleyin.

       android {
           defaultConfig {
               externalNativeBuild {
                   experimentalProperties["ninja.abiFilters"] = [ "x86", "arm64-v8a" ]
                   experimentalProperties["ninja.path"] = "Teapot.sln"
                   experimentalProperties["ninja.configure"] = "run-msbuild"
                   experimentalProperties["ninja.arguments"] = [
                           "\${ndk.moduleMakeFile}",
                           "-p:Configuration=\${ndk.variantName}",
                           "-p:Platform=Android-\${ndk.abi}",
                           "-p:NinjaBuildLocation=\${ndk.buildRoot}",
                           "-p:NinjaProject=GameApplication",
                           "-p:RequireAndroidNdkVersion=\${ndk.moduleNdkVersion}",
                           "-p:RequireMinSdkVersion=\${ndk.minPlatform}",
                           "-t:GenerateBuildNinja"
                    ]
               }
           }
       }
    
  2. MSBUILD_JNI_LIBS_SRC_DIR, MSBUILD_ANDROID_OUTPUT_APK_NAME ve MSBUILD_ANDROID_GRADLE_BUILD_OUTPUT_DIR kullanımlarını silin.

    Genellikle, uygulama düzeyindeki build.gradle dosyasında bulunan aşağıdaki engellemeler tamamen silinebilir.

       sourceSets {
           main {
               jniLibs.srcDirs = [MSBUILD_JNI_LIBS_SRC_DIR]
           }
       }
    
       applicationVariants.all { variant ->
           variant.outputs.all {
               outputFileName = MSBUILD_ANDROID_OUTPUT_APK_NAME
           }
       }
    
       buildDir = MSBUILD_ANDROID_GRADLE_BUILD_OUTPUT_DIR
    

Geri bildirim

Bu özellik deneysel olduğundan geri bildirimleriniz bizim için çok önemlidir. Bunu şu şekilde sağlayabilirsiniz:

  • Genel yorumlar ve geri bildirimler için bu hataya yorum ekleyebilirsiniz.
  • Bir hatayı bildirmek için Android Studio'yu açın ve Yardım/Geri Bildirim Gönder'i tıklayın. Hatanın yönlendirilmesine yardımcı olması için "Özel C/C++ Derleme Sistemleri"ne atıfta bulunmayı unutmayın.
  • Android Studio yüklü değilse bu bağlantıyı tıklayın.