Hızlı rehber: Projeyi açın ve yapıyı düzene sokun
Kısa cevap: build.gradle dosyasının bulunduğu klasörü Open ile açın, Gradle senkronizasyonunu gerçekleştirin, modüller için settings.gradle dosyasını (include/ includeBuild) düzenleyin ve Project Structure / sourceSets ile Build Variants ayarlarını yapın — aşağıda adım adım açıklamalar ve yaygın sorunların çözümleri yer almaktadır.
Android Studio'da proje nasıl açılır
- Gerekirse depoyu klonlayın: git clone
komutunu çalıştırın ve proje kök dizinine geçin. - Android Studio'da: File > Open veya başlangıç ekranındaki Open seçeneğine tıklayın → build.gradle dosyasının bulunduğu klasörü belirtin (genellikle kök dizin veya app modülü).
- Gradle içe aktarmayı onaylayın — otomatik senkronizasyon başlamazsa Sync Now butonuna tıklayın.
- JDK ve Android SDK'yı kontrol edin: File > Project Structure > SDK Location — modern projeler için JDK 17+ sürümünü belirtin. Tools > SDK Manager — gerekli platformları ve Build Tools'u yükleyin.
- Derleme hataları durumunda: View > Tool Windows > Build menüsünü açın ve stacktrace'i inceleyin; yaygın çözüm adımları: File > Invalidate Caches / Restart, .gradle klasörünü silin ve senkronizasyonu tekrarlayın.
Projeyi boşluk ve Kiril alfabesi karakterleri içermeyen bir yolda tutun — bu, Gradle ve yol sorunlarının çoğunu çözer.
settings.gradle değiştirme: Ne ve nasıl
Kök dizindeki settings.gradle (veya settings.gradle.kts) dosyası, projenin modüllerini ve derleme fork'larını tanımlar.
Örnek (Groovy):
rootProject.name = "MyApp"
include ':app', ':mylibrary'
includeBuild('../local-repo') // yerel derleme deposunu bağlama
Modül ekleme yöntemi:
- Modül klasörü oluşturun (örneğin mylibrary/) ve içinde build.gradle dosyası bulundurun.
- settings.gradle dosyasına include ':mylibrary' veya iç içe modüller için include(':feature:auth') ekleyin.
- Gradle senkronizasyonunu gerçekleştirin.
Kotlin DSL kullanıyorsanız, sözdizimi benzer olacaktır ancak Kotlin ifadeleriyle yazılacaktır.
Senkronizasyon tamamlanmadan settings.gradle dosyasını düzenlemeyin ve projeyi kapatmayın — IDE yeni modülleri tanımayabilir ve "Module not found" hatası verebilir.
Çalışma ve ölçeklendirme için proje yapısı yapılandırması
Temel yapı: app/src/main/java, res, AndroidManifest.xml. Kullanım kolaylığı ve performans için öneriler:
- View: manifests, java/kotlin ve res arasında kolay gezinme için sol üst panelde Android view seçeneğine geçin.
- Source sets: Module Settings > Sources — gerekirse ek sourceSet ekleyin (örneğin sharedTest).
- Product flavors: Module Settings > Flavors — örnek:
free {
applicationIdSuffix ".free"
}
- Build variants: Build Variants penceresini açın ve Debug/Release veya flavorVariants arasında geçiş yapın.
- Çoklu modül: Ortak katmanları core/ui ve core/network olarak ayırın; feature modülleri paralel derleme ve test işlemlerini kolaylaştırır.
- Performans: gradle.properties dosyasında şunları kullanın:
org.gradle.parallel=true
org.gradle.caching=true
org.gradle.jvmargs=-Xmx4g
android.useAndroidX=true
- Gradle 8+ için VERSION_CATALOGS özelliğini etkinleştirin: settings.gradle dosyasına enableFeaturePreview("VERSION_CATALOGS") ekleyin.
Önerilen yapı örneği
| Öğe | Amaç | Ne zaman kullanılır |
|---|---|---|
| app | Ana APK | Her zaman |
| feature/* | Ayrı ekranlar/özellikler | >10 ekran veya bağımsız mantık |
| core/* | Yeniden kullanılabilir kütüphaneler (network, ui) | Ortak bileşenler |
| buildSrc/ | Özel Gradle eklentileri | Karmaşık derleme mantığı |
SDK Manager aracılığıyla SDK ve Build Tools'u güncelleyin (2026 için API 35+) ve güncellemeden sonra bağımlılıkları senkronize etmeyi unutmayın.
Sık karşılaşılan hatalar
- "Could not find method compile()" — deprecated konfigürasyonlar yerine implementation/ api kullanın.
- Modüller görünmüyor — settings.gradle dosyasındaki include ifadelerini kontrol edin ve Sync işlemini çalıştırın.
- Uzun süren Gradle senkronizasyonu — gradle.properties dosyasında önbellekleme ve paralellik özelliklerini etkinleştirin ve heap boyutunu artırın.
- JDK sorunları — Project Structure > SDK Location bölümünde doğru sürümü belirtin.
SSS
- Feature modülünü hızlıca nasıl eklerim?
- feature/isim klasörü oluşturun, build.gradle ekleyin, settings.gradle dosyasına include ':feature:isim' satırını ekleyin ve senkronize edin.
- "Gradle sync failed" hatası alırsam ne yapmalıyım?
- Derleme logunu inceleyin, Invalidate Caches deneyin, JDK/SDK'yı kontrol edin ve proje kök dizinindeki .gradle klasörünü silin.
- buildSrc kullanmam gerekir mi?
- Çok sayıda tekrarlayan Gradle mantığınız veya özel eklentileriniz varsa evet — aksi takdirde version catalogs ve ortak gradle.properties dosyası yeterlidir.
Bu adımlarla projeniz doğru şekilde açılacak, modüller yapılandırılacak ve yapı ölçeklendirmeye ve hızlı geliştirmeye hazır hale gelecektir. Başarılı derleme ve testler dileriz!