Как сохранять state?

Команда (код): struct ContentView: View { enum Tab: String, Hashable { case home, search, profile } // Сохраняем выбор вкладки между сценами @SceneStorage("selectedTab") private var selectedTabRaw: String? @State private var selection: Tab = .home var body: some View { TabView(selection: $selection) { // ... табы } .onAppear { if let raw = selectedTabRaw, let restored = Tab(rawValue: raw) { selection = restored } } .onChange(of: selection) { new in selectedTabRaw = new.rawValue } } } Пояснение: @SceneStorage сохраняет значение, привязанное к сцене (WindowGroup), и восстанавливает его при восстановлении. Для глобальной сохранности между запусками используйте @AppStorage (UserDefaults) или сериализацию в файл с Codable. Ожидаемый вывод: при закрытии приложения и повторном запуске последняя выбранная вкладка восстанавливается за 100–300 мс после создания контента; при переключении между несколькими сценами каждая сцена сохраняет своё состояние отдельно. Типовая ошибка и фикс: Ошибка:...

Какие частые ошибки?

Ошибка: неправильное управление NavigationStack внутри вкладок. Симптом: нажатие Back ведет не туда или теряется стек навигации при переключении вкладок. Причина и фикс: каждая вкладка должна иметь собственный NavigationStack либо управляться отдельными стореджами. Если нужен общий стек между вкладками — реализуйте внешний NavigationStack и управляйте контентом через выбор Enum. Ошибка: неправильное восстановление состояния между сценами (multi-window). Симптом: сцены переключают вкладки друг у друга или восстанавливают неверный стек. Причина и фикс: используйте @SceneStorage для per-scene состояния и @AppStorage для общего состояния. Избегайте глобальных синглтонов для текущего selectedTab. Ошибка: deep link не срабатывает на закрытом приложении. Симптом: URL открывает приложение, но onOpenURL не применяет нужные изменения. Причина и фикс: если обработка URL зависит от инициализированных сервисов, задержите обработку до окончания старта приложения или сохраните URL в @AppStorage,...

как правильно выбирать между @SceneStorage и @AppStorage?

@SceneStorage хранит значение в контексте конкретной сцены (window) и восстанавливает его при возобновлении именно этой сцены. Это удобно для selectedTab, когда у пользователя может быть несколько окон с разными состояниями. @AppStorage записывает данные в UserDefaults и доступен глобально для всего приложения. Используйте @AppStorage, если значение должно быть единым для всех сцен и сохраняться между перезапусками приложения. Для чувствительных данных применяйте безопасное шифрование и Keychain.

что делать, если deep link открывает приложение, но не переключает вкладку?

Проверьте, вызывается ли onOpenURL в корневом view; если приложение ещё инициализируется, обработка может быть пропущена. Сохраняйте URL в промежуточном хранилище (например, @AppStorage или в singleton), а затем применяйте при завершении инициализации. Для Universal Links проверьте Associated Domains и содержание файла apple-app-site-association на стороне сервера.

сколько памяти занимает кастомный таб-бар по сравнению со стандартным?

Визуально кастомный таб-бар не добавляет значительной оперативной нагрузки: память эффекта зависит от иконок и изображений. На практике разница в использовании памяти между стандартным TabView и кастомным View обычно не превышает 1–5 МБ для простых реализаций; сложные анимации и изображения высокого разрешения могут увеличить потребление. Контролируйте использование через Instruments (Leaks, Allocations).

какой лучший способ тестировать переключение вкладок в CI?

Для надежности комбинируйте unit-тесты (проверка логики выбора) и UI-тесты (XCUITest) для реального интерфейса. В CI используйте стабильные симуляторы (например, iPhone 15, iOS 18) и добавьте ожидания по времени и условиям появления элементов. Избегайте сетевых вызовов в UI-тестах — мокируйте сеть. В GitHub Actions кешируйте DerivedData и используйте xcpretty для читаемых логов.

почему при повороте устройства таб-бар перекрывает контент?

Чаще всего причина — игнорирование safe area или жесткая привязка высоты таб-бара. Используйте safeAreaInset или учитывайте environment.safeAreaInsets и адаптируйте высоту таб-бара для разных размеров экрана и ориентаций. Тестируйте на iPad (Split View) и в режиме многозадачности, где доступная площадь может значительно меняться.

Таб-бар и навигация в SwiftUI

import SwiftUI

@main
struct MyApp: App {
    @SceneBuilder var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

struct ContentView: View {
    @State private var selection: Tab = .home

    enum Tab: Hashable {
        case home, search, profile
    }

    var body: some View {
        TabView(selection: $selection) {
            NavigationStack {
                HomeView()
            }
            .tabItem {
                Label("Главная", systemImage: "house")
            }
            .tag(Tab.home)

            NavigationStack {
                SearchView()
            }
            .tabItem {
                Label("Поиск", systemImage: "magnifyingglass")
            }
            .tag(Tab.search)

            NavigationStack {
                ProfileView()
            }
            .tabItem {
                Label("Профиль", systemImage: "person")
            }
            .tag(Tab.profile)
        }
    }
}

xcodebuild -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15,OS=18.0' build

=== BUILD TARGET MyApp OF PROJECT MyApp WITH CONFIGURATION Debug ===
...compiling sources...
** BUILD SUCCEEDED ** (took 37.2 seconds)

struct CustomTabBar: View {
    @Binding var selection: ContentView.Tab

    var body: some View {
        HStack {
            Spacer()
            tabButton(.home, label: "Home", systemImage: "house")
            Spacer()
            tabButton(.search, label: "Search", systemImage: "magnifyingglass")
            Spacer()
            tabButton(.profile, label: "Profile", systemImage: "person")
            Spacer()
        }
        .padding(.vertical, 10)
        .background(.ultraThinMaterial)
        .clipShape(RoundedRectangle(cornerRadius: 16, style: .continuous))
        .padding(.horizontal)
        .shadow(color: .black.opacity(0.15), radius: 8, x: 0, y: 4)
    }

    @ViewBuilder
    private func tabButton(_ tab: ContentView.Tab, label: String, systemImage: String) -> some View {
        Button(action: { selection = tab }) {
            VStack(spacing: 4) {
                Image(systemName: systemImage)
                    .font(.system(size: 20, weight: .semibold))
                    .foregroundColor(selection == tab ? .accentColor : .gray)
                Text(label)
                    .font(.caption)
                    .foregroundColor(selection == tab ? .accentColor : .gray)
            }
        }
    }
}

// Использование в ContentView: заменить стандартный TabView на ZStack + CustomTabBar

// Схема в Info.plist: URL Types -> myapp
// Обработка в SwiftUI:

struct ContentView: View {
    @State private var selection: Tab = .home

    var body: some View {
        TabView(selection: $selection) { /* ... */ }
        .onOpenURL { url in
            handleURL(url)
        }
    }

    private func handleURL(_ url: URL) {
        // Примеры: myapp://tab/profile  или https://example.com/app/tab/search
        guard let host = url.host else { return }
        switch host {
        case "tab":
            if let comp = url.pathComponents.dropFirst().first {
                switch comp {
                case "home": selection = .home
                case "search": selection = .search
                case "profile": selection = .profile
                default: break
                }
            }
        default: break
        }
    }
}

xcrun simctl openurl booted myapp://tab/profile

struct ContentView: View {
    enum Tab: String, Hashable { case home, search, profile }

    // Сохраняем выбор вкладки между сценами
    @SceneStorage("selectedTab") private var selectedTabRaw: String?
    @State private var selection: Tab = .home

    var body: some View {
        TabView(selection: $selection) {
            // ... табы
        }
        .onAppear {
            if let raw = selectedTabRaw, let restored = Tab(rawValue: raw) {
                selection = restored
            }
        }
        .onChange(of: selection) { new in
            selectedTabRaw = new.rawValue
        }
    }
}

import XCTest

final class TabTests: XCTestCase {
    func testSwitchToProfile() {
        let app = XCUIApplication()
        app.launch()
        let profileButton = app.buttons["Profile"] // локализуемый лейбл
        XCTAssertTrue(profileButton.waitForExistence(timeout: 5))
        profileButton.tap()
        XCTAssertTrue(app.staticTexts["Профиль"].exists)
    }
}

xcodebuild test -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15,OS=18.0'

Test Suite 'All tests' passed at 2026-03-15 10:22:44.
Executed 1 test, with 0 failures (0 unexpected) in 12.345 (12.678) seconds

name: iOS CI

on: [push, pull_request]

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set Xcode
        uses: maxim-lobanov/setup-xcode@v2
        with:
          xcode-version: '16.0'
      - name: Build and test
        run: xcodebuild test -workspace MyApp.xcworkspace -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15,OS=18.0' | xcpretty

Таб-бар и навигация в SwiftUI | KtoHto

Таб-бар и навигация в SwiftUI

Что вы изучите

Требования

Что нового в TabView iOS 18

Комментарии (0)

Шаг 1: базовая навигация

Шаг 2: кастомный стиль

Шаг 3: deep linking