Combine Framework: Programowanie Reaktywne w Swift
Opanuj Combine do obsługi asynchronicznych strumieni danych w Swift: Publishers, Subscribers, Operators i zaawansowane wzorce dla aplikacji iOS.

Programowanie reaktywne zmienia sposób obsługi zdarzeń asynchronicznych i strumieni danych w aplikacjach iOS. Combine, natywny framework Apple, oferuje deklaratywne i bezpieczne typowo podejście do orkiestrowania złożonych potoków danych. Ten przewodnik prowadzi od podstaw aż do wzorców gotowych do produkcji.
Combine jest wbudowany w iOS 13+, oferuje lepszą wydajność dzięki optymalizacjom Apple i bezproblemowo integruje się z SwiftUI. Brak zewnętrznych zależności do utrzymania.
Kluczowe pojęcia Combine
Combine opiera się na trzech kluczowych koncepcjach: Publishers emitują wartości, Subscribers je odbierają, a Operators transformują dane między nimi. Ta architektura pozwala budować reaktywne, kompozycyjne potoki danych.
Publisher: źródło danych
Publisher to typ zdolny emitować sekwencję wartości w czasie. Każdy Publisher deklaruje dwa powiązane typy: typ emitowanej wartości (Output) i typ możliwego błędu (Failure). Oto jak tworzyć różne typy Publisherów:
import Combine
// Just: emits a single value then completes
// Useful for converting a simple value to a Publisher
let singleValue = Just("Hello Combine")
// CurrentValueSubject: stores and emits the current value
// Perfect for representing state that changes over time
let counter = CurrentValueSubject<Int, Never>(0)
// PassthroughSubject: emits values without storing them
// Ideal for one-time events (taps, notifications)
let buttonTaps = PassthroughSubject<Void, Never>()
// Future: emits a single value asynchronously
// Wraps an async operation that returns a result
let asyncOperation = Future<String, Error> { promise in
// Simulate a network call
DispatchQueue.global().asyncAfter(deadline: .now() + 1) {
promise(.success("Data loaded"))
}
}Typ Never dla błędów oznacza, że Publisher nigdy nie może się nie powieść. To gwarancja na etapie kompilacji, która upraszcza kod obsługi błędów.
Subscriber: odbieranie wartości
Subscriber subskrybuje Publishera, aby odbierać jego wartości. Metoda sink to najczęstszy sposób na utworzenie Subscribera. Przyjmuje dwa closures: jeden dla błędów lub zakończenia i drugi dla każdej odebranej wartości:
import Combine
// Variable to store subscriptions
// Without this reference, the subscription would be immediately cancelled
var cancellables = Set<AnyCancellable>()
let publisher = ["Swift", "Combine", "iOS"].publisher
// sink() creates a Subscriber that receives values
publisher
.sink(
// Called when the Publisher completes or fails
receiveCompletion: { completion in
switch completion {
case .finished:
print("✅ Completed successfully")
case .failure(let error):
print("❌ Error: \(error)")
}
},
// Called for each emitted value
receiveValue: { value in
print("Received: \(value)")
}
)
// store() keeps a reference to the subscription
.store(in: &cancellables)
// Output:
// Received: Swift
// Received: Combine
// Received: iOS
// ✅ Completed successfullyZawsze przechowuj AnyCancellable zwrócone przez sink(). Bez referencji subskrypcja jest automatycznie anulowana i żadna wartość nie jest odbierana.
Transformacja danych za pomocą Operators
Operators to serce Combine. Pozwalają deklaratywnie transformować, filtrować i łączyć strumienie danych. Każdy Operator zwraca nowego Publishera, co umożliwia ich łańcuchowanie.
Podstawowe Operators transformujące
Operators transformujące modyfikują każdą emitowaną wartość. map przekształca wartości, flatMap spłaszcza zagnieżdżone Publishery, a compactMap odfiltrowuje wartości nil:
import Combine
var cancellables = Set<AnyCancellable>()
// map: transforms each value
// Equivalent to map on arrays
[1, 2, 3, 4, 5].publisher
.map { $0 * 2 } // Multiply each number by 2
.sink { print("Doubled: \($0)") }
.store(in: &cancellables)
// Output: 2, 4, 6, 8, 10
// compactMap: transforms AND filters out nil
// Useful for optional conversions
["1", "two", "3", "four", "5"].publisher
.compactMap { Int($0) } // Convert to Int, ignore failures
.sink { print("Valid number: \($0)") }
.store(in: &cancellables)
// Output: 1, 3, 5
// flatMap: flattens nested Publishers
// Essential for chaining async operations
struct User { let id: Int; let name: String }
func fetchUser(id: Int) -> AnyPublisher<User, Never> {
// Simulate an API call
Just(User(id: id, name: "User \(id)"))
.delay(for: .milliseconds(100), scheduler: RunLoop.main)
.eraseToAnyPublisher()
}
[1, 2, 3].publisher
.flatMap { id in fetchUser(id: id) } // Each ID becomes an API call
.sink { user in print("User: \(user.name)") }
.store(in: &cancellables)Operators filtrujące
Operators filtrujące kontrolują, które wartości przechodzą przez potok. Są niezbędne, aby unikać zbędnego przetwarzania i optymalizować wydajność:
import Combine
var cancellables = Set<AnyCancellable>()
let numbers = [1, 2, 2, 3, 3, 3, 4, 5, 5].publisher
// filter: keeps only values that satisfy the condition
numbers
.filter { $0 > 2 } // Keep only numbers > 2
.sink { print("Filtered: \($0)") }
.store(in: &cancellables)
// Output: 3, 3, 3, 4, 5, 5
// removeDuplicates: removes consecutive identical values
numbers
.removeDuplicates() // Eliminate consecutive duplicates
.sink { print("Without duplicates: \($0)") }
.store(in: &cancellables)
// Output: 1, 2, 3, 4, 5
// debounce: waits for a pause before emitting
// Perfect for real-time search
let searchText = PassthroughSubject<String, Never>()
searchText
.debounce(for: .milliseconds(300), scheduler: RunLoop.main)
.removeDuplicates() // Ignore if text hasn't changed
.sink { query in
print("Search: \(query)")
// Launch API call here
}
.store(in: &cancellables)
// Simulate rapid typing
searchText.send("S")
searchText.send("Sw")
searchText.send("Swi")
searchText.send("Swift") // Only "Swift" is emitted after 300msGotowy na rozmowy o iOS?
Ćwicz z naszymi interaktywnymi symulatorami, flashcards i testami technicznymi.
Łączenie wielu Publisherów
Rzeczywiste aplikacje często muszą łączyć wiele źródeł danych. Combine oferuje kilka Operators do orkiestracji tych wielu strumieni.
CombineLatest i Zip
combineLatest emituje za każdym razem, gdy emituje którykolwiek Publisher, łącząc z najnowszymi wartościami pozostałych. zip czeka, aż wszystkie Publishery wyemitują wartość, zanim je połączy:
import Combine
var cancellables = Set<AnyCancellable>()
// Simulate a form with validation
let email = CurrentValueSubject<String, Never>("")
let password = CurrentValueSubject<String, Never>("")
// combineLatest: combines the latest values from each Publisher
// Emits on every change from either source
Publishers.CombineLatest(email, password)
.map { email, password in
// Validate that email contains @ and password > 6 chars
let isEmailValid = email.contains("@")
let isPasswordValid = password.count >= 6
return isEmailValid && isPasswordValid
}
.sink { isFormValid in
print("Form valid: \(isFormValid)")
}
.store(in: &cancellables)
email.send("user@example.com") // false (password empty)
password.send("123456") // true (both are valid)
// zip: waits for one value from each Publisher before emitting
// Useful for synchronizing parallel operations
let firstAPI = PassthroughSubject<String, Never>()
let secondAPI = PassthroughSubject<Int, Never>()
Publishers.Zip(firstAPI, secondAPI)
.sink { stringValue, intValue in
print("Received pair: \(stringValue), \(intValue)")
}
.store(in: &cancellables)
firstAPI.send("Hello") // No emission, waiting for secondAPI
secondAPI.send(42) // Emits: ("Hello", 42)
firstAPI.send("World") // No emission, waiting for secondAPI
secondAPI.send(100) // Emits: ("World", 100)Merge do ujednolicania strumieni
merge łączy wiele Publisherów tego samego typu w jeden strumień. Wartości docierają w kolejności emisji, niezależnie od tego, który Publisher je wysłał:
import Combine
var cancellables = Set<AnyCancellable>()
// Multiple user notification sources
let pushNotifications = PassthroughSubject<String, Never>()
let localNotifications = PassthroughSubject<String, Never>()
let inAppMessages = PassthroughSubject<String, Never>()
// Merge unifies all streams into one
Publishers.Merge3(pushNotifications, localNotifications, inAppMessages)
.sink { message in
// Handle all notifications the same way
print("📬 Notification: \(message)")
}
.store(in: &cancellables)
pushNotifications.send("New message") // 📬 Notification: New message
localNotifications.send("Reminder: meeting") // 📬 Notification: Reminder: meeting
inAppMessages.send("Welcome!") // 📬 Notification: Welcome!Obsługa błędów w Combine
Obsługa błędów jest wbudowana w rdzeń Combine. Typ Failure Publisherów pozwala kompilatorowi zweryfikować, że wszystkie błędy są obsłużone.
Strategie odzyskiwania
Combine oferuje kilka Operators do obsługi błędów: catch do zastąpienia innym Publisherem, retry do ponowienia próby i replaceError dla wartości domyślnej:
import Combine
var cancellables = Set<AnyCancellable>()
enum APIError: Error {
case networkError
case invalidResponse
case serverError(Int)
}
// Simulate an API call that can fail
func fetchData() -> AnyPublisher<String, APIError> {
Fail(error: APIError.networkError)
.eraseToAnyPublisher()
}
// retry: retries N times before propagating the error
fetchData()
.retry(3) // Try up to 3 times
.catch { error -> Just<String> in
// catch: replaces the error with a fallback Publisher
print("Error after 3 attempts: \(error)")
return Just("Cached data") // Fallback value
}
.sink(
receiveCompletion: { _ in },
receiveValue: { print("Result: \($0)") }
)
.store(in: &cancellables)
// replaceError: replaces any error with a fixed value
// Simpler than catch when only a default value is needed
fetchData()
.replaceError(with: "Error - default value")
.sink { print("With fallback: \($0)") }
.store(in: &cancellables)Użyj setFailureType(to:), aby zmienić Publisher Never w taki, który może się nie powieść, oraz replaceError(with:) lub catch do operacji odwrotnej.
Wzorzec MVVM z Combine
Combine integruje się naturalnie ze wzorcem MVVM (Model-View-ViewModel). ViewModel udostępnia Publishery, które obserwuje View, tworząc reaktywne powiązanie między danymi a interfejsem.
Pełny reaktywny ViewModel
Oto przykład ViewModel dla listy użytkowników z wyszukiwaniem, ładowaniem i obsługą błędów:
import Combine
import Foundation
// Data model
struct User: Codable, Identifiable {
let id: Int
let name: String
let email: String
}
// ViewModel with reactive state
final class UserListViewModel: ObservableObject {
// MARK: - Published Properties (observed by SwiftUI)
@Published var users: [User] = [] // User list
@Published var searchQuery: String = "" // Search text
@Published var isLoading: Bool = false // Loading state
@Published var errorMessage: String? // Optional error message
// MARK: - Private Properties
private var cancellables = Set<AnyCancellable>()
private let userService: UserServiceProtocol
// MARK: - Computed Properties
// Filters users based on search query
var filteredUsers: [User] {
guard !searchQuery.isEmpty else { return users }
return users.filter {
$0.name.localizedCaseInsensitiveContains(searchQuery)
}
}
// MARK: - Initialization
init(userService: UserServiceProtocol = UserService()) {
self.userService = userService
setupBindings()
}
// MARK: - Private Methods
private func setupBindings() {
// Observe searchQuery changes
// debounce prevents too frequent calls
$searchQuery
.debounce(for: .milliseconds(300), scheduler: RunLoop.main)
.removeDuplicates()
.sink { [weak self] query in
// Server-side search logic if needed
print("Search updated: \(query)")
}
.store(in: &cancellables)
}
// MARK: - Public Methods
func loadUsers() {
isLoading = true
errorMessage = nil
userService.fetchUsers()
.receive(on: DispatchQueue.main) // Ensure UI updates on main thread
.sink(
receiveCompletion: { [weak self] completion in
self?.isLoading = false
if case .failure(let error) = completion {
self?.errorMessage = error.localizedDescription
}
},
receiveValue: { [weak self] users in
self?.users = users
}
)
.store(in: &cancellables)
}
}Service z Combine i URLSession
URLSession integruje Combine natywnie poprzez dataTaskPublisher. Oto jak zbudować wielokrotnego użytku usługę sieciową:
import Combine
import Foundation
protocol UserServiceProtocol {
func fetchUsers() -> AnyPublisher<[User], Error>
}
final class UserService: UserServiceProtocol {
private let baseURL = URL(string: "https://api.example.com")!
private let session: URLSession
private let decoder: JSONDecoder
init(session: URLSession = .shared) {
self.session = session
self.decoder = JSONDecoder()
decoder.keyDecodingStrategy = .convertFromSnakeCase
}
func fetchUsers() -> AnyPublisher<[User], Error> {
let url = baseURL.appendingPathComponent("users")
return session.dataTaskPublisher(for: url)
// Check HTTP status code
.tryMap { data, response in
guard let httpResponse = response as? HTTPURLResponse else {
throw URLError(.badServerResponse)
}
guard 200..<300 ~= httpResponse.statusCode else {
throw URLError(.badServerResponse)
}
return data
}
// Decode JSON to Swift model
.decode(type: [User].self, decoder: decoder)
// Erase concrete type to return AnyPublisher
.eraseToAnyPublisher()
}
}Gotowy na rozmowy o iOS?
Ćwicz z naszymi interaktywnymi symulatorami, flashcards i testami technicznymi.
Integracja z SwiftUI
Combine i SwiftUI tworzą potężny duet. Właściwości @Published w ObservableObject automatycznie wyzwalają aktualizacje widoku.
Widok SwiftUI z ViewModel Combine
Oto jak podłączyć ViewModel do widoku SwiftUI:
import SwiftUI
struct UserListView: View {
// StateObject: creates and owns the ViewModel
@StateObject private var viewModel = UserListViewModel()
var body: some View {
NavigationStack {
Group {
if viewModel.isLoading {
// Centered loading indicator
ProgressView("Loading...")
} else if let error = viewModel.errorMessage {
// Error view with retry button
VStack(spacing: 16) {
Text("Error: \(error)")
.foregroundStyle(.red)
Button("Retry") {
viewModel.loadUsers()
}
}
} else {
// User list
List(viewModel.filteredUsers) { user in
UserRowView(user: user)
}
}
}
.navigationTitle("Users")
.searchable(text: $viewModel.searchQuery) // Direct binding
.onAppear {
viewModel.loadUsers() // Load on first appearance
}
}
}
}
struct UserRowView: View {
let user: User
var body: some View {
VStack(alignment: .leading, spacing: 4) {
Text(user.name)
.font(.headline)
Text(user.email)
.font(.subheadline)
.foregroundStyle(.secondary)
}
.padding(.vertical, 4)
}
}Wzorce zaawansowane
Anulowanie i automatyczne sprzątanie
Zarządzanie cyklem życia subskrypcji jest kluczowe, aby uniknąć wycieków pamięci. Wzorzec cancellables z AnyCancellable zapewnia automatyczne sprzątanie:
import Combine
final class DataManager {
// Set of cancellables: automatically cancelled on destruction
private var cancellables = Set<AnyCancellable>()
// Individual cancellable for fine-grained control
private var currentRequest: AnyCancellable?
func startPolling() {
// Timer that emits every 5 seconds
Timer.publish(every: 5, on: .main, in: .common)
.autoconnect() // Starts automatically
.sink { [weak self] _ in
self?.fetchLatestData()
}
.store(in: &cancellables)
}
func fetchLatestData() {
// Cancel the previous request if it exists
currentRequest?.cancel()
currentRequest = URLSession.shared
.dataTaskPublisher(for: URL(string: "https://api.example.com/data")!)
.map(\.data)
.decode(type: [String].self, decoder: JSONDecoder())
.replaceError(with: [])
.receive(on: DispatchQueue.main)
.sink { data in
print("Data received: \(data)")
}
}
deinit {
// All cancellables are automatically cancelled
print("DataManager destroyed, subscriptions cancelled")
}
}Schedulers do wątków
Schedulers kontrolują, na jakim wątku wykonywane są operacje. Użyj subscribe(on:) dla pracy w tle i receive(on:) dla aktualizacji UI:
import Combine
import Foundation
var cancellables = Set<AnyCancellable>()
func loadAndProcessData() -> AnyPublisher<ProcessedData, Error> {
URLSession.shared.dataTaskPublisher(for: apiURL)
// Perform parsing on a background thread
.subscribe(on: DispatchQueue.global(qos: .userInitiated))
.map(\.data)
.decode(type: RawData.self, decoder: JSONDecoder())
// Heavy processing on background thread
.map { rawData in
// This expensive operation runs in the background
processData(rawData)
}
// Return to main thread for UI
.receive(on: DispatchQueue.main)
.eraseToAnyPublisher()
}Podsumowanie
Combine oferuje potężne i deklaratywne podejście do obsługi asynchronicznych strumieni danych w aplikacjach iOS. Najważniejsze punkty:
✅ Publishers emitują wartości w czasie
✅ Subscribers odbierają i przetwarzają te wartości
✅ Operators transformują i łączą strumienie
✅ AnyCancellable zarządza cyklem życia subskrypcji
✅ @Published z SwiftUI tworzy automatyczne reaktywne powiązania
✅ Schedulers sterują wątkami dla optymalnej wydajności
Opanowanie Combine pozwala budować solidne, łatwe w utrzymaniu i reaktywne aplikacje iOS. Natywna integracja ze SwiftUI czyni z niego niezbędne narzędzie nowoczesnego rozwoju iOS.
Zacznij ćwiczyć!
Sprawdź swoją wiedzę z naszymi symulatorami rozmów i testami technicznymi.
Tagi
Udostępnij
Powiązane artykuły

Combine vs async/await w Swift: Wzorce Progresywnej Migracji
Kompletny przewodnik po migracji z Combine do async/await w Swift: progresywne strategie, wzorce mostkowania i współistnienie paradygmatów w bazach kodu iOS.

Pytania rekrutacyjne o dostępność iOS w 2026: VoiceOver i Dynamic Type
Przygotuj się do rozmów iOS z kluczowymi pytaniami o dostępność: VoiceOver, Dynamic Type, semantyczne traits i audyty.

Swift Macros: praktyczne przykłady metaprogramowania
Kompletny przewodnik po Swift Macros: tworzenie makr freestanding i attached, manipulacja AST przy użyciu swift-syntax oraz praktyczne przykłady eliminujące powtarzalny kod.