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 geçiş yapıyorsanız ve projeniz zaten Gradle kullanıyorsa mevcut projenizi Android Studio'dan açabilirsiniz. IntelliJ kullanıyorsanız ancak projenizde henüz Gradle kullanılmıyorsa projeyi Android Studio'ya aktarabilmek için önce 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

Android Studio'ya geçiş yapmaya hazırlanırken dikkat etmeniz gereken bazı temel farklılıklar aşağıda belirtilmiştir.

Proje ve modül organizasyonu

Android Studio, IntelliJ IDEA IDE'ye dayanır. Geçiş, kod tamamlama ve klavye kısayolları gibi IDE'nin temel özellikleri hakkında bilgi edinmek için Android Studio ile tanışma başlıklı makaleyi inceleyin.

Android Studio, kodu projeler halinde düzenler. Projeler, uygulama kaynak kodundan derleme yapılandırmalarına ve test koduna kadar Android uygulamanızı tanımlayan her şeyi içerir. Projeler ayrı Android Studio pencerelerinde açılır. Her proje, projenizi ayrı işlev birimlerine bölmenize olanak tanıyan bir veya daha fazla modül içerir. Modüller bağımsız olarak oluşturulabilir, test edilebilir ve hataları ayıklanabilir.

Android Studio projeleri ve modülleri hakkında daha fazla bilgi için Projelere genel bakış başlıklı makaleyi inceleyin.

Gradle tabanlı derleme sistemi

Android Studio'nun derleme sistemi Gradle'a dayanır ve genişletme ile ö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 de dahil olmak üzere önemli özellikler sunar:

  • İkili kitaplıklar (AAR'ler) için destek. Artık kitaplık kaynaklarını kendi projelerinize kopyalamanız gerekmiyor. Bağımlılık beyan edebilirsiniz. Bu durumda kitaplık otomatik olarak indirilip projenizle birleştirilir. Bu işlem, derleme sırasında kaynakları, manifest girişlerini, Proguard dışlama kurallarını, özel lint kurallarını vb. otomatik olarak birleştirmeyi içerir.
  • Aynı projeden uygulamanızın farklı sürümlerini (ör. ücretsiz sürüm ve profesyonel sürüm) oluşturmanıza olanak tanıyan derleme varyantları desteği.
  • Kolay derleme yapılandırması ve özelleştirme. Örneğin, derleme sırasında Git etiketlerinden sürüm adlarını ve sürüm kodlarını çekebilirsiniz.
  • Gradle, IDE'den, komut satırından ve Jenkins gibi sürekli entegrasyon sunucularından kullanılabilir. Böylece her yerde ve her zaman aynı derleme sağlanır.

Gradle'ı kullanma ve yapılandırma hakkında daha fazla bilgi için Derlemenizi yapılandırma başlıklı makaleyi inceleyin.

Bağımlılıklar

Android Studio'daki kitaplık bağımlılıkları, Gradle bağımlılık bildirimlerini 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 başlıklı makaleyi 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 sistemini kullanıyorsa Android Studio'ya geçmeden önce Gradle ile çalışacak şekilde ayarlamanız gerekir.

Gradle tabanlı bir IntelliJ projesini içe aktarma

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

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

Gradle olmayan bir IntelliJ projesini içe aktarma

IntelliJ projeniz henüz Gradle derleme sistemini kullanmı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 bir boş proje oluşturarak taşıma

Yeni bir boş 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çıp File > New > New Project'i (Dosya > Yeni > Yeni Proje) tıklayın.
  2. Uygulama projeniz için bir ad girin ve oluşturulacağı konumu belirtin, ardından Sonraki'yi tıklayın.
  3. Uygulamanızın çalıştığı form faktörlerini seçip Sonraki'yi tıklayın.
  4. Add No Activity (Etkinlik Yok Ekle) seçeneğini, ardından Finish'i (Bitir) tıklayın.
  5. Proje araç penceresinde, görünüm menüsünü açmak için oku tıklayın ve yeni Android Studio projenizin düzenini görmek ve keşfetmek için Proje görünümünü seçin. 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ı başlıklı makaleyi inceleyin.
  6. Yeni projeniz için seçtiğiniz konuma gidin ve eski proje dizinlerinizdeki kodu, birim testlerini, enstrümantasyon testlerini ve kaynakları yeni proje yapınızdaki doğru konumlara taşıyın.
  7. Proje Yapısı iletişim kutusunu açmak için Android Studio'da Dosya > Proje Yapısı'nı tıklayın. Sol bölmede uygulamanızın modülünün seçildiğinden emin olun.
  8. Projeniz için Özellikler sekmesinde gerekli değişiklikleri yapın (örneğin, minSdk veya targetSdk değiştirme).
  9. Bağımlılıklar'ı tıklayın ve projenizin bağlı olduğu tüm kitaplıkları Gradle bağımlılıkları 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 uygulayın.
  10. Yaptığınız değişiklikleri kaydetmek için Tamam'ı tıklayın.
  11. Projenizi oluşturmayı test etmek için Build > Make Project'i (Oluştur > Proje Oluştur) tıklayın ve gerekirse bekleyen hataları düzeltin.

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

Yeni bir Gradle derleme dosyası oluşturarak projenizi Android Studio'ya taşımak için aşağıdaki adımları uygulayın:

  1. Taşıma işlemi, projenizin içeriğini yerinde değiştireceğinden başlamadan önce proje dosyalarınızı ayrı bir konumda yedekleyin.
  2. Groovy kullanıyorsanız proje dizininizde build.gradle adlı bir dosya, 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.

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

    1.şekil Android uygulama modülünün varsayılan proje yapısı.

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

    Groovy

      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 başlıklı makaleyi inceleyin.

    Android Gradle eklentisi, projeye bazı varsayılan kaynak kümeleri uygular. Bu kaynak kümeleri, çeşitli kaynak dosyası 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 yere taşıyabilir veya varsayılan kaynak kümelerini değiştirebilirsiniz. Böylece Gradle, dosyaları nerede bulacağını bilir.

    Gradle derleme dosyası oluşturma ve özelleştirme hakkında daha fazla bilgi için Derlemenizi yapılandırma başlıklı makaleyi inceleyin.

  3. Ardından, hangi kitaplık projelerini kullandığınızı belirleyin.

    Gradle ile artık bu kitaplıkları kaynak kodu projeleri olarak eklemeniz gerekmez. Bunun yerine, bunları derleme dosyanızın dependencies{} bloğunda belirtebilirsiniz. Derleme sistemi daha sonra kitaplıkları indirme, kaynakları birleştirme ve manifest girişlerini birleştirme gibi işlemleri sizin için gerçekleştirir. Aşağıdaki örnekte, bir derleme dosyasının dependencies{} bloğuna bir dizi AndroidX kitaplığı için bildirim ifadeleri eklenmektedir.

    Groovy

    ...
    dependencies {
        implementation fileTree(dir: 'libs', include: ['*.jar'])
    
        // AndroidX libraries
        implementation 'androidx.core:core-ktx:1.16.0'
        implementation 'androidx.appcompat:appcompat:1.7.1'
        implementation 'androidx.cardview:cardview:1.0.0'
        implementation 'com.google.android.material:material:1.7.0'
        implementation 'androidx.gridlayout:gridlayout:1.1.0'
        implementation 'androidx.leanback:leanback:'
        implementation 'androidx.mediarouter:mediarouter:1.8.1'
        implementation 'androidx.palette:palette-ktx:1.0.0'
        implementation 'androidx.recyclerview:recyclerview:1.4.0'
        implementation 'androidx.annotation:annotation:1.9.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.16.0")
        implementation("androidx.appcompat:appcompat:1.7.1")
        implementation("androidx.cardview:cardview:1.0.0")
        implementation("com.google.android.material:material:1.7.0")
        implementation("androidx.gridlayout:gridlayout:1.1.0")
        implementation("androidx.leanback:leanback:")
        implementation("androidx.mediarouter:mediarouter:1.8.1")
        implementation("androidx.palette:palette-ktx:1.0.0")
        implementation("androidx.recyclerview:recyclerview:1.4.0")
        implementation("androidx.annotation:annotation:1.9.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 üzere Google Maven deposunda veya Maven Central'da arama yapın.
  4. build.gradle dosyanızı kaydedin, ardından IntelliJ'de projeyi kapatın. Proje dizininize gidin ve .idea dizinini ve projenizdeki tüm IML dosyalarını silin.
  5. Android Studio'yu başlatın ve File > New > Import Project'i (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 Tamam'ı tıklayarak projenizi içe aktarın.
  7. Projenizi oluşturarak derleme dosyanızı test etmek ve bulduğunuz hataları düzeltmek için Build > Make Project'i (Derleme > Proje Oluştur) tıklayın.

Sonraki adımlar

Projenizi Android Studio'ya taşıdıktan sonra, Gradle ile derleme ve uygulamanızı Android Studio'da çalıştırma hakkında daha fazla bilgi edinmek için Uygulamanızı derleme ve çalıştırma başlıklı makaleyi inceleyin.

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 de 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ırma

Android Studio; Git, Mercurial ve Subversion gibi çeşitli sürüm kontrol sistemlerini destekler. Diğer sürüm kontrol sistemleri eklentiler aracılığıyla eklenebilir.

Uygulamanız zaten kaynak kontrolü altındaysa Android Studio'da etkinleştirmeniz gerekebilir. VCS menüsünde Enable Version Control Integration'ı (Sürüm Kontrolü Entegrasyonunu Etkinleştir) 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 kontrolüne aktarmak ve diğer sürüm kontrolü işlemlerini gerçekleştirmek için Android Studio VCS menü seçeneklerini kullanın:

  1. Android Studio VCS menüsünde Enable Version Control Integration'ı (Sürüm Kontrolü Entegrasyonunu Etkinleştir) tıklayın.
  2. Menüden proje köküyle ilişkilendirilecek bir sürüm kontrol sistemi seçin ve Tamam'ı tıklayın. VCS menüsünde artık seçtiğiniz sisteme göre bir dizi sürüm kontrolü 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 kontrolüyle çalışma hakkında daha fazla bilgi için IntelliJ'in sürüm kontrolü referansı başlıklı makaleyi inceleyin.

Uygulama imzalama

Daha önce bir hata ayıklama sertifikası kullanıldıysa bu sertifika, içe aktarma işlemi sırasında algılanabilir. Bu durumda Android Studio, söz konusu sertifikaya referans vermeye devam eder. Aksi takdirde, hata ayıklama yapılandırması, Android Studio tarafından oluşturulan hata ayıklama anahtar deposunu kullanır. Bu anahtar deposu, bilinen bir şifre ve $HOME/.android/debug.keystore konumunda bulunan bilinen bir şifreye sahip varsayılan anahtarı kullanır. Hata ayıklama derleme türü, projenizi Android Studio'dan çalıştırdığınızda veya hata ayıklamasını yaptığınızda bu hata ayıklama yapılandırmasını otomatik olarak kullanacak şekilde ayarlanır.

Benzer şekilde, içe aktarma işlemi mevcut bir yayın sertifikasını algılayabilir. Daha önce bir yayın sertifikası tanımlanmadıysa yayın imzalama yapılandırmasını build.gradle veya build.gradle.kts dosyasına ekleyin ya da İmzalı APK Oluşturma Sihirbazı'nı açmak için Build > Generate Signed APK (Derleme > İmzalı APK Oluştur) menü seçeneğini kullanın. Uygulamanızı imzalama hakkında daha fazla bilgi için Uygulamanızı imzalama başlıklı makaleyi inceleyin.

Android Studio'nun maksimum yığın boyutunu ayarlama

Android Studio'da varsayılan olarak maksimum yığın boyutu 1.280 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ı iyileştirebilirsiniz.

Yazılım güncellemeleri

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

Android Studio, varsayılan olarak yeni bir kararlı sürüm yayınlandığında otomatik güncellemeler sunar. Ancak daha sık güncelleme yapmayı ve önizleme veya beta sürümlerini almayı da tercih edebilirsiniz.

Android Studio'yu güncelleme, önizleme ve beta sürümlerini kullanma hakkında daha fazla bilgi için güncellemeler başlıklı makaleyi inceleyin.