<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by BU on Medium]]></title>
        <description><![CDATA[Stories by BU on Medium]]></description>
        <link>https://medium.com/@bu0609?source=rss-7879737541c9------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/proxy/1*TGH72Nnw24QL3iV9IOm4VA.png</url>
            <title>Stories by BU on Medium</title>
            <link>https://medium.com/@bu0609?source=rss-7879737541c9------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 08:07:16 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@bu0609/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[SwiftUI’da Sürdürülebilir Yerelleştirme: Modüler ve Tip Güvenli .xcstrings]]></title>
            <link>https://medium.com/@bu0609/swiftuida-s%C3%BCrd%C3%BCr%C3%BClebilir-yerelle%C5%9Ftirme-mod%C3%BCler-ve-tip-g%C3%BCvenli-xcstrings-760091587c43?source=rss-7879737541c9------2</link>
            <guid isPermaLink="false">https://medium.com/p/760091587c43</guid>
            <category><![CDATA[localization]]></category>
            <category><![CDATA[swiftui]]></category>
            <category><![CDATA[software-architecture]]></category>
            <category><![CDATA[clean-code]]></category>
            <category><![CDATA[ios-development]]></category>
            <dc:creator><![CDATA[BU]]></dc:creator>
            <pubDate>Wed, 21 Jan 2026 07:17:51 GMT</pubDate>
            <atom:updated>2026-01-21T07:17:51.370Z</atom:updated>
            <content:encoded><![CDATA[<h3>SwiftUI’da Sürdürülebilir Yerelleştirme: Modüler ve Tip Güvenli .xcstrings (String Catalogs) Mimarisi</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JeU6y0CuaZCIp2YdehWaJA.png" /></figure><p>Bir iOS geliştiricisi olarak projenin başında en masum görünen dosya genellikle Localizable dosyasıdır. Ancak proje büyüdükçe, özellikler eklendikçe ve ekip kalabalıklaştıkça bu dosya binlerce satırlık, yönetilmesi imkansız bir deve dönüşür.</p><p>Bu yazıda, standart tek dosya yaklaşımını bir kenara bırakıp;<br><strong>modüler, yönetilebilir ve tip güvenli (type-safe)</strong> bir Localizable mimarisini nasıl kuracağımızı inceleyeceğiz.</p><p>Bu yaklaşım table seviyesinde tip güvenliği sağlar.<br>Anahtar seviyesinde tam tip güvenliği isteniyorsa enum veya codegen çözümleri (SwiftGen, Xcode String Catalog code export) tercih edilebilir.<br>Ancak bu yazıda hedefimiz, <strong>boilerplate’i minimumda tutarak sürdürülebilirlik sağlamaktır.</strong></p><h3>Sorun: Tek Dosyanın Yarattığı Kaos</h3><p>Geleneksel yöntemde tüm metinler tek bir dosyada durur. Bu durum şu sorunları doğurur:</p><ol><li><strong>Karmaşık Anahtarlar:</strong> Çakışmayı önlemek için login_screen_welcome_text gibi uzun anahtarlar yazmak zorunda kalırsınız.</li><li><strong>Merge Conflict:</strong> Ekipteki herkes aynı dosyada çalıştığı için sürekli Git çakışmaları yaşanır.</li><li><strong>Bağlam Kaybı:</strong> “Title” kelimesi nerenin başlığı? Ana sayfa mı, ayarlar mı?</li></ol><h3>Çözüm: Modüler String Catalogs</h3><p>Çözüm basit: Localizable dosyalarını <strong>kullanım alanlarına göre</strong> parçalamak.</p><p>Bu yapıda, her modülün, akışın veya ekranın kendi .xcstrings dosyası olur. Ayrıca tüm uygulamada ortak kullanılan kelimeler (Tamam, İptal, Kaydet vb.) için bir Shared dosyası tutulur.</p><p>Dosya yapımız Xcode’da şöyle görünür:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/591/1*zscue--dH18057zZDKaQIw.png" /></figure><h3>Adım 1: Tip Güvenliği Sağlamak (Type-Safety)</h3><p>Dosyaları böldükten sonra, bu dosyalara erişirken string yazarak hata yapma riskini ortadan kaldırmalıyız. (&quot;LoginViewLocalizable&quot; yazarken harf hatası yapmak çok kolaydır.)</p><p>Bunu önlemek için dosya isimlerimizi bir enum içinde tanımlıyoruz:</p><pre>enum LocalizableTables: String {<br>    case shared = &quot;SharedLocalizable&quot;<br>    case loginView = &quot;LoginViewLocalizable&quot;<br>    case settingsView = &quot;SettingsViewLocalizable&quot;<br>}</pre><h3>Adım 2: String Extension ile Kolay Erişim</h3><p>SwiftUI içerisinde kullanımı pratikleştirmek için String sınıfına küçük bir extension yazıyoruz. Bu fonksiyon, parametre olarak oluşturduğumuz enum&#39;ı alacak ve doğru tablodan çeviriyi getirecek.</p><pre>extension String {<br>    func localized(table: LocalizableTables) -&gt; String {<br>        // tableName parametresi, hangi .xcstrings dosyasına bakılacağını belirler.<br>        return NSLocalizedString(self, tableName: table.rawValue, comment: &quot;&quot;)<br>    }<br>}</pre><h4>SwiftUI’nin Native Yerelleştirme API’si Neden Yeterli Değil?</h4><p>SwiftUI, yerelleştirme için halihazırda aşağıdaki gibi bir API sunar:</p><pre>Text(<br>    String(<br>        localized: &quot;welcome_text&quot;,<br>        table: &quot;LoginViewLocalizable&quot;<br>    )<br>)</pre><p>Bu yaklaşım teknik olarak doğrudur ve Apple tarafından desteklenir.</p><p>Ancak pratikte iki önemli dezavantajı vardır:</p><ul><li><strong>Table ismi hâlâ string olarak yazılır</strong> → yazım hatalarına açıktır</li><li>Kod okunabilirliği, enum tabanlı bir çözüme kıyasla düşüktür</li></ul><p>Bu yazıda tercih ettiğimiz enum + extension yaklaşımı:</p><pre>Text(&quot;welcome_text&quot;.localized(table: .loginView))</pre><ul><li>Table isimlerini <strong>compile-time seviyesinde güvence altına alır</strong></li><li>SwiftUI kodunun daha temiz ve okunabilir kalmasını sağlar</li><li>Büyük projelerde yanlış table kullanımını fiilen ortadan kaldırır</li></ul><blockquote><em>Özetle: Native API düşük seviyeli ve esnektir;<br>enum tabanlı yaklaşım ise ekipli ve uzun ömürlü projeler için daha güvenlidir.</em></blockquote><h3>Adım 3: SwiftUI İçerisinde Kullanım</h3><p>Artık altyapımız hazır. Gelin bu yapının kodun okunabilirliğini nasıl artırdığını gerçek bir senaryoda görelim.</p><p>Aşağıdaki örnekte LoginView ve SettingsView isimli iki ekranımız var. Dikkat etmeniz gereken en önemli nokta <strong>Namespace (İsim Alanı)</strong> avantajıdır.</p><pre>struct LoginView: View {<br>    var body: some View {<br>        VStack {<br>            // &quot;LoginViewLocalizable.xcstrings&quot; dosyasındaki &quot;welcome_text&quot; anahtarını okur<br>            Text(&quot;welcome_text&quot;.localized(table: .loginView))<br>                .font(.title)<br>            <br>            Button {<br>            } label: {<br>                // &quot;SharedLocalizable.xcstrings&quot; dosyasındaki ortak &quot;login_button&quot; anahtarını okur<br>                Text(&quot;login_button&quot;.localized(table: .shared))<br>            }<br><br>            NavigationLink(destination: SettingsView()) {<br>                // &quot;LoginViewLocalizable.xcstrings&quot; dosyasındaki &quot;navigate_settings_view&quot; anahtarını okur<br>                Text(&quot;navigate_settings_view&quot;.localized(table: .loginView))<br>            }<br>        }<br>        // &quot;LoginViewLocalizable.xcstrings&quot; dosyasındaki &quot;navigation_title&quot; anahtarını okur<br>        .navigationTitle(<br>            &quot;navigation_title&quot;.localized(table: .loginView)<br>        )<br>    }<br></pre><p>Şimdi de SettingsView&#39;a bakalım. Burada da navigation_title anahtarını kullanacağız ama çakışma olmayacak.</p><pre>struct SettingsView: View {<br>    var body: some View {<br>        VStack {<br>            // &quot;SettingsViewLocalizable.xcstrings&quot; dosyasındaki &quot;settings_title&quot; anahtarını okur<br>            Text(&quot;settings_title&quot;.localized(table: .settingsView))<br>                .font(.title)<br><br>            Button {<br>            } label: {<br>                // &quot;Shared.xcstrings&quot; dosyasındaki ortak &quot;save_button&quot; anahtarını okur<br>                Text(&quot;save_button&quot;.localized(table: .shared))<br>            }<br>        }<br>        // &quot;SettingsViewLocalizable.xcstrings&quot; dosyasındaki &quot;navigation_title&quot; anahtarını okur<br>        .navigationTitle(<br>            &quot;navigation_title&quot;.localized(table: .settingsView)<br>        )<br>    }<br>}</pre><h4>Parametreli ve Çoğul (Plural) Metinler Ne Olacak?</h4><p>.xcstrings yapısının sunduğu en büyük avantajlardan biri;<br><strong>pluralization</strong> ve <strong>parameterized string</strong> desteğidir.</p><p>Önerdiğimiz mimari, bu özelliklerle tamamen uyumludur.<br>Sadece String extension’ını küçük bir eklemeyle genişletmek yeterlidir.</p><p>Örneğin:</p><pre>extension String {<br>    func localized(<br>        table: LocalizableTables<br>    ) -&gt; String {<br>        NSLocalizedString(<br>            self, tableName: table.rawValue,<br>            comment: self<br>        )<br>    }<br><br>    func localizedWithParameter(<br>        table: LocalizableTables,<br>        _ args: CVarArg...<br>    ) -&gt; String {<br>        let format = self.localized(table: table)<br>        return String(<br>            format: format,<br>            arguments: args<br>        )<br>    }<br>}</pre><blockquote><em>API tasarımı açısından overload kullanmak mümkündür.<br>Ancak bu yazıda amaç, parametreli yerelleştirmenin kullanımını özellikle vurgulamak ve okunabilirliği artırmaktır.</em></blockquote><p>Kullanımı:</p><pre>Text(<br>    &quot;item_count&quot;<br>        .localizedWithParameter(table: .shared, itemCount)<br>)</pre><p>Bu sayede:</p><ul><li>Plural kuralları .xcstrings içinde yönetilir</li><li>SwiftUI tarafında ek karmaşıklık oluşmaz</li><li>Mevcut mimari bozulmadan ölçeklenebilirlik korunur</li></ul><blockquote><em>Yani bu yapı sadece “statik text” için değil,<br>gerçek hayattaki dinamik UI ihtiyaçları için de güvenle kullanılabilir.</em></blockquote><h3>Neden Bu Yöntemi Tercih Etmelisiniz?</h3><p>Bu mimariyi uyguladığınızda elde edeceğiniz 3 büyük kazanım şunlardır:</p><h4>1. İsimlendirme Özgürlüğü (Namespace)</h4><p>Yukarıdaki örnekte gördüğünüz gibi, her iki ekranda da navigation_title anahtarını kullandık. Tek bir dosya kullansaydık login_navigation_title ve settings_navigation_title gibi uzun isimler vermek zorunda kalacaktık. Bu yöntemle anahtarlarınız <strong>kısa, net ve bağlama uygun</strong> kalır.</p><h4>2. Bakım Kolaylığı ve Odaklanma</h4><p>Login ekranında bir metin değişikliği yapacaksanız, sadece LoginViewLocalizable dosyasını açarsınız. Diğer binlerce satırla uğraşmazsınız. Bu, bilişsel yükü (cognitive load) azaltır.</p><h4>3. Ekip Çalışması ve Git</h4><p>Takım arkadaşınız Ayarlar ekranını geliştirirken SettingsViewLocalizable dosyasını, siz de Giriş ekranında LoginViewLocalizable dosyasını güncellersiniz. Sonuç: <strong>Sıfır Merge Conflict.</strong></p><h3>Sonuç</h3><p>SwiftUI ve String Catalogs, yerelleştirme sürecini modernleştirdi. Ancak bu araçları doğru bir mimariyle kullanmak geliştiricinin elinde. Projenizi modüler dosyalara bölerek ve tip güvenli bir erişim katmanı kurarak, hem kod kalitenizi artırabilir hem de gelecekteki bakım maliyetlerinizi minimuma indirebilirsiniz.</p><h3>🔗 Kaynak Kod</h3><p>Bu yazıda anlatılan yapının örnek projesine GitHub üzerinden ulaşabilirsiniz: <a href="https://github.com/Batuhan-Ultrk/StringCatalogsExample">https://github.com/Batuhan-Ultrk/StringCatalogsExample</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=760091587c43" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Swift Concurrency ile Generic ve Güvenli Pagination Altyapısı]]></title>
            <link>https://medium.com/@bu0609/swift-concurrency-ile-generic-ve-g%C3%BCvenli-pagination-altyap%C4%B1s%C4%B1-0846e3811ad7?source=rss-7879737541c9------2</link>
            <guid isPermaLink="false">https://medium.com/p/0846e3811ad7</guid>
            <category><![CDATA[ios-development]]></category>
            <category><![CDATA[mobile-development]]></category>
            <category><![CDATA[swift-concurrency]]></category>
            <category><![CDATA[swiftui]]></category>
            <category><![CDATA[software-architecture]]></category>
            <dc:creator><![CDATA[BU]]></dc:creator>
            <pubDate>Tue, 13 Jan 2026 14:40:58 GMT</pubDate>
            <atom:updated>2026-01-13T14:49:06.288Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XzUlb-LGoiUahcb_2EMjSQ.png" /></figure><p>Mobil uygulamalarda sayfalı veri yükleme (pagination) kaçınılmazdır.<br>Ancak çoğu projede pagination;</p><ul><li>Her ekranda yeniden yazılır</li><li>Loading / error state’leriyle iç içe geçer</li><li>SwiftUI’de binding kaynaklı crash’lere neden olur</li></ul><p>Bu yazıda, <strong>SwiftUI + Swift Concurrency + MVVM</strong> kullanarak <strong>generic, güvenli ve yeniden kullanılabilir</strong> bir pagination altyapısını nasıl kurduğumu anlatıyorum.</p><p>🎯 Hedefler</p><p>Bu yapıyı tasarlarken şu problemleri çözmeyi amaçladım:</p><ul><li>Pagination logic’ini <strong>tek bir noktada toplamak</strong></li><li>ViewModel’lerde pagination kodu yazmamak</li><li>Aynı pagination davranışını tüm ekranlarda sağlamak</li><li>SwiftUI binding crash’lerini önlemek</li><li>Async/await ile sade ve okunabilir bir akış oluşturmak</li></ul><p>🧠 Genel Mimari</p><ul><li>Pagination logic → BaseViewViewModel</li><li>Pagination state → PaginationState</li><li>UI → PaginationView</li><li>Veri kaynağı → dışarıdan enjekte edilen fetch closure</li><li>Bu sayede pagination veriden bağımsız, tamamen reusable hale gelir.</li></ul><p>📦 PaginationState</p><p>Pagination ile ilgili tüm state’i tek bir yapıda topluyoruz.</p><p>Pagination ile ilgili tüm bilgileri tek bir yapıda toplamak:</p><ul><li>ViewModel içinde dağınık page, isLoading, total değişkenlerini ortadan kaldırır</li><li>Aynı ViewModel içinde birden fazla pagination yönetimini mümkün kılar</li><li>Test yazmayı ve reset senaryolarını kolaylaştırır</li></ul><pre>struct PaginationState {<br>    var page: Int = Constant.Paginate.page<br>    var per: Int = Constant.Paginate.per<br>    var total: Int = Constant.Paginate.total<br>    var pageCount: Int = Constant.Paginate.pageCount<br>    var isLoading = false<br><br>    private mutating func reset() {<br>        self.page = Constant.Paginate.page<br>        self.per = Constant.Paginate.per<br>        self.total = Constant.Paginate.total<br>        self.pageCount = Constant.Paginate.pageCount<br>        self.isLoading = false<br>    }<br><br>    mutating func resetItems&lt;T&gt;(_ items: inout [T]) {<br>        self.reset()<br>        items.removeAll()<br>    }<br>}</pre><p>Bu yapı sayesinde:</p><ul><li>Aynı anda birden fazla istek engellenir</li><li>Son sayfa kontrolü merkezi hale gelir</li><li>Reset ve yeniden yükleme senaryoları sadeleşir</li></ul><p>👉 <strong>Neden </strong><strong>reset private?</strong></p><p>Pagination state’i:</p><ul><li>Dışarıdan <strong>parça parça</strong> resetlenmemeli</li><li>Her zaman <strong>tutarlı bir başlangıç durumuna</strong> dönmeli</li></ul><p>Bu yüzden reset logic’i tek noktada ve kontrollü tutulur.</p><p>Pagination reset:</p><ul><li>Sadece page sıfırlamak değildir</li><li>UI’da gösterilen verinin de bu reset ile senkron olması gerekir</li></ul><p>Bu yaklaşım:</p><ul><li>“page resetlendi ama liste append oldu” gibi bug’ları engeller</li><li>ViewModel tarafında tek satırlık, okunabilir bir kullanım sağlar</li></ul><h3>📄 PageResponse</h3><p>Pagination altyapısının beklediği standart response yapısı:</p><pre>struct PageResponse&lt;T: ResponseComposition&gt;: ResponseComposition {<br>    let items: [T]<br>    let metadata: PageMetadata<br>}<br><br>struct PageMetadata: ResponseComposition {<br>    let page: Int<br>    let per: Int<br>    let total: Int<br>    let pageCount: Int<br>}</pre><p>Pagination için <strong>liste + metadata</strong> yeterlidir.<br>Backend’in nasıl çalıştığı bu noktadan sonra önemli değildir.</p><p>👉 <strong>Neden sadece </strong><strong>items + metadata?</strong></p><p>Pagination için gereken tek şey:</p><ul><li>Liste</li><li>Sayfalama bilgisi</li></ul><p>Backend’in:</p><ul><li>REST / GraphQL olması</li><li>Offset / cursor kullanması</li><li>Mock ya da real servis olması</li></ul><p>bu yapı için önemsizdir.<br>Bu sayede pagination altyapısı <strong>backend’den tamamen bağımsız</strong> hale gelir.</p><p>👉 <strong>Neden pageCount hesaplatılıyor, client hesaplamıyor?</strong></p><ul><li>Backend’in gerçek toplam veriyi bilmesi daha güvenilirdir</li><li>Client tarafında yapılan hesaplar:</li><li>Filtre / permission</li><li>Backend tarafı gizleme</li><li>Dynamic data</li></ul><p>gibi durumlarda hataya açıktır.</p><h3>🧠 Pagination’ın Merkezi: loadPagedItems</h3><p>Pagination’ın tamamı tek bir fonksiyonla yönetilir:</p><pre>    func loadPagedItems&lt;Item: ResponseComposition&gt;(<br>        itemsKeyPath: ReferenceWritableKeyPath&lt;D, [Item]&gt;,<br>        paginationKeyPath: ReferenceWritableKeyPath&lt;D, PaginationState&gt;,<br>        loading type: LoadingType,<br>        fetch: @escaping (_ page: Int, _ per: Int) async throws -&gt; PageResponse&lt;Item&gt;<br>    ) async {<br>        var pagination = viewState[keyPath: paginationKeyPath]<br>        guard pagination.page &lt;= pagination.pageCount else {<br>            return<br>        }<br>        guard !pagination.isLoading else {<br>            return<br>        }<br>        pagination.isLoading = true<br>        viewState[keyPath: paginationKeyPath] = pagination<br>        <br>        await sendRequest(<br>            {<br>                try await fetch(pagination.page, pagination.per)<br>            },<br>            loading: type,<br>            onSuccess: { [weak self] response in<br>                guard let self else { return }<br>                <br>                /// Items append or replace logic<br>                if pagination.page == 1 {<br>                    self.viewState[keyPath: itemsKeyPath] = response.items<br>                } else {<br>                    self.viewState[keyPath: itemsKeyPath].append(<br>                        contentsOf: response.items<br>                    )<br>                }<br>                <br>                /// Pagination metadata update<br>                pagination.pageCount = response.metadata.pageCount<br>                pagination.total = response.metadata.total<br>                pagination.page += 1<br>                pagination.isLoading = false<br>                self.viewState[keyPath: paginationKeyPath] = pagination<br>            }<br>        )<br>    }</pre><p>Bu fonksiyonun kritik noktaları:</p><ul><li><strong>Generic</strong> → Her model için çalışır</li><li><strong>KeyPath</strong> → ViewState’e doğrudan ama güvenli erişim</li><li><strong>Fetch closure</strong> → Veri kaynağına bağımlılık yok</li></ul><p>👉 <strong>Neden Generic + KeyPath?</strong></p><ul><li>Generic Item → her modelle çalışabilmek için</li><li>KeyPath → ViewState’e doğrudan ama güvenli erişim için</li></ul><p>Bu sayede:</p><ul><li>ViewModel içinde pagination’a özel fonksiyonlar yazılmaz</li><li>Aynı fonksiyon farklı listeler için tekrar tekrar kullanılabilir</li></ul><p>👉 <strong>Neden replace / append burada merkezi?</strong></p><p>Bu mantık:</p><ul><li>Her ekranda aynıdır</li><li>Yanlış yerde yazıldığında bug üretir</li></ul><p>Bu yüzden:</p><ul><li>UI’dan</li><li>ViewModel’den</li></ul><p>tamamen soyutlanır.</p><h3>🔍 Pagination Akışı (Adım Adım)</h3><h4>1️⃣ Guard’lar</h4><pre>guard pagination.page &lt;= pagination.pageCount else { return }<br>guard !pagination.isLoading else { return }</pre><ul><li>Son sayfadan sonra request atılmaz</li><li>Aynı anda birden fazla çağrı engellenir</li></ul><h4>2️⃣ Loading State</h4><pre>pagination.isLoading = true<br>viewState[keyPath: paginationKeyPath] = pagination</pre><ul><li>Pagination loading’i, ekranın genel loading’inden <strong>ayrı</strong> tutulur.</li></ul><h4>3️⃣ Replace / Append Mantığı</h4><pre>if pagination.page == 1 {<br>    items = response.items<br>} else {<br>    items.append(contentsOf: response.items)<br>}</pre><ul><li>İlk sayfa → replace</li><li>Sonraki sayfalar → append</li></ul><p>Bu mantık neredeyse her projede aynıdır ve <strong>merkezi olmalıdır</strong>.</p><h4>4️⃣ Metadata Güncelleme</h4><pre>pagination.pageCount = response.metadata.pageCount<br>pagination.total = response.metadata.total<br>pagination.page += 1<br>pagination.isLoading = false</pre><p>Pagination state’in tamamı <strong>tek noktadan</strong> yönetilir.</p><h4><strong>🔄 Pagination Reset Senaryoları</strong></h4><p>Pagination yalnızca “load more” demek değildir. Gerçek hayatta aşağıdaki senaryolar çok sık yaşanır:</p><ul><li>Filtre değiştiğinde</li><li>Arama (search) yapıldığında</li><li>Tab / segment değiştiğinde</li><li>Pull-to-refresh tetiklendiğinde</li><li>Ekran yeniden açıldığında</li></ul><p>Bu gibi durumlarda pagination state’i <strong>sıfırlamak</strong> gerekir.</p><h4>🧠 Reset Mantığı Neden Önemli?</h4><p>Eğer pagination reset edilmezse:</p><ul><li>Yeni filtreyle eski sayfa numarası kullanılır</li><li>Liste beklenmedik şekilde append edilir</li><li>page &gt; pageCount olduğu için yeni istek hiç atılmaz</li><li>UI “boşmuş gibi” görünür ama aslında logic kilitlidir</li></ul><p>Bu nedenle reset, pagination altyapısının <strong>birinci sınıf vatandaşı</strong> olmalıdır.</p><h4>🧱 PaginationState İçinde Reset</h4><p>Pagination state’i sıfırlamak için tüm alanları tek noktadan resetleyen bir yapı kullanıyoruz:</p><pre>struct PaginationState {<br>    var page: Int = Constant.Paginate.page<br>    var per: Int = Constant.Paginate.per<br>    var total: Int = Constant.Paginate.total<br>    var pageCount: Int = Constant.Paginate.pageCount<br>    var isLoading = false<br><br>    private mutating func reset() {<br>        self.page = Constant.Paginate.page<br>        self.per = Constant.Paginate.per<br>        self.total = Constant.Paginate.total<br>        self.pageCount = Constant.Paginate.pageCount<br>        self.isLoading = false<br>    }<br><br>    mutating func resetItems&lt;T&gt;(_ items: inout [T]) {<br>        self.reset()<br>        items.removeAll()<br>    }<br>}</pre><p>Bu sayede:</p><ul><li>Pagination metadata</li><li>Loading durumu</li><li>Liste içeriği</li></ul><p><strong>tek bir çağrıyla</strong> temizlenir.</p><h4>🔁 sendRequest ile Merkezi Async Yönetim</h4><p>Pagination, doğrudan network çağrısı yapmaz.<br>Tüm async işler sendRequest üzerinden geçer.</p><pre>    func sendRequest&lt;T: Sendable&gt;(<br>        _ request: @escaping () async throws -&gt; T,<br>        loading type: LoadingType,<br>        onSuccess: ((T) async -&gt; Void)? = nil,<br>        onFail: ((Error?, ErrorResponse?) async -&gt; Void)? = nil<br>    ) async {<br>        viewState.loadingType = type<br><br>        defer {<br>            viewState.loadingType = .none<br>        }<br><br>        do {<br>            let result = try await request()<br>            await onSuccess?(result)<br>        } catch HttpError.customErrorResponse(let errorResponse) {<br>            await onFail?(nil ,errorResponse)<br>        } catch {<br>            print(&quot;An error occurred: \(error)&quot;)<br>            await onFail?(error, nil)<br>        }<br>    }</pre><p>Bu yapı sayesinde:</p><ul><li>Loading state tutarlı</li><li>Error handling merkezi</li><li>ViewModel’ler sade ve okunabilir</li></ul><p>👉 <strong>Neden doğrudan fetch değil de sendRequest?</strong></p><ul><li>Loading yönetimi</li><li>Error handling</li><li>Unauthorized gibi global durumlar</li></ul><p>Pagination’ın sorumluluğu <strong>network değil</strong>, sadece <strong>akış</strong>tır.</p><h3>🧱 SwiftUI’de Güvenli Infinite Scroll</h3><p>SwiftUI’de ForEach + Binding kullanırken en sık yaşanan problemlerden biri <strong>geçersiz binding</strong>’dir.</p><p>Bu nedenle PaginationView içinde <strong>SafeAction</strong> yaklaşımı kullanıldı.</p><ul><li>Item listeden silinse bile</li><li>Liste resetlense bile</li><li>Scroll sırasında state değişse bile</li></ul><p>UI aksiyonları <strong>crash olmadan</strong> çalışır.</p><pre>struct PaginationView&lt;Item: Identifiable, Content: View&gt;: View {<br>    typealias SafeActionBuilder = (@escaping (Item) -&gt; Void) -&gt; () -&gt; Void<br>    typealias ItemViewBuilder = (Binding&lt;Item&gt;, SafeActionBuilder) -&gt; Content<br><br>    @Binding var items: [Item]<br>    let loadMore: (() async -&gt; Void)?<br>    let itemView: ItemViewBuilder<br><br>    init(<br>        items: Binding&lt;[Item]&gt;,<br>        loadMore: (() async -&gt; Void)? = nil,<br>        @ViewBuilder itemView: @escaping ItemViewBuilder<br>    ) {<br>        self._items = items<br>        self.loadMore = loadMore<br>        self.itemView = itemView<br>    }<br><br>    var body: some View {<br>        LazyVStack(spacing: 16) {<br>            ForEach($items, id: \.id) { $item in<br>                let currentItem = item<br>                <br>                let createSafeAction = { (action: @escaping (Item) -&gt; Void) in<br>                    self.createSafeAction(<br>                        for: currentItem,<br>                        in: { items },<br>                        perform: action<br>                    )<br>                }<br>                <br>                itemView($item, createSafeAction)<br>            }<br><br>            if !items.isEmpty {<br>                Color.clear<br>                    .frame(width: 1, height: 1)<br>                    .onAppear {<br>                        guard let loadMore = loadMore else { return }<br>                        Task {<br>                            await loadMore()<br>                        }<br>                    }<br>            }<br>        }<br>    }<br><br>    private func createSafeAction&lt;Element: Identifiable&gt;(<br>        for item: Element,<br>        in listProvider: @escaping () -&gt; [Element],<br>        perform action: @escaping (Element) -&gt; Void<br>    ) -&gt; () -&gt; Void {<br>        {<br>            guard let validItem = listProvider().first(<br>                where: {<br>                    $0.id == item.id<br>                }) else {<br>                return<br>            }<br>            action(<br>                validItem<br>            )<br>        }<br>    }<br>}</pre><p>PaginationView yalnızca:</p><ul><li>Listeyi gösterir</li><li>Scroll’un sonuna gelindiğinde loadMore çağırır</li></ul><p>Pagination mantığı UI’dan tamamen ayrılmıştır.</p><p>👉 <strong>Neden SafeAction gerekli?</strong></p><p>SwiftUI’de:</p><ul><li>Liste değişebilir</li><li>Item silinebilir</li><li>Pagination reset olabilir</li></ul><p>Ama UI event’i hâlâ çalışabilir.</p><p>SafeAction:</p><ul><li>Geçersiz binding erişimini engeller</li><li>Scroll sırasında oluşan crash’leri ortadan kaldırır</li></ul><h3>🧪 Örnek Kullanım (Özet)</h3><p>View tarafında pagination şu kadar basittir:</p><pre>    var body: some View {<br>        BaseView(viewState: viewModel.viewState) {<br>            ScrollView {<br>                bodyView<br>                    .onAppear {<br>                        viewModel.start()<br>                    }<br>            }<br>        }<br>        .navigationBarBackButtonHidden()<br>    }<br><br>    var bodyView: some View {<br>        VStack(spacing: 8) {<br>            cardViews<br>        }<br>    }<br><br>    private var cardViews: some View {<br>        PaginationView(<br>            items: $viewModel.viewState.cardViewDataList,<br>            loadMore: {<br>                await viewModel.loadFolders()<br>            },<br>            itemView: { $item, makeSafeAction in<br>                CardView(<br>                    cardViewData: $item<br>                ) { item in<br>                    print(item)<br>                }<br>            }<br>        )<br>    }</pre><p>ViewModel tarafında pagination şu kadar basittir:</p><pre>    private lazy var _start: Void = {<br>        Task { [weak self] in<br>            await self?.performOnceOnlyTask()<br>        }<br>    }()<br><br>    private func performOnceOnlyTask() async {<br>        await loadFolders()<br>    }<br><br>    func start() {<br>        _ = _start<br>    }<br><br><br>    @MainActor<br>    func loadFolders(<br>        resetLoadFolders: Bool = false<br>    ) async {<br>        if resetLoadFolders {<br>            viewState.folderPagination.resetItems(&amp;viewState.folderList)<br>        }<br><br>        await loadPagedItems(<br>            itemsKeyPath: \FolderViewState.folderList,<br>            paginationKeyPath: \FolderViewState.folderPagination,<br>            loading: .local,<br>            fetch: { page, per in<br>                return try await MockFolderService.fetchFolders(<br>                    page: page,<br>                    per: per<br>                )<br>            }<br>        )<br>    }</pre><p>Burada:</p><ul><li>Pagination nasıl çalışıyor bilinmez</li><li>Sayfa kaç, append mi replace mi detay yok</li><li>Sadece <strong>niyet</strong> vardır</li></ul><h3>🧠 Bu Yaklaşım Neyi Çözüyor?</h3><ul><li>❌ Ekran bazlı pagination kodu</li><li>❌ Kopyala–yapıştır</li><li>❌ Unsafe binding</li><li>❌ Dağınık loading / error yönetimi</li></ul><p>Yerine:</p><ul><li>✅ Tek merkezden pagination</li><li>✅ Reusable yapı</li><li>✅ Test edilebilir mimari</li><li>✅ Production-ready kod</li></ul><h3>📌 Sonuç</h3><p>Pagination küçük bir problem gibi görünse de, yanlış tasarlandığında:</p><ul><li>Kod tekrarına</li><li>Karmaşık ViewModel’lere</li><li>UI crash’lerine</li></ul><p>neden olur.</p><p>Bu yazıda anlatılan yapı, pagination’ı <strong>bir özellik değil, altyapı</strong> olarak ele alır ve uygulamanın tamamında tutarlı bir davranış sağlar. Pagination doğru kurulduğunda bir özellik değil, altyapının sessiz bir parçası haline gelir.</p><h3>🔗 Kaynak Kod</h3><p>Bu yazıda anlatılan yapının örnek projesine GitHub üzerinden ulaşabilirsiniz: <a href="https://github.com/Batuhan-Ultrk/PaginationExample">https://github.com/Batuhan-Ultrk/PaginationExample</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=0846e3811ad7" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>