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.
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
veyabuild.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 isebuild.gradle.kts
olmalıdır.
build.gradle
veyabuild.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ızbuild.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.
-