Project 7 — iExpense
iExpense хранит личные и рабочие расходы, добавляет записи на отдельном экране и сохраняет их между запусками. Проект вводит shared reference state и persistence.
Готовность к проекту
0 из 7 рекомендуемых тем изучено. Проект всегда доступен — это не ограничение.
Стартовая точка
Создай новый iOS → App с именем iExpense и интерфейсом SwiftUI. В сгенерированном ContentView.swift оставь минимальное состояние ниже. Сохрани файл iExpenseApp.swift, созданный Xcode; если шаг меняет точку входа, замени существующий файл, не создавай второй @main.
import SwiftUI
struct ContentView: View {
var body: some View {
Text("Начало")
}
}Сначала прочитай задание шага и попробуй выполнить его. Решение закрыто: открой его для сверки или если застрял. Применяй изменения по порядку — каждый шаг опирается на предыдущий.
Шаг 1. Расход как значение
Цель: Расход как значение.
Попробуй сам: Создай ExpenseItem с id, name и amount. Покажи тестовую запись через List и ForEach.
Показать решение шага 1
ExpenseItem.swift — создай файл и включи его в target приложения.
import Foundation
struct ExpenseItem: Identifiable, Codable {
var id = UUID()
let name: String
let amount: Double
}В ContentView.swift добавь код перед строкой var body: some View {:
@State private var items = [ExpenseItem(name: "Кофе", amount: 250)]В ContentView.swift найди этот блок:
Text("Начало")Замени его следующим блоком; остальной код файла сохрани:
NavigationStack {
List {
ForEach(items) { item in
HStack {
Text(item.name)
Spacer()
Text(item.amount, format: .currency(code: "RUB"))
}
}
}
.navigationTitle("iExpense")
}Ожидаемый результат: В списке видны название и сумма каждого расхода. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Identifiable даёт строке стабильный UUID; имя расхода не подходит как id, потому что может повторяться. Пока данные принадлежат одному экрану.
Один расход — одна структура, а массив содержит набор таких значений. UUID создаётся при создании записи и не меняется при обновлении строки. У суммы тип Double, поэтому можно вводить дробные значения. В основной сборке категория ещё не нужна: её добавление останется самостоятельным упражнением.
Шаг 2. Один observable-владелец
Цель: Один observable-владелец.
Попробуй сам: Перенеси массив в @Observable class Expenses. Создай один экземпляр в @State ContentView и прочитай из него items.
Показать решение шага 2
Expenses.swift — создай файл и включи его в target приложения.
import Observation
@Observable
final class Expenses {
var items = [ExpenseItem(name: "Кофе", amount: 250)]
}В ContentView.swift найди этот блок:
@State private var items = [ExpenseItem(name: "Кофе", amount: 250)]Замени его следующим блоком; остальной код файла сохрани:
@State private var expenses = Expenses()В ContentView.swift найди этот блок:
ForEach(items)Замени его следующим блоком; остальной код файла сохрани:
ForEach(expenses.items)Ожидаемый результат: Список выглядит по-прежнему; все расходы теперь принадлежат объекту Expenses. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Класс имеет общую идентичность. @State удерживает экземпляр у владельца, @Observable отслеживает чтение properties. Перед этим шагом повтори bridge-урок Observation из prerequisites.
Если создать Expenses() отдельно для каждого экрана, получится два разных массива. Поэтому объект создаётся один раз у ContentView и позже передаётся дальше. @Observable не сохраняет данные на диск: он только помогает интерфейсу замечать изменения. Перезапуск на этом этапе всё ещё возвращает тестовые данные.
Шаг 3. Форма в sheet
Цель: Форма в sheet.
Попробуй сам: Создай AddExpenseView с полями названия и суммы. По кнопке «Добавить» покажи sheet. Пока закрой его системным свайпом.
Показать решение шага 3
AddExpenseView.swift — создай файл и включи его в target приложения.
import SwiftUI
struct AddExpenseView: View {
@State private var name = ""
@State private var amount = 0.0
var body: some View {
NavigationStack {
Form {
TextField("Название", text: $name)
TextField("Сумма", value: $amount, format: .number)
.keyboardType(.decimalPad)
}
.navigationTitle("Новый расход")
}
}
}В ContentView.swift добавь код перед строкой var body: some View {:
@State private var showingAdd = falseВ ContentView.swift найди этот блок:
.navigationTitle("iExpense")Замени его следующим блоком; остальной код файла сохрани:
.navigationTitle("iExpense")
.toolbar { Button("Добавить") { showingAdd = true } }
.sheet(isPresented: $showingAdd) { AddExpenseView() }Ожидаемый результат: Sheet открывается, поля редактируются, основной список не меняется. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Sheet — отдельный временный экран. Поля формы локальны для него; ещё не подтверждённый ввод не должен сразу изменять список.
showingAdd — состояние презентации у родителя, а name и amount принадлежат форме. Закрытие без подтверждения уничтожит этот несохранённый ввод, что здесь ожидаемо. Пока форма не получает Expenses, у неё даже нет возможности случайно изменить основную коллекцию.
Шаг 4. Сохранение формы в общую модель
Цель: Сохранение формы в общую модель.
Попробуй сам: Передай тот же Expenses в AddExpenseView. Кнопка «Сохранить» добавляет запись и закрывает форму; пустое имя и неположительная сумма запрещены.
Показать решение шага 4
В AddExpenseView.swift добавь код перед строкой var body: some View {:
let expenses: Expenses
@Environment(\.dismiss) private var dismissВ AddExpenseView.swift найди этот блок:
.navigationTitle("Новый расход")Замени его следующим блоком; остальной код файла сохрани:
.navigationTitle("Новый расход")
.toolbar {
Button("Сохранить") {
expenses.items.append(ExpenseItem(name: name, amount: amount))
dismiss()
}
.disabled(name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || amount <= 0)
}В ContentView.swift найди этот блок:
AddExpenseView()Замени его следующим блоком; остальной код файла сохрани:
AddExpenseView(expenses: expenses)Ожидаемый результат: Новая запись появляется на основном экране сразу после закрытия sheet. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Дочерний экран получает объект обычным let: второй @State не нужен. @Environment dismiss даёт действие закрытия. @Bindable понадобился бы для прямого Binding к property объекта, но здесь мы вызываем append.
dismiss — действие из окружения текущего sheet. Оно вызывается после append, поэтому родитель уже читает обновлённый массив, когда форма закрывается. Проверка .disabled вычисляется заново при каждом вводе; отдельный флаг валидности не нужен. Проверь пустое имя, пробелы, нулевую и положительную сумму.
Шаг 5. Удаление и пустой список
Цель: Удаление и пустой список.
Попробуй сам: Подключи onDelete к ForEach и покажи ContentUnavailableView, когда массив пуст.
Показать решение шага 5
В ContentView.swift найди этот блок:
}
}
.navigationTitle("iExpense")Замени его следующим блоком; остальной код файла сохрани:
}
.onDelete { expenses.items.remove(atOffsets: $0) }
}
.overlay {
if expenses.items.isEmpty {
ContentUnavailableView("Расходов нет", systemImage: "creditcard")
}
}
.navigationTitle("iExpense")Ожидаемый результат: Свайп удаляет запись, удаление последней показывает «Расходов нет». Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: onDelete сообщает IndexSet исходного ForEach. Пока список не фильтруется, эти индексы совпадают с массивом модели; после фильтрации удалять нужно по id.
atOffsets принимает набор индексов, потому что системное удаление может выбрать несколько строк. Подключай onDelete именно к ForEach, описывающему эти строки. При пустом массиве overlay объясняет отсутствие данных, но кнопка добавления в toolbar остаётся доступной — ученик не попадает в тупик.
Шаг 6. JSON между запусками
Цель: JSON между запусками.
Попробуй сам: В Expenses декодируй сохранённый массив из UserDefaults при создании. После изменения items кодируй его обратно. Ошибку чтения или кодирования покажи через alert.
Показать решение шага 6
Expenses.swift — замени файл целиком; здесь меняется его связная структура.
import Foundation
import Observation
@Observable
final class Expenses {
var items: [ExpenseItem] = [] { didSet { save() } }
var persistenceError: String?
init() {
guard let data = UserDefaults.standard.data(forKey: "expenses") else { return }
do {
items = try JSONDecoder().decode([ExpenseItem].self, from: data)
} catch {
persistenceError = "Не удалось прочитать сохранённые расходы: \(error.localizedDescription)"
}
}
private func save() {
do {
let data = try JSONEncoder().encode(items)
UserDefaults.standard.set(data, forKey: "expenses")
persistenceError = nil
} catch {
persistenceError = "Не удалось сохранить расходы: \(error.localizedDescription)"
}
}
}В ContentView.swift найди этот блок:
.navigationTitle("iExpense")Замени его следующим блоком; остальной код файла сохрани:
.navigationTitle("iExpense")
.alert("Ошибка данных", isPresented: Binding(
get: { expenses.persistenceError != nil },
set: { if !$0 { expenses.persistenceError = nil } }
)) { Button("OK") { expenses.persistenceError = nil } }
message: { Text(expenses.persistenceError ?? "") }Ожидаемый результат: Добавленные расходы сохраняются после закрытия и открытия приложения; ошибка данных не исчезает молча. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Codable преобразует массив в Data. didSet реагирует на изменение items. Здесь небольшой учебный массив; ошибки чтения и записи имеют отдельное видимое состояние.
JSONEncoder().encode(items) возвращает Data, а decoder восстанавливает тот же тип [ExpenseItem]. Ключ expenses при чтении и записи должен совпадать. В init отсутствующий ключ означает первый запуск и не является ошибкой; существующие повреждённые данные — уже другая ситуация, которую показывает persistenceError.
Самостоятельное изменение
Испытание
Задание
Добавь категории «Личное» и «Работа», затем покажи расходы отдельными секциями.Что уже нужно знать
Используй состояние и функции, которые уже собрал в этом проекте.Показать подсказку 1
Показать подсказку 2
Показать решение
// Property ExpenseItem с default сохраняет совместимость новой записи:
var type = "Личное"
// Для секции вычисляй:
expenses.items.filter { $0.type == "Личное" }
// Для выбранного item удаляй из исходного массива:
expenses.items.removeAll { $0.id == item.id }Reference: полный код проекта
Основной маршрут, без самостоятельного challenge. Используй этот блок для сверки уже собранного приложения.
Открыть все итоговые файлы проекта
ContentView.swift
import SwiftUI
struct ContentView: View {
@State private var expenses = Expenses()
@State private var showingAdd = false
var body: some View {
NavigationStack {
List {
ForEach(expenses.items) { item in
HStack {
Text(item.name)
Spacer()
Text(item.amount, format: .currency(code: "RUB"))
}
}
.onDelete { expenses.items.remove(atOffsets: $0) }
}
.overlay {
if expenses.items.isEmpty {
ContentUnavailableView("Расходов нет", systemImage: "creditcard")
}
}
.navigationTitle("iExpense")
.alert("Ошибка данных", isPresented: Binding(
get: { expenses.persistenceError != nil },
set: { if !$0 { expenses.persistenceError = nil } }
)) { Button("OK") { expenses.persistenceError = nil } }
message: { Text(expenses.persistenceError ?? "") }
.toolbar { Button("Добавить") { showingAdd = true } }
.sheet(isPresented: $showingAdd) { AddExpenseView(expenses: expenses) }
}
}
}iExpenseApp.swift
import SwiftUI
@main
struct iExpenseApp: App {
var body: some Scene {
WindowGroup { ContentView() }
}
}ExpenseItem.swift
import Foundation
struct ExpenseItem: Identifiable, Codable {
var id = UUID()
let name: String
let amount: Double
}Expenses.swift
import Foundation
import Observation
@Observable
final class Expenses {
var items: [ExpenseItem] = [] { didSet { save() } }
var persistenceError: String?
init() {
guard let data = UserDefaults.standard.data(forKey: "expenses") else { return }
do {
items = try JSONDecoder().decode([ExpenseItem].self, from: data)
} catch {
persistenceError = "Не удалось прочитать сохранённые расходы: \(error.localizedDescription)"
}
}
private func save() {
do {
let data = try JSONEncoder().encode(items)
UserDefaults.standard.set(data, forKey: "expenses")
persistenceError = nil
} catch {
persistenceError = "Не удалось сохранить расходы: \(error.localizedDescription)"
}
}
}AddExpenseView.swift
import SwiftUI
struct AddExpenseView: View {
@State private var name = ""
@State private var amount = 0.0
let expenses: Expenses
@Environment(\.dismiss) private var dismiss
var body: some View {
NavigationStack {
Form {
TextField("Название", text: $name)
TextField("Сумма", value: $amount, format: .number)
.keyboardType(.decimalPad)
}
.navigationTitle("Новый расход")
.toolbar {
Button("Сохранить") {
expenses.items.append(ExpenseItem(name: name, amount: amount))
dismiss()
}
.disabled(name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || amount <= 0)
}
}
}
}Что ты сейчас использовал
Swift Знакомые основы
SwiftUI Новое в проекте
- + @State
- + Binding и $property
- + Navigation
- + Observable state
- + UserDefaults
- + Codable
- + sheet
Дальше загрузим более сложные локальные данные в Moonshot →.