@Published: τι είναι, αρχή λειτουργίας και εφαρμογή

Τι είναι το @Published;

@Published — είναι ένα property wrapper που ορίζεται στο module Combine και προσθέτει σε μια ιδιότητα κλάσης τη δυνατότητα να ειδοποιεί αυτόματα τους συνδρομητές για αλλαγές. Μπορεί να εφαρμοστεί μόνο εντός κλάσης (όχι σε struct) και μόνο σε ιδιότητες κλάσης που συμμορφώνεται με το πρωτόκολλο ObservableObject.

Όταν η τιμή μιας @Published ιδιότητας αλλάζει, το Combine δημιουργεί ένα συμβάν μέσω του ενσωματωμένου publisher, προσβάσιμο μέσω του προθήματος δολαρίου: $propertyName. Αυτός ο publisher είναι ένας ObservableObjectPublisher, ο οποίος ανήκει στο ιδιο το ObservableObject. Το SwiftUI εγγράφεται αυτόματα σε αυτόν όταν μια προβολή χρησιμοποιεί @ObservedObject ή @StateObject, και σχεδιάζει ξανά την προβολή σε κάθε αλλαγή οποιασδήποτε @Published ιδιότητας μέσα στο αντικείμενο.

Σύμφωνα με το βιβλίο του Matt Neuburg «IOS 18 Programming Fundamentals with Swift» (2025), το @Published είναι ένα βολικό περιτύλιγμα γύρω από το pattern willSet, που καλεί αυτόματα το objectWillChange.send(). Ο μεταγλωττιστής ξετυλίγει το @Published σε μια υπολογισμένη ιδιότητα με έναν willSet παρατηρητή, που παρέχει μηδενικό κόστος κατά τη λειτουργία σε σύγκριση με την χειροκίνητη υλοποίηση.

Χρησιμοποιείτε το @Published για όλες τις ιδιότητες ObservableObject των οποίων οι αλλαγές πρέπει να αντικατοπτρίζονται στη διεπαφή. Για ιδιότητες που δεν επηρεάζουν το UI, οι συνηθισμένες stored properties χωρίς @Published μειώνουν τον αριθμό των μη απαραίτητων ξανασχεδιάσεων.

Πώς λειτουργεί το @Published

@Published δημιουργεί δύο κλειδιά στοιχεία κατά τη μεταγλώττιση. Πρώτο — μια αποθηκευμένη ιδιότητα με έναν willSet παρατηρητή που καλεί το objectWillChange.send() πριν από την εγγραφή της νέας τιμής. Δεύτερο — η προβολή $propertyName που επιστρέφει έναν Published.Publisher που μπορεί να χρησιμοποιηθεί απευθείας σε pipeline του Combine.

Θεωρήστε την κλάση Settings με τρεις ιδιότητες: δύο @Published και μία συνηθισμένη:

class Settings: ObservableObject {
    @Published var username: String = "Guest"
    @Published var isDarkMode = false
    var lastLogin: Date = Date()  // χωρίς @Published
}

Κατά την αλλαγή του username ή του isDarkMode, το SwiftUI σχεδιάζει ξανά όλες τις προβολές που είναι εγγεγραμμένες στην επίπεδη Settings. Η αλλαγή του lastLogin δεν θα προκαλέσει ξανασχεδίασμα. Αν χρειάζεται να ειδοποιήσετε με χείρα τους συνδρομητές για την αλλαγή μιας συνηθισμένης ιδιότητας, μπορείτε να καλέσετε το objectWillChange.send() στον παρατηρητή willSet.

Μια σημαντική λεπτομέρεια: το @Published δημοσιεύει αλλαγές μόνο κατά την άμεση εγγραφή στην ιδιότητα. Αν η ιδιότητα είναι τύπου αναφοράς (κλάση) και η εσωτερική κατάστασή της αλλάζει χωρίς να αντικατασταθεί η αναφορά, το @Published δεν θα το ανιχνεύσει. Σε τέτοιες περιπτώσεις, απαιτείται με χείρα αποστολή του συμβάντος ή αντικατάσταση με έναν τύπο τιμής (struct).

@Published και Combine

@Published είναι σχεδόν ενσωματωμένο με το Combine — κάθε @Published ιδιότητα παρέχει αυτόματα έναν publisher προσβάσιμο μέσω της προβολής $propertyName. Αυτό επιτρέπει την εφαρμογή τελεστών Combine για φιλτράρισμα, μετασχηματισμό, συνδυασμό και καθυστερημένη επεξεργασία τιμών.

Ένα τυπικό σενάριο — αναζήτηση με debounce. Το πεδίο εισαγωγής είναι συνδεδεμένο με την @Published ιδιότητα searchText, αλλά το αίτημα προς τον εξυπηρετητή πρέπει να σταλεί μόνο μετά από μια παύση 300 ms. Το Combine με $searchText.debounce το λύνει σε μία γραμμή:

class SearchViewModel: ObservableObject {
    @Published var searchText = ""
    @Published var results: [String] = []
    private var cancellables = Set<AnyCancellable>()

    init() {
        setupSearchSubscription()
    }

    private func setupSearchSubscription() {
        $searchText
            .debounce(for: .milliseconds(300), scheduler: RunLoop.main)
            .removeDuplicates()
            .sink { [weak self] text in
                self?.performSearch(text)
            }
            .store(in: &cancellables)
    }

    private func performSearch(_ text: String) { }
}

Σύμφωνα με το άρθρο του John Sundell (Swift by Sundell, 2024), ο συνδυασμός του @Published με το Combine είναι ένα τυπικό pattern για αντιδραστικά pipeline σε εφαρμογές SwiftUI: validation, debounce, throttle, combineLatest, merge με άλλους publishers. Το @Published λειτουργεί ως γέφυρα μεταξύ του επιτακτικού UI κώδικα και του αντιδραστικού Combine.

@Published συγκριτικά με το μακρο @Observable

Με την κυκλοφορία του iOS 17, η Apple εισήγαγε το μακρο @Observable, που προσφέρει μια εναλλακτική προσέγγιση στην αντιδραστικότητα χωρίς ObservableObject και @Published. Το @Observable παρακολουθεί αυτόματα την πρόσβαση σε ιδιότητες σε επίπεδο ανάγνωσης, όχι εγγραφής, που παρέχει πιο ακριβή ξανασχεδίαση — ενημερώνεται μόνο η προβολή που διαβάζει την συγκεκριμένη ιδιότητα που αλλάχθηκε.

Αυτό δεν σημαίνει όμως ότι το @Published έχει απαρχαιωθεί. Το @Published παραμένει απαραίτητο όταν χρειάζεται ενσωμάτωση με τα pipeline του Combine — η προβολή $propertyName παρέχει έναν publisher που δεν έχει το @Observable. Επιπλέον, για συμβατότητα προς τα πίσω με iOS 16 και παλαιότερα, το @Published+ObservableObject είναι η μοναδική επιλογή. Σύμφωνα με τη συνεδρία Apple WWDC 2023 «Discover Observation in SwiftUI», η Apple συνιστά το @Observable για νέα έργα, αλλά διατηρεί ρητά την υποστήριξη για το @Published για υπάρχοντα κώδικα και σενάρια Combine.

Στην πράξη, πολλά έργα χρησιμοποιούν μια υβριδική προσέγγιση: νέα μοντέλα δεδομένων γράφονται με @Observable, ενώ τα υπάρχοντα ObservableObject με @Published παραμένουν χωρίς αναπροσαρμογή. Το @Published είναι επίσης ανικατάστατο όταν απαιτείται ακριβής έλεγχος πάνω στη δημοσίευση — για παράδειγμα, καθυστέρηση της ειδοποίησης έως την ολοκλήρωση της μαζικής ενημέρωσης πολλών ιδιοτήτων.

Συνηθισμένα λάθη με το @Published

Πρώτο λάθος — εφαρμογή του @Published σε struct. Ο μεταγλωττιστής θα εμφανίσει σφάλμα: «Property wrapper cannot be applied to a computed property» ή «'@Published' is only available on members of a class». Το @Published απαιτεί σημασιολογία αναφοράς, διότι το ObservableObjectPublisher είναι μια κλάση που πρέπει να είναι μοναδική για κάθε στοιχείο.

Δεύτερο λάθος — μεταβολή του περιεχομένου μιας ιδιότητας αναφοράς χωρίς την αντικατάσταση της αναφοράς. Αν μια @Published ιδιότητα έχει τύπο πίνακα [String] και καλέσετε array.append("new"), το @Published δεν θα ανιχνεύσει την αλλαγή επειδή η αναφορά στον πίνακα δεν έχει αλλάξει. Λύση: εκχωρήστε νέα τιμή στην ιδιότητα array = array + ["new"] ή χρησιμοποιήστε με χείρα το objectWillChange.send().

Τρίτο λάθος — υπερβολικός αριθμός @Published ιδιοτήτων. Κάθε @Published ιδιότητα προκαλεί το ξανασχεδίασμα όλων των προβολών που είναι εγγεγραμμένες στο ObservableObject, όχι μόνο αυτών που διαβάζουν αυτή την ιδιότητα. Σύμφωνα με το Point-Free (2025), η διαίρεση ενός μεγάλου ObservableObject σε πολλά μικρά με @StateObject και @EnvironmentObject μειώνει τον αριθμό των μη απαραίτητων ξανασχεδιάσεων και βελτιώνει την απόδοση.

Παραδείγματα κώδικα

Πρώτο παράδειγμα — ViewModel φόρμας εγγραφής με επικύρωση. Οι @Published ιδιότητες email και password πυροδοτούν την εμφάνιση σφαλμάτων επικύρωσης μέσω του pipeline Combine:

class RegistrationViewModel: ObservableObject {
    @Published var email = ""
    @Published var password = ""
    @Published var emailError: String?
    @Published var isFormValid = false
    private var cancellables = Set<AnyCancellable>()

    init() {
        $email
            .map { $0.contains("@") ? nil : "Invalid email" }
            .assign(to: &$emailError)
            .store(in: &cancellables)

        $email.combineLatest($password)
            .map { !$0.isEmpty && !$1.isEmpty }
            .assign(to: &$isFormValid)
            .store(in: &cancellables)
    }
}

Δεύτερο παράδειγμα — με χείρα δημοσίευση για συλλογή στοιχείων αναφοράς. Αντί να αντικαθιστάτε ολόκληρο τον πίνακα σε κάθε αλλαγή μέσα σε ένα στοιχείο, χρησιμοποιείται το objectWillChange.send():

class TodoItem {
    var title: String
    var isDone = false
    init(title: String) { self.title = title }
}

class TodoListViewModel: ObservableObject {
    @Published var items: [TodoItem] = []

    func toggle(item: TodoItem) {
        item.isDone.toggle()
        self.objectWillChange.send()  // με χείρα ειδοποίηση
    }
}

Τρίτο παράδειγμα — Assign σε @Published ιδιότητα μέσω Combine. Χρησιμοποιώντας τη νέα σύνταξη Swift 5.9, μπορείτε να εκχωρήσετε απευθείας μέσω της προβολής assign(to: &$property) χωρίς Optional περιτύλιγμα. Αυτός είναι ο συντομότερος τρόπος να συνδέσετε έναν publisher με @Published ιδιότητα χωρίς να δημιουργήσετε συνδρομή.