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 kullanmıyorsanız 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

Android Studio'ya geçişe hazırlanırken bilmeniz gereken bazı önemli farklar aşağıda verilmiştir.

Proje ve modül organizasyonu

Android Studio, IntelliJ IDEA IDE'yi temel alır. Gezinme, kod tamamlama ve klavye kısayolları gibi IDE'nin temel özellikleri hakkında bilgi edinmek için Meet Android Studio'ya bakın.

Android Studio, kodları projeler halinde düzenler. Projelerde uygulama kaynak kodundan derleme yapılandırmaları 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 bölmenize olanak tanır. 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ış bölümüne bakın.

Gradle tabanlı derleme sistemi

Android Studio'nun derleme sistemi Gradle tabanlıdı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 program kitaplıkları (AAR) desteği. Artık kitaplık kaynaklarını kendi projelerinize kopyalamanıza gerek yoktur. Bir bağımlılık bildirebilirsiniz. Ardından kitaplık otomatik olarak indirilip projenizle birleştirilir. Buna, derleme sırasında kaynakları, manifest girişlerini, ProGuard hariç tutma kuralları, özel lint kuralları vb. otomatik olarak birleştirme dahildir.
• Aynı projeden uygulamanızın farklı sürümlerini (ücretsiz sürüm ve pro sürüm gibi) derlemenizi sağlayan derleme varyantları desteği.
• Kolay derleme yapılandırması ve özelleştirmesi. Örneğin, derlemenin bir parçası olarak 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ı üzerinden kullanılabilir. Böylece her yerde ve her zaman aynı derlemeyi sağlar.

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

Bağımlılıklar

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

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çmeden önce projeyi Gradle ile çalışacak şekilde ayarlamanız gerekir.

Gradle tabanlı bir IntelliJ projesini içe aktarma

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

Gradle olmayan bir 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. Bunlar aşağıdaki bölümlerde açıklanmıştır:

• Yeni, boş bir 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 bölümüne bakın.
• Projeniz için yeni bir Gradle derleme dosyası oluşturun. 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 bölümüne bakın.

Yeni boş bir 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 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. Etkinlik Ekleme Yok'u ve ardından Son'u tıklayın.
5. Proje aracı penceresinde görünüm menüsünü açmak için oku tıklayın ve yeni Android Studio projenizin düzenini görüp 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ı'na bakın.
6. Yeni projeniz için seçtiğiniz konuma gidin ve eski proje dizinlerindeki kodu, birim testlerini, araç 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çildiğinden emin olun.
8. Projenizin Özellikler sekmesinde gerekli değişiklikleri yapın (ör. minSdk veya targetSdk üzerinde değişiklik).
9. Bağımlılıklar'ı tıklayın ve projenizin bağlı olduğu kitaplıkları, Gradle bağımlıları olarak ekleyin. Yeni bir bağımlılık eklemek için Ekle simgesini, 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 ve gerekirse bekleyen hataları düzeltmek için Derle > Proje Yap'ı tıklayın.

Özel bir Gradle derleme dosyası oluşturarak taşıyın

Mevcut kaynak dosyalarınıza 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 projenin içeriğini yerinde değiştirdiğinden başlamadan önce proje dosyalarınızı ayrı bir konumda yedekleyin.
2. Proje dizininizde Groovy kullanıyorsanız build.gradle adlı, Kotlin komut dosyasını 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.

   

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

   Eski

     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'den itibaren 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 uygun değilse dosyaları olması gereken yere taşıyabilir veya Gradle'ın bunları nerede bulacağını bilmesi için varsayılan kaynak gruplarını değiştirebilirsiniz.

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

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

   Gradle sayesinde bu kitaplıkları artık kaynak kod projesi olarak eklemeniz gerekmez. Bunun yerine, derleme dosyanızın dependencies{} bloğunda bunlara başvurabilirsiniz. Daha sonra derleme sistemi, kitaplık indirme, kaynakları ve manifest girişlerini birleştirme gibi işlemleri sizin için yapar. Aşağıdaki örnekte bazı AndroidX kitaplıkları için bildirim ifadeleri, bir derleme dosyasının dependencies{} bloğuna eklenmiştir.

   Eski

   ...
   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   
       // AndroidX libraries
       implementation 'androidx.core:core-ktx:1.13.1'
       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.8.0'
   
       // 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.13.1")
       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.8.0")
   
       // 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ızla ilgili doğru beyan ifadelerini belirleme konusunda yardım almak için Google Maven deposunda veya Maven Central'da arama yapın.
4. build.gradle dosyanızı kaydedin ve ardından IntelliJ'de projeyi kapatın. Proje dizininize giderek .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 oluşturarak derleme dosyanızı test etmek ve bulduğunuz hataları gidermek için Derle > Proje Yap'ı tıklayın.

Sonraki adımlar

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

Projenize ve iş akışınıza bağlı olarak, sürüm denetimi, 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 Meet Android Studio'yu okuyun.

Sürüm denetimini yapılandırın

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ünden Sürüm Denetimi Entegrasyonunu Etkinleştir'i tıklayıp 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, Sürüm Denetimi Entegrasyonunu Etkinleştir'i tıklayın.
2. Menüden proje köküyle ilişkilendirilecek sürüm kontrol sistemini seçin ve ardından Tamam'ı tıklayın. VCS menüsü artık seçtiğiniz sisteme göre çeşitli sürüm kontrolü seçenekleri görüntüler.

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ı sayfasına bakın.

Uygulama imzalama

Daha önce kullanılan hata ayıklama sertifikası, içe aktarma işlemi sırasında tespit edilebilir. Bu durumda Android Studio bu sertifikaya referansta bulunmaya devam eder. Aksi takdirde, hata ayıklama yapılandırması, bilinen bir şifre ve $HOME/.android/debug.keystore konumunda bulunan bilinen bir şifreye sahip varsayılan bir anahtar kullanan Android Studio tarafından oluşturulan hata ayıklama anahtar deposunu kullanır. Hata ayıklama derleme türü, Android Studio'dan projenizi ç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. Daha önce herhangi bir sürüm sertifikası tanımlanmamışsa sürüm imzalama yapılandırmasını build.gradle veya build.gradle.kts dosyasına ekleyin veya İmzalanmış APK Sihirbazı Oluştur'u açmak için 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 ayarlama

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 eklentisinden, derleme araçlarından ve SDK araçlarından ayrı olarak güncellenir. Android Studio ile kullanmak istediğiniz sürümleri belirtebilirsiniz.

Varsayılan olarak Android Studio 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ümlerini 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 konusunu okuyun.