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 Gradle kullanılmıyorsa projenizi Android Studio'ya aktarmadan ö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ı önemli farklar aşağıda belirtilmiştir.

Proje ve modül organizasyonu

Android Studio, IntelliJ IDEA IDE'yi temel alır. Gezinme, kod tamamlama ve klavye kısayolları gibi IDE temelleriyle ilgili bilgi edinmek için Android Studio ile tanışın başlıklı makaleyi inceleyin.

Android Studio, kodu projeler halinde düzenler. Bu 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 derlenebilir, test edilebilir ve hata 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'i 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, aşağıdakiler de dahil olmak üzere Android geliştirme için önemli özellikler sunar:

• İkili kitaplıklar (AAR'lar) 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 indirilir ve projenizle birleştirilir. Buna, derleme sırasında kaynakları, manifest girişlerini, Proguard hariç tutma kurallarını, özel lint kurallarını vb. otomatik olarak birleştirme dahildir.
• Aynı projeden uygulamanızın farklı sürümlerini (ör. ücretsiz 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 kapsamında Git etiketlerinden sürüm adlarını ve sürüm kodlarını alabilirsiniz.
• 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'i 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ı, Maven koordinatları içeren bilinen yerel kaynak ve ikili kitaplıklar için Gradle bağımlılık beyanları ve Maven bağımlılıkları kullanır. Daha fazla bilgi için Bağımlılıkları belirtme başlıklı makaleyi inceleyin.

IntelliJ'den taşıma

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

Gradle tabanlı IntelliJ projesini içe aktarma

IntelliJ projenizle Gradle'i 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çin ve Tamam'ı tıklayın. Projeniz Android Studio'da açılır.

Gradle olmayan bir IntelliJ projesini içe aktarma

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

• Yeni bir boş Android Studio projesi oluşturun ve mevcut kaynak kodunuzu yeni projeyle ilişkili dizinlere kopyalayın. Daha fazla bilgi için Yeni bir boş proje oluşturarak taşıma ile ilgili bölüme bakın.
• Projeniz için yeni bir Gradle derleme dosyası oluşturun ve ardından projeyi ve yeni derleme dosyasını Android Studio'ya aktarın. Daha fazla bilgi için Özel Gradle derleme dosyası oluşturarak taşıma ile ilgili bölümü inceleyin.

Yeni bir boş proje oluşturarak taşıma

Yeni bir boş proje oluşturarak ve 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 Dosya > Yeni > Yeni Proje'yi 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'i (Etkinlik Ekle) ve 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 yapısını 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. Android Studio'da Proje Yapısı iletişim kutusunu açmak için Dosya > Proje Yapısı'nı tıklayın. Sol bölmede uygulamanızın modülünün seçili olduğundan emin olun.
8. Projenizin Özellikler sekmesinde gerekli değişiklikleri yapın (örneğin, minSdk veya targetSdk öğesini değiştirin).
9. Bağımlılar'ı 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 talimatları uygulayın.
10. Değişikliklerinizi kaydetmek için Tamam'ı tıklayın.
11. Projenizi oluşturmayı test etmek için Derle > Proje Oluştur'u tıklayın ve gerekirse çözülmemiş hataları giderin.

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

Mevcut kaynak dosyalarınızı işaret edecek 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ştirdiği için 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.

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

   

   Groovy için settings.gradle veya Kotlin komut dosyası için settings.gradle.kts'te, sırasıyla pluginManagement ve dependencyResolutionManagement bloklarında eklentileri ve bağımlılıklarını bulmak için kullanılan depoları 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 uygun değilse dosyaları olması gereken yere taşıyabilir veya Gradle'in dosyaları nerede bulacağını bilmesi için varsayılan kaynak kümelerini değiştirebilirsiniz.

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

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

   Gradle ile artık bu kitaplıkları kaynak kod projeleri olarak eklemeniz gerekmez. Bunun yerine, derleme dosyanızın dependencies{} bloğunda bu dosyalara referans verebilirsiniz. Ardından derleme sistemi, kitaplıkları indirme, kaynaklarla birleştirme ve manifest girişlerini birleştirme dahil olmak üzere bu kitaplıkları sizin için işler. Aşağıdaki örnekte, bir dizi AndroidX kitaplığının bildirim ifadeleri bir derleme dosyasının dependencies{} bloğuna eklenmektedir.

   Groovy

   ...
   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   
       // AndroidX libraries
       implementation 'androidx.core:core-ktx:1.15.0'
       implementation 'androidx.appcompat:appcompat:1.7.0'
       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.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.15.0")
       implementation("androidx.appcompat:appcompat:1.7.0")
       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.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 istiyorsanız 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 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 projenizi içe aktarmak için Tamam'ı tıklayın.
7. Projenizi derleyerek derleme dosyanızı test etmek ve bulduğunuz hataları gidermek için Derle > Proje Oluştur'u tıklayın.

Sonraki adımlar

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

Projenize ve iş akışınıza bağlı olarak sürüm kontrolü, bağımlılık yönetimi 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ı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 denetimi altındaysa Android Studio'da etkinleştirmeniz gerekebilir. VCS menüsünden Sürüm Kontrolü Entegrasyonu'nu Etkinleştir'i tıklayın ve uygun sürüm kontrol sistemini seçin.

Uygulamanız kaynak denetimi altında değilse uygulamanızı Android Studio'ya içe aktardıktan sonra yapılandırabilirsiniz. İstediğiniz 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 üzere Android Studio VCS menü seçeneklerini kullanın:

1. Android Studio VCS menüsünden Sürüm Kontrolü Entegrasyonu'nu etkinleştir'i 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 çeşitli sürüm kontrol seçenekleri gösterilir.

Not: Sürüm kontrolünü ayarlamak ve değiştirmek için Dosya > Ayarlar > Sürüm Kontrolü 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ı, bilinen bir şifreyi ve $HOME/.android/debug.keystore konumunda bulunan bilinen bir şifreye sahip varsayılan bir anahtarı kullanarak Android Studio tarafından oluşturulan hata ayıklama anahtar ambarını kullanır. Hata ayıklama derleme türü, Android Studio'dan projenizi çalıştırdığınızda veya projenizde hata ayıklama 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 sürüm sertifikasını algılayabilir. Daha önce sürüm sertifikası tanımlanmadıysa sürüm imzalama yapılandırmasını build.gradle veya build.gradle.kts dosyasına ekleyin ya da İmzalanmış APK Oluşturma Sihirbazı'nı açmak için Derle > İ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'nun varsayılan 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ı 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 kullanmak istediğiniz sürümleri belirtebilirsiniz.

Android Studio, varsayılan olarak yeni bir kararlı sürüm yayınlandığında 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 ve önizleme ile beta sürümlerini kullanma hakkında daha fazla bilgi için güncellemeler başlıklı makaleyi inceleyin.