Projelere genel bakış

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

Yeni bir proje başlattığı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.

Bu sayfada, projenizdeki temel bileşenlere genel bir bakış sunulur.

Modüller

Modül, birçok görevi yerine getiren kaynak dosyalar ve projenizi ayrı işlev birimlerine bölmenize olanak tanır. Projenizde bir veya daha fazla modül olabilir ve bir modül, başka bir modülü bağımlılık olarak kullanabilir. Her modülü bağımsız olarak derleyebilir, test edebilir ve hata ayıklayabilirsiniz.

Ek modüller, oluşturmak istediğinizde veya kendi projenizde farklı kod ve kaynak telefon ve giyilebilir cihazlar gibi farklı cihaz türlerini, ancak tüm dosyaları aynı projenin kapsamına alın ve bazı kodlar paylaşın.

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 uygulaması modülü
Uygulamanızın kaynak kodunu, kaynak dosyalarını ve uygulama düzeyindeki ayarları modül düzeyinde derleme dosyası ve Android manifest dosyası olarak kaydedin. Zaman yeni bir proje oluşturduğunuzda varsayılan uygulama modülünün adı "uygulama" olur.

Android Studio teklifleri aşağıdaki uygulama modülü türleri:

  • Telefon ve Tabletler
  • Automotive
  • Wear OS
  • Televizyon
  • Referans Profil Oluşturucu
  • Karşılaştırma

Her modül, ilgili uygulama veya cihaz türüne uygun temel dosyaları ve bazı kod şablonlarını sağlar.

Modül ekleme hakkında daha fazla bilgi edinmek için Yeni cihaz için modül ekleme başlıklı makaleyi inceleyin.

Özellik modülü
. Uygulamanızın Play'den yararlanabilen modüler hale getirilmiş bir özelliğini temsil eder Özellik Dağıtımı. Örneğin, özellik modülleriyle kullanıcılarınıza, uygulamanızın belirli özellikleriyle istek üzerine veya hazır uygulama deneyimi Google Play Instant.

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 edinmek için Play Özellik Dağıtımı.

Kitaplık modülü
Yeniden kullanılabilir kodunuz için bir kapsayıcı sağlar. Bu bağımlılık olarak kullanabilir veya diğer bilgi edinmenizi sağlar. Kitaplık modülü yapısal olarak uygulama modülüyle aynıdır ancak derlendiğinde APK yerine kod arşivi dosyası oluşturur. Bu nedenle, cihaza yüklenemez.

Yeni Modül Oluştur penceresinde Android Studio, şu kitaplık modülü türleri:

  • Android Kitaplığı: Desteklenen tüm dosya türlerini içerir. bir Android projesinde yerel C++ kodu (Java ve Kotlin kaynak kodu dahil) hariç tutulur. kaynakları ve manifest dosyalarını içerir. Derleme sonucu, Android uygulama modüllerinize bağımlılık olarak ekleyebileceğiniz bir Android Arşivi (AAR) dosyasıdır.
  • Android Yerel Kitaplığı: Desteklenen tüm dosya türlerini içerir arasında yer alan içeriklerdir. Bununla birlikte, Android yerel Kitaplıkları da yerel C++ kaynak kodu içerebilir. Derleme sonucu, Android uygulama modüllerinize bağımlılık olarak ekleyebileceğiniz bir Android Arşivi (AAR) dosyasıdır.
  • Java veya Kotlin Kitaplığı: Yalnızca Kotlin veya Java kaynak dosyaları içerir. Derleme sonucu, Android uygulama modülleriniz veya diğer Kotlin ya da Java projeleriniz için bağımlılık olarak ekleyebileceğiniz bir Java Arşivi (JAR) dosyasıdır.

Gradle, modülleri proje olarak da adlandırdığı için modüllere bazen alt projeler denir.

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

Groovy

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

Kotlin

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

Proje dosyaları

Varsayılan olarak Android Studio, proje dosyalarınızı Android görünümü. 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 ve yaygın olarak kullanılmayan belirli dosyalar veya dizinler gizlenir.

Android görünümü ile Android görünümü aşağıdaki gibidir:

  • Projenin derlemeyle ilgili tüm yapılandırma dosyalarını üst düzey bir Gradle Komut Dosyası grubunda gösterir.
  • Farklı ürün aromaları ve derleme türleri için farklı manifest dosyalarınız varsa modül düzeyinde bir gruptaki her modülün tüm manifest dosyalarını gösterir.
  • Tüm alternatif kaynak dosyalarını, kaynak tanımlayıcısı başına ayrı klasörlerde değil, tek bir grupta gösterir. Örneğin, tüm yoğunluk sürümleri yan yana görünür.

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

manifests
AndroidManifest.xml dosyasını içerir.
Java
Paket adlarına göre ayrılmış, Kotlin ve Java kaynak kodu dosyalarını içerir, JUnit test kodunu içeren bir test programıdır.
Çözünürlük
Kullanıcı arayüzü dizeleri ve bit eşlem görüntülerinin yer aldığı alt dizinlere ayrılır. Olası kaynak türleri hakkında daha fazla bilgi için Uygulama kaynaklarına genel bakış başlıklı makaleyi inceleyin.
ziyaret edin.
'nı inceleyin.

Proje görünümü

Asıl projenin dosya yapısını, Android görünümündeyken menüden Proje'yi seçin Proje penceresinin üst tarafında yer alır.

Proje görünümünü seçtiğinizde çok daha fazla dosya görebilirsiniz ve dizinler içerir:

module-name/
build/
Derleme çıkışları içerir.
libs/
Özel kitaplıklar içerir.
src/
Aşağıda belirtilen modülün tüm kod ve kaynak dosyalarını içerir alt dizinler:
androidTest/
Android cihazda çalıştırılan araç testlerine ait kodu içerir. Daha fazla bilgi için Android Studio'da test etme başlıklı makaleyi inceleyin.
cpp/
Java Yerel Arayüzü (JNI) kullanarak yerel C veya C++ kodu içerir. Daha fazla bilgi için bkz. Android NDK dokümanlarını inceleyin.
main/
"Ana" kelimesini içerir kaynak grubu dosyaları: Android kodu ve kaynaklar Tüm derleme varyantları (diğer derleme varyantları için dosyalar) tarafından paylaşılan yardımcı dizinlerde, örneğin src/debug/ hata ayıklama derleme türü):
AndroidManifest.xml
Uygulamanın ve bileşenlerinin özelliklerini açıklar. Daha fazla bilgi için uygulama manifest dosyasına genel bakış bölümünü inceleyin.
java/
Uygulamanızda hem Kotlin hem de Java varsa Kotlin veya Java kodu kaynaklarını ya da ikisini birden içerir kaynak kodudur.
kotlin/
Yalnızca Kotlin kod kaynaklarını içerir.
res/
Çizilebilir dosyalar ve kullanıcı arayüzü dize dosyaları gibi uygulama kaynaklarını içerir. Daha fazla daha fazla bilgi için uygulama kaynaklarına genel bakış.
assets/
APK dosyasına olduğu gibi derlenecek dosyaları içerir. Örneğin, bu dizin, dokular ve oyun verileri için iyi bir yerdir. Şunları yapabilirsiniz: normal bir dosya sistemiyle aynı şekilde bu dizinde gezinebilirsiniz. URI'lar oluşturabilir ve dosyaları AssetManager
test/
Barındırıcı JVM'nizde çalıştırılan yerel testlerin kodunu içerir.
build.gradle veya build.gradle.kts (modül)
Modüle özel derleme yapılandırmalarını tanımlar. Derleme komut dosyası diliniz Groovy ise doğru dosya adı build.gradle, Kotlin komut dosyası kullanıyorsanız ise build.gradle.kts olmalıdı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. build.gradle derleme komut dosyası diliniz olarak Groovy'yi kullanıyorsanız doğru dosya adını Kotlin komut dosyasını kullanıyorsanız build.gradle.kts. Bu dosya projenin ayrılmaz bir parçasıdır, bu nedenle dosyayı güncel tutun diğer tüm kaynak kodlarıyla düzeltme kontrolünde kullanın.

Diğer derleme dosyaları hakkında bilgi edinmek için Derlemenizi yapılandırma başlıklı makaleyi inceleyin.

Proje yapısı ayarları

Android Studio projenizin çeşitli ayarlarını değiştirmek için Dosya > Proje Yapısı'nı tıklayarak Proje Yapısı iletişim kutusunu açın. Bu dokümanda aşağıdaki bölümler yer alır:

  • Proje: Gradle ve Android Gradle eklentisinin sürümünü ve depolama alanı konumu adını belirler.
  • SDK Konumu: JDK'nın, Android SDK'nın, Android NDK'yı da kullanabilirsiniz.
  • Değişkenler: Derlemenizde kullanılan değişkenleri düzenlemenizi sağlar. komut dosyaları.
  • Modüller: Modüle özgü derlemeyi düzenlemenizi sağlar dahil olmak üzere tüm yapılandırmalara ve yapılandırmalara ve kitaplık bağımlılıklarını anlamasına yardımcı olur. Her modülün ayarlar sayfası aşağıdaki sekmelere ayrılmıştır:
    • Özellikler: SDK ve derlemenin sürümlerini belirtir .
    • İmza: Uygulamanızı imzalamak için kullanılacak sertifikayı belirtir.
  • Bağımlılıklar: Bu modülün kitaplık, dosya ve modül bağımlılıklarını listeler. Bağımlılıkları ekleyebilir, değiştirebilir ve silebilirsiniz tıklayın. Modül bağımlılıkları hakkında daha fazla bilgi için Derleme varyantlarını yapılandırın.

  • Varyant Derleme: Farklı aroma ve derleme türleri yapılandırmanızı sağlar belirleneceğini konuşacağız.

    • Aroma: Birden fazla derleme arosu oluşturmanıza olanak tanır. her aroma, bir dizi yapılandırma ayarını belirtir. Örneğin, modülünün minimum ve hedef SDK sürümü ile sürüm kodu ve sürüm adını kullanın.

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

    • Derleme Türleri: Derlemeyi oluşturmanızı ve değiştirmenizi sağlar Derleme varyantlarını yapılandırma bölümünde açıklandığı gibi yapılandırmaları içerir. Varsayılan olarak her modülde hata ayıklama ve sürüm derleme türleri bulunur. Gerekirse daha fazlasını da tanımlayabilirsiniz.