Project 11 — Bookworm
Bookworm хранит прочитанные книги, авторов, жанры, ratings и отзывы. SwiftData берёт на себя persistence, а SwiftUI остаётся декларативным слоем интерфейса.
Готовность к проекту
0 из 5 рекомендуемых тем изучено. Проект всегда доступен — это не ограничение.
Стартовая точка
Создай новый iOS → App с именем Bookworm и интерфейсом SwiftUI. В сгенерированном ContentView.swift оставь минимальное состояние ниже. Сохрани файл BookwormApp.swift, созданный Xcode; если шаг меняет точку входа, замени существующий файл, не создавай второй @main.
import SwiftUI
struct ContentView: View {
var body: some View {
Text("Начало")
}
}Сначала прочитай задание шага и попробуй выполнить его. Решение закрыто: открой его для сверки или если застрял. Применяй изменения по порядку — каждый шаг опирается на предыдущий.
Шаг 1. Модель и контейнер
Цель: Модель и контейнер.
Попробуй сам: Создай @Model Book с title и author. Подключи modelContainer в существующем BookwormApp. Экран пока остаётся пустым.
Показать решение шага 1
Book.swift — создай файл и включи его в target приложения.
import SwiftData
@Model
final class Book {
var title: String
var author: String
init(title: String, author: String) { self.title = title; self.author = author }
}В BookwormApp.swift найди этот блок:
import SwiftUIЗамени его следующим блоком; остальной код файла сохрани:
import SwiftUI
import SwiftDataВ BookwormApp.swift найди этот блок:
WindowGroup { ContentView() }Замени его следующим блоком; остальной код файла сохрани:
WindowGroup { ContentView() }
.modelContainer(for: Book.self)Ожидаемый результат: Приложение запускается с контейнером без второй точки входа. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: SwiftData сохраняет model-классы. Контейнер задаётся у App и передаёт context дочерним View; сам по себе он ещё не показывает данные.
@Model добавляет модели возможности SwiftData; это не UI-компонент. .modelContainer(for:) у Scene создаёт окружение для дочерних экранов. Если добавить только @Model и забыть контейнер, Query и modelContext не получат правильное хранилище. В проекте должен остаться ровно один struct с @main.
Шаг 2. Чтение через Query
Цель: Чтение через Query.
Попробуй сам: Прочитай книги с сортировкой по title. Покажи строки с автором и пустое состояние при отсутствии записей.
Показать решение шага 2
В ContentView.swift добавь код сразу после строкой import SwiftUI:
import SwiftDataВ ContentView.swift добавь код перед строкой var body: some View {:
@Query(sort: \Book.title) private var books: [Book]В ContentView.swift найди этот блок:
Text("Начало")Замени его следующим блоком; остальной код файла сохрани:
NavigationStack {
List {
ForEach(books) { book in
VStack(alignment: .leading) {
Text(book.title).font(.headline)
Text(book.author).foregroundStyle(.secondary)
}
}
}
.overlay { if books.isEmpty { ContentUnavailableView("Книг нет", systemImage: "book") } }
.navigationTitle("Bookworm")
}Ожидаемый результат: На новой базе показано «Книг нет». Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: @Query выполняет fetch и обновляет View после изменений моделей. Это не отдельный массив-копия, который нужно вручную синхронизировать с базой.
Запись sort: \Book.title указывает свойство сортировки через key path. Свойство books не заполняется вручную: Query получает записи из подключённого контейнера. Пустой массив на новой базе — правильный результат, поэтому сначала проверяем понятный пустой экран.
Шаг 3. Добавление книги
Цель: Добавление книги.
Попробуй сам: Получай modelContext из environment. Добавь поля title/author и кнопку вставки с проверкой пробелов.
Показать решение шага 3
В ContentView.swift добавь код перед строкой var body: some View {:
@Environment(\.modelContext) private var context
@State private var title = ""
@State private var author = ""
private func addBook() {
context.insert(Book(title: title, author: author))
title = ""; author = ""
}В ContentView.swift найди этот блок:
List {
ForEachЗамени его следующим блоком; остальной код файла сохрани:
List {
Section("Новая книга") {
TextField("Название", text: $title)
TextField("Автор", text: $author)
Button("Добавить", action: addBook)
.disabled(title.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || author.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty)
}
ForEachВ ContentView.swift найди этот блок:
.overlay { if books.isEmpty { ContentUnavailableView("Книг нет", systemImage: "book") } }Замени его следующим блоком; остальной код файла сохрани:
Ожидаемый результат: После добавления книга появляется в отсортированном списке, поля очищаются. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: context.insert добавляет model в контекст. Изменения отслеживает Query; Array вручную менять не нужно.
context.insert(...) начинает отслеживание нового объекта. Query замечает вставку и обновляет список. Поля формы — временное состояние ввода, а Book — запись базы: очищая title и author, мы не очищаем свойства уже созданной книги. Попробуй добавить две книги в обратном алфавитном порядке.
Шаг 4. Удаление и сохранение ошибок
Цель: Удаление и сохранение ошибок.
Попробуй сам: Добавь onDelete и явный save после вставки и удаления. При ошибке откати изменения контекста и покажи alert.
Показать решение шага 4
В ContentView.swift добавь код перед строкой var body: some View {:
@State private var errorMessage: String?
private func save() -> Bool {
do { try context.save(); return true }
catch { context.rollback(); errorMessage = error.localizedDescription; return false }
}В ContentView.swift найди этот блок:
context.insert(Book(title: title, author: author))Замени его следующим блоком; остальной код файла сохрани:
context.insert(Book(title: title, author: author))
guard save() else { return }В ContentView.swift найди этот блок:
}
}
.navigationTitle("Bookworm")Замени его следующим блоком; остальной код файла сохрани:
}
.onDelete { indexes in
for index in indexes { context.delete(books[index]) }
_ = save()
}
if books.isEmpty { Text("Книг нет — добавь первую выше") }
}
.navigationTitle("Bookworm")
.alert("Ошибка сохранения", isPresented: Binding(
get: { errorMessage != nil }, set: { if !$0 { errorMessage = nil } }
)) { Button("OK") { errorMessage = nil } }
message: { Text(errorMessage ?? "") }Ожидаемый результат: Удаление убирает книгу; после перезапуска успешные изменения остаются. Ошибка записи показана пользователю. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: SwiftData поддерживает autosave, но явный save позволяет показать результат операции здесь. rollback возвращает контекст к последнему сохранённому состоянию при ошибке.
save фиксирует изменения контекста на диске. Если он завершился ошибкой, возвращаем false и не очищаем поля формы: пользователь может повторить действие. rollback убирает несохранённые изменения context, поэтому UI снова соответствует последнему сохранённому набору.
Шаг 5. Отзыв в деталях
Цель: Отзыв в деталях.
Попробуй сам: Добавь review с пустым default и отдельный BookDetailView с TextEditor. Открой его по нажатию книги; сохраняй кнопкой «Сохранить отзыв».
Показать решение шага 5
В Book.swift найди этот блок:
var author: StringЗамени его следующим блоком; остальной код файла сохрани:
var author: String
var review: String = ""BookDetailView.swift — создай файл и включи его в target приложения.
import SwiftUI
import SwiftData
struct BookDetailView: View {
@Bindable var book: Book
@Environment(\.modelContext) private var context
@State private var message = ""
var body: some View {
Form {
Text(book.author)
TextEditor(text: $book.review).frame(minHeight: 140)
Button("Сохранить отзыв") {
do { try context.save(); message = "Сохранено" }
catch { message = "Ошибка: \(error.localizedDescription)" }
}
Text(message)
}
.navigationTitle(book.title)
}
}В ContentView.swift найди этот блок:
VStack(alignment: .leading) {
Text(book.title).font(.headline)
Text(book.author).foregroundStyle(.secondary)
}Замени его следующим блоком; остальной код файла сохрани:
NavigationLink { BookDetailView(book: book) } label: {
VStack(alignment: .leading) {
Text(book.title).font(.headline)
Text(book.author).foregroundStyle(.secondary)
}
}Ожидаемый результат: Отзыв редактируется и остаётся после успешного сохранения и перезапуска. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: @Bindable даёт Binding к property @Model. Передаём ту же книгу, context берём из окружения. Совместимый default нужен для уже существующих учебных записей.
@Bindable var book позволяет TextEditor получить $book.review. При обычном let доступно чтение, но не такая привязка к свойству модели. Default пустой строки задаёт значение отзыва для новой property у существующих учебных записей. Кнопка сохранения показывает отдельное сообщение — видимое редактирование ещё не доказывает запись на диск.
Шаг 6. Общий RatingView
Цель: Общий RatingView.
Попробуй сам: Добавь rating с default 3, создай пять кнопок-звёзд с @Binding rating и покажи их в деталях.
Показать решение шага 6
В Book.swift найди этот блок:
var review: String = ""Замени его следующим блоком; остальной код файла сохрани:
var review: String = ""
var rating: Int = 3RatingView.swift — создай файл и включи его в target приложения.
import SwiftUI
struct RatingView: View {
@Binding var rating: Int
var body: some View {
HStack {
ForEach(1...5, id: \.self) { number in
Button { rating = number } label: {
Image(systemName: number <= rating ? "star.fill" : "star")
}
.buttonStyle(.plain)
.accessibilityLabel("Оценить на \(number) из 5")
}
}
}
}В BookDetailView.swift найди этот блок:
Text(book.author)Замени его следующим блоком; остальной код файла сохрани:
Text(book.author)
RatingView(rating: $book.rating)Ожидаемый результат: Нажатие звезды меняет оценку, кнопка сохранения сохраняет её вместе с отзывом. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Родитель владеет значением, RatingView получает Binding. Этот компонент можно переиспользовать вне SwiftData: он ничего не знает о Book и context.
Каждая кнопка присваивает номер выбранной звезды. .buttonStyle(.plain) помогает избежать поведения строки Form, при котором нажатие могло бы восприниматься как действие всей строки. Label доступности говорит «Оценить на N из 5», то есть действие, а не просто имя изображения star.fill.
Глубже — необязательно
Advanced: отдельная база для Preview
Не используй пользовательский store в тестах и Preview. ModelConfiguration(isStoredInMemoryOnly: true) создаёт временную базу. Индексы, ограничения и миграции изучай после уверенной работы с model, context и Query.
Самостоятельное изменение
Испытание
Задание
Добавь genre с default «Другое» и Picker жанра в детали.Что уже нужно знать
Используй состояние и функции, которые уже собрал в этом проекте.Показать подсказку 1
Показать подсказку 2
Показать решение
// В Book:
var genre: String = "Другое"
// В Form BookDetailView:
Picker("Жанр", selection: $book.genre) {
ForEach(["Другое", "Роман", "Научпоп"], id: \.self) { Text($0) }
}Reference: полный код проекта
Основной маршрут, без самостоятельного challenge. Используй этот блок для сверки уже собранного приложения.
Открыть все итоговые файлы проекта
ContentView.swift
import SwiftUI
import SwiftData
struct ContentView: View {
@Query(sort: \Book.title) private var books: [Book]
@Environment(\.modelContext) private var context
@State private var title = ""
@State private var author = ""
private func addBook() {
context.insert(Book(title: title, author: author))
guard save() else { return }
title = ""; author = ""
}
@State private var errorMessage: String?
private func save() -> Bool {
do { try context.save(); return true }
catch { context.rollback(); errorMessage = error.localizedDescription; return false }
}
var body: some View {
NavigationStack {
List {
Section("Новая книга") {
TextField("Название", text: $title)
TextField("Автор", text: $author)
Button("Добавить", action: addBook)
.disabled(title.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || author.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty)
}
ForEach(books) { book in
NavigationLink { BookDetailView(book: book) } label: {
VStack(alignment: .leading) {
Text(book.title).font(.headline)
Text(book.author).foregroundStyle(.secondary)
}
}
}
.onDelete { indexes in
for index in indexes { context.delete(books[index]) }
_ = save()
}
if books.isEmpty { Text("Книг нет — добавь первую выше") }
}
.navigationTitle("Bookworm")
.alert("Ошибка сохранения", isPresented: Binding(
get: { errorMessage != nil }, set: { if !$0 { errorMessage = nil } }
)) { Button("OK") { errorMessage = nil } }
message: { Text(errorMessage ?? "") }
}
}
}BookwormApp.swift
import SwiftUI
import SwiftData
@main
struct BookwormApp: App {
var body: some Scene {
WindowGroup { ContentView() }
.modelContainer(for: Book.self)
}
}Book.swift
import SwiftData
@Model
final class Book {
var title: String
var author: String
var review: String = ""
var rating: Int = 3
init(title: String, author: String) { self.title = title; self.author = author }
}BookDetailView.swift
import SwiftUI
import SwiftData
struct BookDetailView: View {
@Bindable var book: Book
@Environment(\.modelContext) private var context
@State private var message = ""
var body: some View {
Form {
Text(book.author)
RatingView(rating: $book.rating)
TextEditor(text: $book.review).frame(minHeight: 140)
Button("Сохранить отзыв") {
do { try context.save(); message = "Сохранено" }
catch { message = "Ошибка: \(error.localizedDescription)" }
}
Text(message)
}
.navigationTitle(book.title)
}
}RatingView.swift
import SwiftUI
struct RatingView: View {
@Binding var rating: Int
var body: some View {
HStack {
ForEach(1...5, id: \.self) { number in
Button { rating = number } label: {
Image(systemName: number <= rating ? "star.fill" : "star")
}
.buttonStyle(.plain)
.accessibilityLabel("Оценить на \(number) из 5")
}
}
}
}Что ты сейчас использовал
Swift Знакомые основы
SwiftUI Новое в проекте
- + Form
- + SwiftData
- + @Query
- + Environment
- + Custom View
Теперь разберём SwiftData глубже: Project 12 →.