Projelere genel bakış

Android Studio'daki projeler, kaynak kodu ve öğelerden test kodu ve derleme yapılandırmalarına kadar bir uygulama için çalışma alanınızı tanımlayan her şeyi içerir.

Yeni bir projeye başladığınızda Android Studio tüm dosyalarınız için gerekli yapıyı oluşturur ve bunları Android Studio'daki Proje penceresinde görünür hale getirir. Pencereyi açmak için Görünüm> Araç Pencereleri > Proje'yi seçin.

Bu sayfa, projenizdeki temel bileşenlere genel bir bakış sunar.

Modüller

Modül, projenizi farklı işlev birimlerine bölmenize olanak tanıyan kaynak dosyalar ve derleme ayarlarından oluşan bir koleksiyondur. Projenizde bir veya daha fazla modül bulunabilir ve bir modül bağımlılık olarak başka bir modülü kullanabilir. Her modülü bağımsız olarak derleyebilir, test edebilir ve hatalarını ayıklayabilirsiniz.

Ek modüller, kendi projenizde kod kitaplıkları oluştururken veya telefon ve giyilebilir cihazlar gibi farklı cihaz türleri için farklı kod ve kaynak grupları oluşturmak, ancak tüm dosyaları aynı projenin kapsamında tutmak ve bir miktar kod paylaşmak istediğinizde kullanışlıdır.

Projenize yeni bir modül eklemek için Dosya > Yeni > Yeni Modül'ü tıklayın.

Android Studio birkaç farklı modül türü sunar:

Android uygulama modülü

Uygulamanızın kaynak kodu, kaynak dosyaları ve uygulama düzeyindeki ayarlar (ör. modül düzeyindeki derleme dosyası ve Android Manifest dosyası) için bir kapsayıcı sağlar. Yeni bir proje oluşturduğunuzda varsayılan uygulama modülü "app" (uygulama) olarak adlandırılır.

Android Studio aşağıdaki uygulama modülü türlerini sunar:

• Telefon ve Tablet
• Otomotiv
• Wear OS
• Televizyon
• Temel Profil Oluşturma Aracı
• Karşılaştırma

Her modülde ilgili uygulama veya cihaz türü için uygun olan temel dosyalar ve bazı kod şablonları sunulur.

Modül ekleme hakkında daha fazla bilgi için Yeni bir cihaz için modül ekleme bölümünü okuyun.

Özellik modülü

Uygulamanızın Play Feature Delivery'den yararlanabilecek modüler bir özelliğini temsil eder. Örneğin, özellik modülleriyle kullanıcılarınıza uygulamanızın belirli özelliklerini isteğe bağlı olarak veya Google Play Instant aracılığıyla hazır deneyim olarak sunabilirsiniz.

Android Studio, aşağıdaki özellik modülü türlerini sunar:

• Dinamik Özellik Modülü
• Anında Dinamik Özellik Kitaplığı Modülü

Daha fazla bilgi için Play Feature Delivery makalesini inceleyin.

Kitaplık modülü

Yeniden kullanılabilir kodunuz için bir kapsayıcı sağlar. Bu container'ı başka uygulama modüllerinde bağımlılık olarak kullanabilir veya başka projelere aktarabilirsiniz. Yapısal olarak kitaplık modülü, uygulama modülüyle aynıdır ancak oluşturulduğunda APK yerine bir kod arşiv dosyası oluşturur. Bu nedenle, bir cihaza yüklenemez.

Yeni Modül Oluştur penceresinde, Android Studio aşağıdaki kitaplık modülü türlerini sunar:

• Android Kitaplığı: Java ve Kotlin kaynak kodu, kaynaklar ve manifest dosyaları dahil olmak üzere yerel C++ kodu hariç, Android projesinde desteklenen tüm dosya türlerini içerir. Derleme sonucu, Android uygulama modülleriniz için bağımlılık olarak ekleyebileceğiniz bir Android Arşiv (AAR) dosyası olur.
• Android Yerel Kitaplık: Android Kitaplığı'na benzer şekilde, Android projesinde desteklenen tüm dosya türlerini içerir. Ancak Android Yerel Kitaplıkları yerel C++ kaynak kodunu da içerebilir. Derleme sonucu, Android uygulama modüllerinize bağımlılık olarak ekleyebileceğiniz bir Android Arşiv (AAR) dosyası olur.
• Java veya Kotlin Kitaplığı: Yalnızca Kotlin veya Java kaynak dosyalarını içerir. Derleme sonucu, Android uygulama modülleriniz veya diğerKotlin ya da Java projeleriniz için bağımlılık olarak ekleyebileceğiniz bir Java Arşiv (JAR) dosyası olur.

Gradle, modüllerden proje olarak da bahsedildiğinden modüller bazen alt projeler olarak da adlandırılır.

Bir kitaplık modülü oluşturduğunuzda ve bunu Android uygulama modülünüze bağımlılık olarak eklemek istediğinizde bunu aşağıdaki gibi bildirmeniz gerekir:

Modern

dependencies {
    implementation project(':my-library-module')
}

Kotlin

dependencies {
    implementation(project(":my-library-module"))
}

Proje dosyaları

Android Studio, varsayılan olarak proje dosyalarınızı Android görünümünde gösterir. Bu görünüm, diskteki gerçek dosya hiyerarşisini yansıtmaz. Bunun yerine, projenizin önemli kaynak dosyaları arasında gezinmeyi kolaylaştırmak için modüllere ve dosya türlerine göre düzenlenir. Böylece, yaygın olarak kullanılmayan belirli dosya veya dizinleri gizlenir.

Android görünümü ile disk üzerindeki yapı arasındaki yapısal farklılıklardan bazıları Android görünümüdür:

• Projenin derlemeyle ilgili tüm yapılandırma dosyalarını üst düzey bir Gradle Komut Dosyası grubunda gösterir.
• Farklı ürün çeşitleri ve derleme türleri için farklı manifest dosyalarınız olduğunda modül düzeyindeki bir grupta her bir modülün tüm manifest dosyalarını gösterir.
• Kaynak niteleyici başına ayrı klasörlerde olmak yerine tüm alternatif kaynak dosyalarını tek bir grupta gösterir. Örneğin, başlatıcı simgenizin tüm yoğunluk sürümleri yan yana görünür.

Her bir Android uygulama modülünde, dosyalar aşağıdaki gruplarda gösterilir:

manifestler

AndroidManifest.xml dosyasını içeriyor.

Java

JUnit test kodu dahil olmak üzere paket adlarıyla ayrılmış Kotlin ve Java kaynak kodu dosyalarını içerir.

çözünürlük

İlgili alt dizinlere bölünmüş kullanıcı arayüzü dizeleri ve bit eşlem görüntüleri gibi kod dışı tüm kaynakları içerir. Olası kaynak türleri hakkında daha fazla bilgi için Uygulama kaynaklarına genel bakış bölümüne bakın.

Not: Farklı modül türlerinin farklı grup yapıları vardır. Örneğin, yerel bir modül main grubu içinde bir cpp/ klasörü de içerir ve Kotlin veya Java kitaplığı manifests veya res grupları içermez.

Proje görünümü

Android görünümünde gizlenmiş tüm dosyalar dahil olmak üzere projenin gerçek dosya yapısını görmek için Proje penceresinin üst kısmındaki menüden Proje'yi seçin.

Proje görünümünü seçtiğinizde aşağıdakiler de dahil olmak üzere çok daha fazla dosya ve dizin görebilirsiniz:

module-name/

build/

Derleme çıktılarını içerir.

libs/

Özel kitaplıklar içeriyor.

src/

Aşağıdaki alt dizinlerde bulunan modülle ilgili tüm kod ve kaynak dosyalarını içerir:

androidTest/

Android cihazlarda çalıştırılan araç testlerine yönelik kod içerir. Daha fazla bilgi için Android Studio'da test etme bölümüne bakın.

cpp/

Java Yerel Arayüzü (JNI) kullanan yerel C veya C++ kodu içerir. Daha fazla bilgi için Android NDK dokümanlarına bakın.

main/

"Ana" kaynak kümesi dosyalarını içerir: Tüm derleme varyantları tarafından paylaşılan Android kodu ve kaynaklar (diğer derleme varyantlarının dosyaları, hata ayıklama derleme türü için src/debug/ gibi eşdüzey dizinlerde bulunur):

AndroidManifest.xml

Uygulamanın ve her bir bileşeninin yapısını açıklar. Daha fazla bilgi için uygulama manifestine genel bakışı inceleyin.

java/

Uygulamanız hem Kotlin hem de Java kaynak koduna sahipse Kotlin veya Java kod kaynakları ya da her ikisini içeriyor.

kotlin/

Yalnızca Kotlin kod kaynaklarını içerir.

res/

Çekilebilir dosyalar ve kullanıcı arayüzü dize dosyaları gibi uygulama kaynakları içerir. Daha fazla bilgi için uygulama kaynaklarına genel bakış sayfasını inceleyin.

assets/

Bir APK dosyası olarak derlenecek dosyaları içerir. Örneğin, dokular ve oyun verileri için iyi bir konumdur. URI'ları kullanarak bu dizinde normal bir dosya sistemiyle aynı şekilde gezinebilir ve AssetManager ile dosyaları bayt akışı olarak okuyabilirsiniz.

test/

Ana makinenizin JVM'sinde çalışan yerel testler için kod içerir.

build.gradle veya build.gradle.kts (modül)

Modüle özel derleme yapılandırmalarını tanımlar. Derleme komut dosyası diliniz olarak Groovy kullanıyorsanız build.gradle doğru dosya adıdır. Kotlin komut dosyası kullanıyorsanız bu ad build.gradle.kts'tır.

build.gradle veya build.gradle.kts (proje)

Bu, tüm modüller için geçerli olan derleme yapılandırmanızı tanımlar. Derleme komut dosyası diliniz olarak Groovy kullanıyorsanız build.gradle doğru dosya adıdır. Kotlin komut dosyası kullanıyorsanız bu ad build.gradle.kts olur. Bu dosya projenin ayrılmaz bir parçasıdır. Bu nedenle, dosyayı diğer tüm kaynak kodlarıyla düzeltme kontrolünde tutun.

Diğer derleme dosyaları hakkında bilgi edinmek için Derlemenizi yapılandırma bölümüne bakın.

Not: Varsayılan görünümü Android görünümünden Proje görünümüne değiştirmek için Yardım > Özel Özellikleri Düzenle'yi seçin ve studio.projectview=true öğesini ekleyin.

Proje yapısı ayarları

Android Studio projeniz için çeşitli ayarları değiştirmek üzere Dosya > Proje Yapısı'nı tıklayarak Proje Yapısı iletişim kutusunu açın. Aşağıdaki bölümleri içerir:

• Proje: Gradle ve Android Gradle eklentisi için sürümü ve depo konumu adını ayarlar.
• SDK Konumu: Projenizin kullandığı JDK, Android SDK ve Android NDK'nın konumunu ayarlar.
• Değişkenler: Derleme komut dosyalarınızda kullanılan değişkenleri düzenlemenizi sağlar.
• Modüller: Hedef ve minimum SDK, uygulama imzası ve kitaplık bağımlılıkları dahil modüle özel derleme yapılandırmalarını düzenlemenizi sağlar. Her modülün ayarlar sayfası aşağıdaki sekmelere ayrılır:
  • Properties: SDK'nın sürümlerini ve modülü derlemek için kullanılacak derleme araçlarını belirtir.
  • İmzalama: Uygulamanızı imzalamak için kullanılacak sertifikayı belirtir.

• Bağımlılıklar: Bu modül için kitaplık, dosya ve modül bağımlılıklarını listeler. Bu bölmeden bağımlılıkları ekleyebilir, değiştirebilir ve silebilirsiniz. Modül bağımlılıkları hakkında daha fazla bilgi için Derleme varyantlarını yapılandırma bölümüne bakın.

  Önizleme: Sürüm kataloğu kullanıyorsanız Proje Yapısı iletişim kutusu aracılığıyla eklenen bağımlılıkların kataloğa değil, modülün build.gradle dosyasına eklenmesi sorununa dikkat edin. Android Studio'da Gradle Sürüm Katalogları desteği hakkında daha fazla bilgi edinmek için önizleme sürüm notuna bakın.

• Varyant Oluşturma: Projeniz için farklı tatlar yapılandırmanıza ve türleri oluşturmanıza olanak tanır.

  • Bilgiler: Birden fazla derleme çeşiti oluşturmanıza olanak tanır. Burada her bir aroma, modülün minimum ve hedef SDK sürümü ile sürüm kodu ve sürüm adı gibi bir dizi yapılandırma ayarını belirtir.

    Örneğin, minimum SDK 21 ve hedef SDK 29 olan bir aroma, minimum SDK 24 ve hedef SDK 33 olan başka bir aroma tanımlayabilirsiniz.

  • Derleme Türleri: Derleme varyantlarını yapılandırma bölümünde açıklandığı gibi, derleme yapılandırmaları oluşturmanıza ve değiştirmenize olanak tanır. Varsayılan olarak her modülde debug ve version derleme türü bulunur. Gerektiğinde daha fazla derleme türü tanımlayabilirsiniz.