Modül İçindeki Paketleri Düzenleme

Bir paket, ilişkili Kotlin dosyalarını noktalı bir ad altında gruplar. İyi paketler, büyüyen paylaşılan modülde gezinmeyi kolaylaştırır. 📁

Her dosya bir paket satırıyla başlar. Yapının herkes için öngörülebilir kalması adına bu satır klasör yolunu yansıtmalıdır.

Türe göre gruplamak yerine özelliğe göre gruplamayı tercih edin. Bir sepet paketi kendi modelini, mantığını ve yardımcılarını tek yerde tutar.

Temiz bir ayrımda alan saf modeller ve kurallar içindir; veri ise ağ iletişimi ve depolama içindir. Sınır, her kısmın odağını korur.

Paketlere com.acme.shared gibi bir ters alan adı ile başlayın. Bu, kodunuzun kütüphane paketleriyle çakışmasını önler.

Klasör ağacını paket adlarıyla eşleşecek şekilde tutun. Eşleştiklerinde herkes bir sınıfı yalnızca tam adına bakarak bulabilir.

Açığa çıkardığınız türleri com.acme.shared.api gibi belirgin bir public pakete koyun. Böylece çağıranların bakacağı tek bir yer olur.

Yardımcıları .impl veya .util gibi bir internal pakette tutun. Ad, çağıranların bu alana girmemesi gerektiğini ilk bakışta belirtir.

Sonsuz iç içe geçirmeden kaçının. Birkaç açık paketten oluşan sığ bir ağaç, on katmanlı küçük klasörlerden daha kolay taranır.

commonMain, androidMain ve iosMain içinde aynı paket düzenini kullanın. Eşleşen yollar, expect ve actual çiftlerini fark etmeyi kolaylaştırır.

Paket listenizi baştan sona okuyun. Yalnızca adlar, modülün ne yaptığını ve her sorumluluğun nerede bulunduğunu açıklayabilmelidir.

Özelliğe veya katmana göre gruplayın, klasörleri paketlerle eşleştirin, yapıyı sığ tutun ve iç yapıları gizleyin. Açık bir ağaç, modül büyüdükçe ölçeklenir. 🎉