Swift Academy · Ders

Değer Anlambilimi için API Tasarlama

Genel arayüzler ve çerçeveler tasarlarken struct ile class arasında seçim yapın.

Değer Anlambilimi için API Tasarlama, CoddyKit'te ücretsiz bir Swift Academy dersidir. Bu, 4 dersinin 4. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Swift Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Swift Academy kursu toplamda 4 dersten oluşur.

Hoş Geldiniz

Değer semantiği etrafında API'ler tasarlamak, öngörülebilir, iş parçacığı açısından güvenli ve kolayca sınanabilen kodlar ortaya çıkarır. Bu seçimi yapmaya yönelik ilkeleri ve örüntüleri inceleyelim.

Değer Semantiği Sözleşmesi

Bir tür şu durumlarda değer semantiğine sahiptir: • İki bağımsız kopya sonsuza dek bağımsız kalır • Bir kopyayı değiştirmek diğerini hiçbir zaman etkilemez • Tür `Int` gibi davranır — `a = b; a += 1`, `b`'yi değiştirmeden bırakır

Genel API'de Değer Döndüren Türleri Tercih Edin

```swift // Reference semantics — caller shares state: func getUser() -> UserClass { ... } // Value semantics — caller gets independent copy: func getUser() -> UserStruct { ... } ``` Değer döndüren türler, iç durumu dışarıdan yapılan değişikliklere karşı korur.

Değişmez Referans Türleri

Bir sınıf her zaman değişmez olduğunda değer türüne benzer davranış gösterir: ```swift final class Token { let value: String init(_ v: String) { value = v } // No mutable state — safe to share freely } ```

Sınıf Yerine Yapı Seçme Kontrol Listesi

Şu durumlarda yapıyı tercih edin: ✓ Tür kimliği değil veriyi modeller ✓ Kalıtıma ihtiyaç yoktur ✓ Örnekler paylaşılmamalı veya takma adlandırılmamalıdır ✓ Alan değerleri karşılaştırılarak eşitlenebilir ✓ Swift Eşzamanlılığı ile iyi çalışır (`Sendable`)

Sendable ve Değer Semantiği

Swift 6 Eşzamanlılığı, aktör sınırlarını aşan türlerin `Sendable` olmasını gerektirir: ```swift struct Message: Sendable { var text: String; var timestamp: Date } // Safe to pass between actors ``` Tüm Sendable özelliklere sahip değer türleri otomatik olarak `Sendable` olur.

Sınıf API'lerini Değer Açısından Güvenli Hâle Getirme

```swift struct Config { // Expose value snapshot instead of the class: func snapshot() -> Config { self } // copy by value semantics } // Or use a value-type DTO: struct UserDTO: Sendable { var id: UUID; var name: String } ```

Değer Türleriyle Oluşturucu Örüntüsü

```swift struct Request { var url: URL var method: String = "GET" var headers: [String:String] = [:] func adding(header: String, value: String) -> Request { var copy = self copy.headers[header] = value return copy } } let r = Request(url: url).adding(header: "Auth", value: "Bearer x") ```

API Belgeleme Sinyali

Yapı yerine sınıf seçmek, API'yi kullananlara net bir mesaj verir: • "Bu veridir — dilediğiniz gibi kopyalayın" • "Kopyanızı değiştirmeniz benimkini etkilemez" • "Bunu iş parçacıkları arasında güvenle aktarabilirsiniz" Bu, tüketici kodunda savunmacı kopyalama gereksinimini azaltır.

Referans Semantiğini Ne Zaman Kabul Etmeli?

Şu durumlarda sınıf/referans semantiğini kabul edin: • Kimlik önemlidir (`===`): iki `User` nesnesi aynı kişiyi temsil edebilir • Paylaşılan değiştirilebilir durum özelliğin kendisidir: `Database`, `Cache`, `AudioEngine` • Objective-C birlikte çalışabilirliği: UIKit, AppKit türleri sınıftır • Yaşam döngüsü geri çağrıları: kaynak temizliği için `deinit`

Hızlı Kontrol

Swift Eşzamanlılığı'nda bir türün aktör sınırları arasında güvenle geçirilebildiğini hangi Swift anahtar sözcüğü belirtir?

Özet

Temel çıkarımlar: • Değer semantiği: değişiklikler yereldir, takma adlandırma yoktur • Veri modelleri için yapıyı, kimlik/yaşam döngüsü için sınıfı tercih edin • Değişmez sınıflar değer türleri gibi davranır • `Sendable` + değer türleri = güvenli eşzamanlılık • Yapı kopyalarını kullanan oluşturucu örüntüsü, temiz ve değişmez API'ler oluşturur Kurs tamamlandı! Sırada: ARC ve bellek yönetimi örüntüleri.

Sıkça Sorulan Sorular

“Değer Anlambilimi için API Tasarlama” dersi ücretsiz mi?

Evet — “Değer Anlambilimi için API Tasarlama” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Swift Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Swift Academy kursu toplamda 4 dersten oluşur.

“Değer Anlambilimi için API Tasarlama” dersinde ne öğreneceğim?

Genel arayüzler ve çerçeveler tasarlarken struct ile class arasında seçim yapın. Swift Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

Swift Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te Swift Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 4. dersidir.

“Değer Anlambilimi için API Tasarlama” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu Swift Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Swift Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

Yığın ve Öbek: Değerler Nerede Yaşar
Değiştirme, Paylaşım ve Beklenmedik Takma Adlandırma
Karma Değer/Başvuru Grafikleri
Değer Anlambilimi için API Tasarlama

← Swift Academy Sayfasına Dön