Projelere genel bakış

Android Studio'da bir proje, kaynak kodundan öğelerden kod testine ve derlemeye kadar, uygulama için çalışma alanı yapılandırmanın üç yolu vardır.

Yeni bir projeye başladığınızda, Android Studio gerekli yapısı hakkında daha fazla bilgi edinin ve bunları Proje penceresi açılır. Pencereyi açmak için Görünüm > Araç Pencereleri > Proje.

Bu sayfada projenizdeki temel bileşenlere genel bir bakış sunulmaktadır.

Modüller

Modül, birçok görevi yerine getiren kaynak dosyalar ve projenizi ayrı işlev birimlerine bölmenize olanak tanır. Sizin proje bir veya daha fazla modüle sahip olabilir ve bir modülde desteklenmektedir. 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
• Temel Profil Oluşturucu
• Karşılaştırma

Her modülde ilgili uygulama veya cihaz türüne uygun olmamalıdır.

Modül ekleme hakkında daha fazla bilgi için Yeni cihaz için modül ekleyin.

Özellik modülü

Uygulamanızın Play Özellik Dağıtımı'ndan yararlanabilen modüler bir özelliğini temsil eder. Ö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 Feature Delivery hakkındaki makaleyi inceleyin.

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 bir kod arşiv dosyası oluşturduğundan cihaz.

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, bir bağımlılık.
• Android Yerel Kitaplığı: Desteklenen tüm dosya türlerini içerir bir Android projesinde depolanıyor. Ancak Android Native Libraries, yerel C++ kaynak kodu da içerebilir. Derlemenin sonucu, Android Arşivi (AAR) dosyası olarak ve Android uygulama modülleriniz için bağımlılık olarak ekleyin.
• Java veya Kotlin Kitaplığı: Yalnızca Kotlin veya Java kaynak dosyalarını içerir. Derleme sonucu, şu şekilde ekleyebileceğiniz bir Java Arşivi (JAR) dosyasıdır: Android uygulama modülleriniz veya diğer Kotlin ya da Java projeleriniz için bir bağımlılık.

Modüller bazen alt proje olarak adlandırılır çünkü Gradle, modülleri proje olarak da adlandırır.

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:

Eski

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 yansıtılmaz yardımcı olur. 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üzeyde gösterir Gradle Komut Dosyası grubu.
• Aşağıdaki işlemleri gerçekleştirdiğinizde modül düzeyindeki bir gruptaki her modülün tüm manifest dosyalarını gösterir ve derleme türleri için farklı manifest dosyaları bulunuyor.
• 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:

manifestler

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. Okuyucu Gelirleri Yöneticisi'ni Olası kaynak türleri hakkında bilgi için Uygulama kaynaklarına genel bakış bölümüne bakın.

Not: Farklı modül türleri, farklı grup yapılarına sahiptir. Örneğin, örnek olarak, yerel bir modül main içinde bir cpp/ klasörü de içerir grubu ve Kotlin veya Java kitaplığı manifests ya da res değerini içermeyen tıklayın.

Proje görünümü

Android görünümünde gizlenen tüm dosyalar da 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 çok daha fazla dosya görebilirsiniz ve dizinler içerir:

module-name/

build/

Derleme çıkışları içerir.

libs/

Özel kitaplıklar içeriyor.

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 Android NDK belgelerine bakın.

main/

"Ana" alt 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 manifesti genel bakış.

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/

Çekilebilir dosyalar ve kullanıcı arayüzü dize dosyaları gibi uygulama kaynakları içerir. Daha fazla bilgi için uygulama kaynaklarına genel bakış bölümüne bakın.

assets/

APK dosyası olarak derlenecek dosyaları olduğu gibi içerir. Örneğin, dokular ve oyun verileri için iyi bir konumdur. Şunları yapabilirsiniz: normal bir dosya sistemiyle aynı şekilde bu dizinde gezinebilirsiniz. URI'lar oluşturabilir ve dosyaları AssetManager

test/

Ana makinenizin JVM'sinde çalıştırılan yerel testlere ait kodu içerir.

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

Modüle özel derleme yapılandırmalarını tanımlar. build.gradle ve bu da dosya adlandırma dili olarak Groovy'yi kullanıyorsanız Kotlin komut dosyasını kullanıyorsanız build.gradle.kts.

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 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 bkz. Derlemenizi yapılandırın.

Not: Varsayılan görünümü Android görünümünden Proje görünümündeyken Yardım > Özel Özellikleri Düzenle ve studio.projectview=true öğesini ekleyin.

Proje yapısı ayarları

Android Studio projenize ilişkin çeşitli ayarları değiştirmek için Proje Yapısı iletişim kutusunu tıklayarak Dosya > Proje Yapısı. Belge, şu bölümlerden faydalanabilirsiniz:

• Proje: Gradle ve depo konumu adını ve Android Gradle eklentisini de ekleyebilirsiniz.
• SDK Konumu: JDK, Android SDK'nın konumunu ayarlar. 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 .
  • İmzalama: Aşağıdaki işlemler için kullanılacak sertifikayı belirtir: imzalayın: uygulamasını indirin.

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

  Ö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 eklendiğini unutmayın. Gradle sürümü katalogları hakkında daha fazla bilgi destek için bkz. sürüm notunu önizleyin.

• 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, etkisi büyük olan bir aroma en az 21, hedef SDK'sı 29 ve SDK minimum 24, hedef SDK sürümü 33 olmalıdır.

  • Derleme Türleri: Derleme oluşturmanıza ve değiştirmenize olanak tanır 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 release derleme türü hakkında daha fazla bilgi edinebilirsiniz.