Android Studio'ya taşıma

Projelerinizi Android Studio'ya taşımak için yeni bir proje yapısına, derleme sistemine ve IDE işlevine uyum sağlamanız gerekir.

IntelliJ'den taşıma gerçekleştiriyorsanız ve projeniz zaten Gradle kullanıyorsa mevcut projenizi Android Studio'dan açabilirsiniz. IntelliJ kullanıyorsanız ancak projenizde halihazırda Gradle kullanılmıyorsa, Android Studio'ya aktarmadan önce projenizi manuel olarak hazırlamanız gerekir. Daha fazla bilgi için IntelliJ'den taşıma bölümüne bakın.

Android Studio ile ilgili temel bilgiler

Aşağıda, Android Studio'ya geçişe hazırlanırken göz önünde bulundurmanız gereken bazı önemli farklılıklar verilmiştir.

Proje ve modül organizasyonu

Android Studio, IntelliJ IDEA IDE'sini temel alır. Gezinme, kod tamamlama ve klavye kısayolları gibi IDE (Entegre Geliştirme Ortamı) temel özelliklerini öğrenmek için Android Studio'yla Tanışın sayfasını inceleyin.

Android Studio, kodları projeler halinde düzenler. Bu projelerde, uygulama kaynak kodundan yapılandırma ve test koduna kadar Android uygulamanızı tanımlayan her şey bulunur. Projeler ayrı Android Studio pencerelerinde açılır. Her projede bir veya daha fazla modül bulunur. Bu modüller, projenizi farklı işlev birimlerine ayırmanızı sağlar. Modüller bağımsız olarak derlenebilir, test edilebilir ve hataları ayıklanabilir.

Android Studio projeleri ve modülleri hakkında daha fazla bilgi için Projelere genel bakış konusuna bakın.

Gradle tabanlı derleme sistemi

Android Studio’nun derleme sistemi Gradle'ı temel alır ve genişletilebilirlik ve özelleştirme kolaylığı için Groovy veya Kotlin komut dosyasıyla yazılmış derleme yapılandırma dosyalarını kullanır.

Gradle tabanlı projeler, Android geliştirme için aşağıdakiler gibi önemli özellikler sunar:

  • İkili kitaplık (AAR) desteği. Artık kitaplık kaynaklarını kendi projelerinize kopyalamanız gerekmez. Bağımlılık bildirebilirsiniz ve kitaplık otomatik olarak indirilip projenizle birleştirilir. Buna, derleme sırasında kaynakları, manifest girişlerini, ProGuard hariç tutma kurallarını, özel hata analizi kurallarını ve benzeri öğeleri otomatik olarak birleştirme işlemi dahildir.
  • Aynı projeden uygulamanızın farklı sürümlerini (ücretsiz ve pro sürüm gibi) oluşturmanızı sağlayan varyant oluşturma desteği.
  • Kolay oluşturma ve özelleştirme. Örneğin, derlemenin bir parçası olarak sürüm adlarını ve sürüm kodlarını Git etiketlerinden alabilirsiniz.
  • Gradle; IDE'den, komut satırından ve Jenkins gibi sürekli entegrasyon sunucularından kullanılabilir. Böylece her yerde aynı derlemeyi her zaman sunar.

Gradle'ı kullanma ve yapılandırma hakkında daha fazla bilgi için Derlemenizi yapılandırma bölümüne bakın.

Bağımlılıklar

Android Studio'daki kitaplık bağımlılıkları, Gradle bağımlılık tanımlarını ve Maven koordinatlarına sahip iyi bilinen yerel kaynak ve ikili kitaplıklar için Maven bağımlılıklarını kullanır. Daha fazla bilgi için Bağımlılıkları bildirme bölümünü inceleyin.

IntelliJ'den taşıma

IntelliJ projeniz Gradle derleme sistemini kullanıyorsa projenizi doğrudan Android Studio'ya aktarabilirsiniz. IntelliJ projeniz Maven veya başka bir derleme sistemi kullanıyorsa Android Studio'ya geçiş yapmadan önce projeyi Gradle ile çalışacak şekilde ayarlamanız gerekir.

Gradle tabanlı IntelliJ projesini içe aktarma

Gradle'ı IntelliJ projenizle zaten kullanıyorsanız aşağıdaki adımları uygulayarak Android Studio'da açın:

  1. Dosya > Yeni > Projeyi İçe Aktar'ı tıklayın.
  2. IntelliJ proje dizininizi seçin ve OK'i (Tamam) tıklayın. Projeniz Android Studio'da açılır.

Graadle olmayan IntelliJ projesini içe aktarma

IntelliJ projenizde Gradle derleme sistemi zaten kullanılmıyorsa projenizi Android Studio'ya aktarmak için iki seçeneğiniz vardır. Bu seçenekler, aşağıdaki bölümlerde açıklanmıştır:

Yeni boş proje oluşturarak taşıyın

Yeni boş bir proje oluşturup kaynak dosyalarınızı yeni dizinlere kopyalayarak projenizi Android Studio'ya taşımak için aşağıdaki adımları uygulayın:

  1. Android Studio'yu açın ve Dosya > Yeni > Yeni Proje'yi tıklayın.
  2. Uygulama projeniz için bir ad girin ve oluşturulması gereken konumu belirtip Sonraki'yi tıklayın.
  3. Uygulamanızın çalıştığı form faktörlerini seçip İleri'yi tıklayın.
  4. Etkinlik Ekleme'yi ve ardından Son'u tıklayın.
  5. Proje aracı penceresinde, oku tıklayarak görünüm menüsünü açın ve Proje görünümünü seçerek yeni Android Studio projenizin kuruluşunu görüntüleyin ve keşfedin. Görünümleri değiştirme ve Android Studio'nun projeleri nasıl yapılandırdığı hakkında daha fazla bilgi edinmek için Proje dosyaları bölümüne bakın.
  6. Yeni projeniz için seçtiğiniz konuma gidip kodu, birim testlerini, araç testlerini ve kaynakları eski proje dizinlerinizden yeni proje yapınızdaki doğru konumlara taşıyın.
  7. Android Studio'da Dosya > Proje Yapısı'nı tıklayarak Proje Yapısı iletişim kutusunu açın. Sol bölmede uygulamanızın modülünün seçildiğinden emin olun.
  8. Projenizin Özellikler sekmesinde gerekli değişiklikleri yapın (örneğin, minSdk veya targetSdk öğesini değiştirme).
  9. Bağımlılıklar'ı tıklayın ve projenizin bağımlı olduğu kitaplıkları Gradle bağımlılığı olarak ekleyin. Yeni bir bağımlılık eklemek için Ekle'yi tıklayın, ardından eklemek istediğiniz bağımlılık türünü seçin ve istemleri takip edin.
  10. Yaptığınız değişiklikleri kaydetmek için Tamam'ı tıklayın.
  11. Projenizi derlemeyi test etmek ve gerekirse bekleyen hataları düzeltmek için Oluştur > Proje Yap'ı tıklayın.

Özel bir Gradle derleme dosyası oluşturarak taşıma

Projenizi, mevcut kaynak dosyalarınıza işaret eden yeni bir Gradle derleme dosyası oluşturarak Android Studio'ya taşımak için aşağıdaki adımları uygulayın:

  1. Taşıma süreci projenizin içeriğini değiştirirken, başlamadan önce proje dosyalarınızı ayrı bir konuma yedekleyin.
  2. Proje dizininizde Groovy kullanıyorsanız build.gradle veya Kotlin komut dosyası kullanıyorsanız build.gradle.kts adlı bir dosya oluşturun. Bu dosya, Gradle'ın derlemenizi çalıştırması için gereken tüm bilgileri içerir.

    Varsayılan olarak Android Studio, projenizin Şekil 1'de gösterildiği gibi düzenlenmesini bekler.

    Şekil 1. Bir Android uygulama modülü için varsayılan proje yapısıdır.

    settings.gradle'da Groovy veya settings.gradle.kts için, Kotlin komut dosyası için sırasıyla pluginManagement ve dependencyResolutionManagement bloklarında eklentileri ve bağımlılıkları bulmak için kullanılan depoları ayarlarsınız:

    Modern

      pluginManagement {
          repositories {
              google()
              mavenCentral()
              gradlePluginPortal()
          }
      }
      dependencyResolutionManagement {
          repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
          repositories {
              google()
              mavenCentral()
          }
      }
      rootProject.name = "Test App"
      include ':app'
      

    Kotlin

      pluginManagement {
          repositories {
              google()
              mavenCentral()
              gradlePluginPortal()
          }
      }
      dependencyResolutionManagement {
          repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
          repositories {
              google()
              mavenCentral()
          }
      }
      rootProject.name = "Test App"
      include(":app")
      

    Uyarı: JCenter deposu 31 Mart 2021'de salt okunur hale geldi. Daha fazla bilgi için JCenter hizmet güncellemesi bölümüne bakın.

    Android Gradle eklentisi, projeye bazı varsayılan kaynak grupları uygular. Bu kaynak kümeleri, çeşitli kaynak dosya türlerini depolamak için kullanılan dizinleri tanımlar. Gradle, belirli dosya türlerinin konumlarını belirlemek için bu kaynak kümelerini kullanır. Mevcut projeniz varsayılanlara uymuyorsa dosyaları olması gereken yerlere taşıyabilir veya Gradle'ın bunları nerede bulacağını bilmesi için varsayılan kaynak gruplarını değiştirebilirsiniz.

    Gradle derleme dosyası ayarlama ve özelleştirme hakkında daha fazla bilgi için Derlemenizi yapılandırma bölümünü okuyun.

  3. Daha sonra, hangi kitaplık projelerini kullandığınızı belirleyin.

    Gradle sayesinde artık bu kitaplıkları kaynak kodu projeleri olarak eklemeniz gerekmez. Bunun yerine, derleme dosyanızın dependencies{} bloğunda bunlara bakabilirsiniz. Daha sonra derleme sistemi; kitaplık indirme, kaynakları birleştirme ve manifest girişlerini birleştirme de dahil olmak üzere bu kitaplıkları sizin için yönetir. Aşağıdaki örnek, birkaç AndroidX kitaplığı için bildirim ifadelerini bir derleme dosyasının dependencies{} bloğuna ekler.

    Modern

    ...
    dependencies {
        implementation fileTree(dir: 'libs', include: ['*.jar'])
    
        // AndroidX libraries
        implementation 'androidx.core:core-ktx:1.12.0'
        implementation 'androidx.appcompat:appcompat:1.6.1'
        implementation 'androidx.cardview:cardview:1.0.0'
        implementation 'com.google.android.material:material:1.7.0'
        implementation 'androidx.gridlayout:gridlayout:1.0.0'
        implementation 'androidx.leanback:leanback:1.1.0-rc02'
        implementation 'androidx.mediarouter:mediarouter:1.7.0'
        implementation 'androidx.palette:palette-ktx:1.0.0'
        implementation 'androidx.recyclerview:recyclerview:1.3.2'
        implementation 'androidx.annotation:annotation:1.7.1'
    
        // Note: these libraries require that the Google repository has been declared
        // in the pluginManagement section of the top-level build.gradle file.
    }

    Kotlin

    ...
    dependencies {
        implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))
    
        // AndroidX libraries
        implementation("androidx.core:core-ktx:1.12.0")
        implementation("androidx.appcompat:appcompat:1.6.1")
        implementation("androidx.cardview:cardview:1.0.0")
        implementation("com.google.android.material:material:1.7.0")
        implementation("androidx.gridlayout:gridlayout:1.0.0")
        implementation("androidx.leanback:leanback:1.1.0-rc02")
        implementation("androidx.mediarouter:mediarouter:1.7.0")
        implementation("androidx.palette:palette-ktx:1.0.0")
        implementation("androidx.recyclerview:recyclerview:1.3.2")
        implementation("androidx.annotation:annotation:1.7.1")
    
        // Note: these libraries require that the Google repository has been declared
        // in the pluginManagement section of the top-level build.gradle.kts file.
    }
    Kitaplıklarınız için doğru beyan ifadelerini belirleme konusunda yardım almak amacıyla Google Maven deposu veya Maven Central'da arama yapın.
  4. build.gradle dosyanızı kaydedin, ardından IntelliJ'de projeyi kapatın. Proje dizininize gidip .idea dizinini ve projenizdeki tüm IML dosyalarını silin.
  5. Android Studio'yu başlatın ve Dosya > Yeni > Projeyi İçe Aktar'ı tıklayın.
  6. Proje dizininizi bulun, oluşturduğunuz build.gradle veya build.gradle.kts dosyasını seçin ve ardından projenizi içe aktarmak için Tamam'ı tıklayın.
  7. Projenizi derleyerek derleme dosyanızı test etmek ve bulduğunuz hataları düzeltmek için Derleme > Proje Yap'ı tıklayın.

Sonraki adımlar

Projenizi Android Studio'ya taşıdıktan sonra, Gradle ile geliştirme ve uygulamanızı Android Studio'da çalıştırma hakkında daha fazla bilgi edinmek için Uygulamanızı oluşturma ve çalıştırma bölümünü okuyun.

Projenize ve iş akışınıza bağlı olarak, sürüm kontrolü, bağımlılıkları yönetme ve Android Studio'yu yapılandırma hakkında daha fazla bilgi edinmek isteyebilirsiniz. Android Studio'yu kullanmaya başlamak için Android Studio ile Tanışın başlıklı makaleyi okuyun.

Sürüm denetimini yapılandır

Android Studio; Git, Mercurial ve Subversion'ı da içeren çeşitli sürüm kontrol sistemlerini destekler. Eklentiler aracılığıyla başka sürüm kontrol sistemleri de eklenebilir.

Uygulamanız zaten kaynak kontrolü altındaysa Android Studio'da bu uygulamayı etkinleştirmeniz gerekebilir. VCS menüsünde, Sürüm Denetimi Entegrasyonunu Etkinleştir'i tıklayın ve uygun sürüm kontrol sistemini seçin.

Uygulamanız kaynak kontrolü altında değilse, uygulamanızı Android Studio'ya aktardıktan sonra yapılandırabilirsiniz. İstenen sürüm kontrol sistemi için VCS desteğini etkinleştirmek, depo oluşturmak, yeni dosyaları sürüm denetimine aktarmak ve diğer sürüm kontrolü işlemlerini gerçekleştirmek üzere Android Studio VCS menü seçeneklerini kullanın:

  1. Android Studio VCS menüsünden Sürüm Denetimi Entegrasyonunu Etkinleştir'i tıklayın.
  2. Menüden proje köküyle ilişkilendirilecek bir sürüm kontrol sistemi seçin ve ardından Tamam'ı tıklayın. VCS menüsünde artık seçtiğiniz sisteme bağlı olarak bir dizi sürüm denetimi seçeneği gösteriliyor.

Not: Sürüm denetimini ayarlamak ve değiştirmek için Dosya > Ayarlar > Sürüm Denetimi menü seçeneğini de kullanabilirsiniz.

Sürüm denetimiyle çalışma hakkında daha fazla bilgi için IntelliJ'in Sürüm denetimi referansı sayfasına bakın.

Uygulama imzalama

Daha önce hata ayıklama sertifikası kullanıldıysa içe aktarma işlemi sırasında tespit edilebilir. Bu durumda, Android Studio söz konusu sertifikaya referansta bulunmaya devam eder. Aksi takdirde, hata ayıklama yapılandırmasında Android Studio tarafından oluşturulan hata ayıklama anahtar deposu kullanılarak bilinen bir şifre ve $HOME/.android/debug.keystore içinde bilinen bir şifreye sahip varsayılan bir anahtar kullanılır. Hata ayıklama derleme türü, projenizi Android Studio'dan çalıştırdığınızda veya projenizde hata ayıkladığınızda bu hata ayıklama yapılandırmasını otomatik olarak kullanacak şekilde ayarlanmıştır.

Benzer şekilde, içe aktarma işlemi mevcut bir sürüm sertifikasını algılayabilir. Önceden tanımlanmış bir sürüm sertifikası yoksa sürüm imzalama yapılandırmasını build.gradle veya build.gradle.kts dosyasına ekleyin ya da İmzalanmış APK Sihirbazı Oluştur menü seçeneğini kullanarak Derleme > İmzalanmış APK Oluştur menü seçeneğini kullanın. Uygulamanızı imzalama hakkında daha fazla bilgi için Uygulamanızı imzalama bölümüne bakın.

Android Studio’nun maksimum yığın boyutunu ayarla

Varsayılan olarak, Android Studio'nun maksimum yığın boyutu 1280 MB'tır. Büyük bir proje üzerinde çalışıyorsanız veya sisteminizde çok fazla RAM varsa maksimum yığın boyutunu artırarak performansı artırabilirsiniz.

Yazılım güncellemeleri

Android Studio, Gradle eklentisi, derleme araçları ve SDK araçlarından ayrı olarak güncellenir. Android Studio ile hangi sürümleri kullanmak istediğinizi belirtebilirsiniz.

Varsayılan olarak, yeni bir kararlı sürüm yayınlandığında Android Studio otomatik güncellemeler sağlar ancak daha sık güncelleme yapmayı ve önizleme veya beta sürümleri almayı seçebilirsiniz.

Android Studio'yu güncelleme, önizleme ve beta sürümlerini kullanma hakkında daha fazla bilgi edinmek için güncellemeler bölümünü okuyun.