Project 10 — Cupcake Corner
Cupcake Corner проводит пользователя через заказ кексов, проверяет адрес и отправляет JSON на сервер. Это первый полный цикл «форма → model → networking → результат».
Готовность к проекту
0 из 7 рекомендуемых тем изучено. Проект всегда доступен — это не ограничение.
Стартовая точка
Создай новый iOS → App с именем CupcakeCorner и интерфейсом SwiftUI. В сгенерированном ContentView.swift оставь минимальное состояние ниже. Сохрани файл CupcakeCornerApp.swift, созданный Xcode; если шаг меняет точку входа, замени существующий файл, не создавай второй @main.
import SwiftUI
struct ContentView: View {
var body: some View {
Text("Начало")
}
}Сначала прочитай задание шага и попробуй выполнить его. Решение закрыто: открой его для сверки или если застрял. Применяй изменения по порядку — каждый шаг опирается на предыдущий.
Шаг 1. Заказ и количество
Цель: Заказ и количество.
Попробуй сам: Создай Order с quantity, name и city. Покажи Stepper количества кексов 1…20.
Показать решение шага 1
Order.swift — создай файл и включи его в target приложения.
struct Order: Codable {
var quantity = 3
var name = ""
var city = ""
}В ContentView.swift добавь код перед строкой var body: some View {:
@State private var order = Order()В ContentView.swift найди этот блок:
Text("Начало")Замени его следующим блоком; остальной код файла сохрани:
NavigationStack {
Form {
Stepper("Кексов: \(order.quantity)", value: $order.quantity, in: 1...20)
}
.navigationTitle("Cupcake Corner")
}Ожидаемый результат: Количество изменяется и остаётся в разрешённом диапазоне. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Для передачи между экранами используем значение Order и Binding. Это ещё один способ общего состояния: owner один, дочерний экран редактирует ту же запись через привязку.
Order — обычный Codable struct. На первом шаге он используется только как хранилище значений: Codable пригодится при отправке, но не меняет работу Stepper. order.quantity читает число, $order.quantity позволяет контролу изменить его у владельца.
Шаг 2. Экран адреса
Цель: Экран адреса.
Попробуй сам: Создай AddressView с @Binding order и полями имени и города. Открой через NavigationLink.
Показать решение шага 2
AddressView.swift — создай файл и включи его в target приложения.
import SwiftUI
struct AddressView: View {
@Binding var order: Order
var body: some View {
Form {
TextField("Имя", text: $order.name)
TextField("Город", text: $order.city)
}
.navigationTitle("Адрес")
}
}В ContentView.swift найди этот блок:
Stepper("Кексов: \(order.quantity)", value: $order.quantity, in: 1...20)Замени его следующим блоком; остальной код файла сохрани:
Stepper("Кексов: \(order.quantity)", value: $order.quantity, in: 1...20)
NavigationLink("Адрес") { AddressView(order: $order) }Ожидаемый результат: Адрес сохраняется при переходе назад и повторном открытии формы. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Binding не создаёт копию Order: запись изменяется у ContentView. NavigationLink с destination closure достаточен для одного перехода.
@Binding var order: Order объявляет привязку, которую обязан предоставить родитель. Поэтому initializer вызывается с $order, а не order. Если передать обычную копию структуры и создать новый @State в AddressView, изменения адреса перестанут надёжно возвращаться назад. Проверь это через переход туда и обратно.
Шаг 3. Цена и проверка формы
Цель: Цена и проверка формы.
Попробуй сам: В Order вычисли цену по 2 условные единицы за кекс и допустимость имени/города после trimming. Покажи цену и кнопку локальной проверки.
Показать решение шага 3
В Order.swift найди этот блок:
struct Order: Codable {Замени его следующим блоком; остальной код файла сохрани:
import Foundation
struct Order: Codable {
var cost: Decimal { Decimal(quantity) * 2 }
var hasValidAddress: Bool {
!name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty &&
!city.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
}В AddressView.swift добавь код перед строкой var body: some View {:
@State private var message = ""В AddressView.swift найди этот блок:
TextField("Город", text: $order.city)Замени его следующим блоком; остальной код файла сохрани:
TextField("Город", text: $order.city)
Text("Цена: \(order.cost.description)")
Button("Проверить") { message = "Готово к отправке: \(order.quantity)" }
.disabled(!order.hasValidAddress)
Text(message)Ожидаемый результат: Пробелы не считаются адресом; при корректном вводе проверка показывает число кексов. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Вычисляемые свойства не могут рассинхронизироваться с полями. Это чистая логика, к которой уже можно написать небольшой Swift Testing-тест после соответствующего bridge-урока.
Проверка пробелов выполняется над текущими строками, не над отдельно сохранённым результатом. Цена использует Decimal, чтобы демонстрировать десятичную арифметику. Здесь две условные единицы за кекс — учебное правило, не скрытая валюта или реальный тариф. Проверь quantity = 3: цена должна быть 6.
Шаг 4. Асинхронное состояние отправки
Цель: Асинхронное состояние отправки.
Попробуй сам: Замени проверку учебной задержкой async/await. Во время ожидания блокируй повторное действие и показывай ProgressView. Подпиши результат как локальную демонстрацию.
Показать решение шага 4
В AddressView.swift добавь код перед строкой var body: some View {:
@State private var isSending = false
private func submit() async {
isSending = true
message = ""
defer { isSending = false }
do {
try await Task.sleep(for: .seconds(1))
message = "Локальная демонстрация завершена"
} catch { message = "Демонстрация отменена" }
}В AddressView.swift найди этот блок:
Button("Проверить") { message = "Готово к отправке: \(order.quantity)" }
.disabled(!order.hasValidAddress)Замени его следующим блоком; остальной код файла сохрани:
Button("Отправить учебный заказ") { Task { await submit() } }
.disabled(!order.hasValidAddress || isSending)
if isSending { ProgressView("Отправка…") }Ожидаемый результат: Во время ожидания интерфейс остаётся отзывчивым; после него написано «Локальная демонстрация завершена». Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Task запускает async-функцию из синхронной кнопки. defer восстанавливает isSending и при успехе, и при ошибке; здесь ещё нет сетевого запроса и реального заказа.
Task { await submit() } соединяет действие кнопки с async-функцией. Внутри Task.sleep приостанавливает задачу, а не блокирует главный поток ожиданием. Код после await продолжает выполнение, когда ожидание завершилось. Попробуй нажать кнопку второй раз во время задержки: isSending должен блокировать дублирование.
Шаг 5. JSON и HTTP
Цель: JSON и HTTP.
Попробуй сам: Отправь вымышленные имя и город на тестовый echo endpoint https://httpbin.org/anything. Проверь HTTP status, декодируй поле json и покажи количество из ответа.
Показать решение шага 5
В AddressView.swift найди этот блок:
try await Task.sleep(for: .seconds(1))
message = "Локальная демонстрация завершена"Замени его следующим блоком; остальной код файла сохрани:
guard let url = URL(string: "https://httpbin.org/anything") else { throw URLError(.badURL) }
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode(order)
let (data, response) = try await URLSession.shared.data(for: request)
guard let http = response as? HTTPURLResponse,
(200..<300).contains(http.statusCode) else { throw URLError(.badServerResponse) }
let echoed = try JSONDecoder().decode(EchoResponse.self, from: data)
try Task.checkCancellation()
message = "Учебный echo подтвердил: \(echoed.json.quantity) кексов"В AddressView.swift найди этот блок:
} catch { message = "Демонстрация отменена" }Замени его следующим блоком; остальной код файла сохрани:
} catch is CancellationError {
message = "Отправка отменена"
} catch {
message = "Не удалось отправить: \(error.localizedDescription)"
}EchoResponse.swift — создай файл и включи его в target приложения.
struct EchoResponse: Decodable { let json: Order }Ожидаемый результат: При доступном сервисе отображается подтверждение echo с количеством; без сети появляется ошибка и можно повторить. Это не магазин и не реальный заказ. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: URLSession возвращает Data и response. Успешная передача не гарантирует статус 2xx. Echo возвращает отправленный JSON в поле json; отдельный Decodable описывает этот ответ. Используй только вымышленные данные.
httpMethod = "POST" сообщает тип запроса, Content-Type описывает формат body. Ответ echo — объект с полем json, поэтому декодируем EchoResponse, а уже внутри него находится Order. Проверка статуса стоит до декодирования: HTML-страницу ошибки не надо пытаться читать как успешный заказ. Исходные поля не очищаются, чтобы повторить запрос после ошибки. Описание сервиса: httpbin.
Глубже — необязательно
Глубже: изображение и жизненный цикл
После рабочего запроса добавь AsyncImage, отдельно обрабатывая loading, success и failure. Для ухода с экрана можно хранить handle Task и отменять его; сложные actor-boundary вопросы оставь до изучения actors/Sendable. Тестовый echo — внешний сервис и иногда недоступен: это нормальный сценарий ошибки, не повод подменять ответ успехом.
Самостоятельное изменение
Испытание
Задание
Добавь streetAddress и zip, включи их в hasValidAddress и форму.Что уже нужно знать
Используй состояние и функции, которые уже собрал в этом проекте.Показать подсказку 1
Показать подсказку 2
Показать решение
var streetAddress = ""
var zip = ""
// Добавь к hasValidAddress:
// && !streetAddress.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
// && !zip.trimmingCharacters(in: .whitespacesAndNewlines).isEmptyReference: полный код проекта
Основной маршрут, без самостоятельного challenge. Используй этот блок для сверки уже собранного приложения.
Открыть все итоговые файлы проекта
ContentView.swift
import SwiftUI
struct ContentView: View {
@State private var order = Order()
var body: some View {
NavigationStack {
Form {
Stepper("Кексов: \(order.quantity)", value: $order.quantity, in: 1...20)
NavigationLink("Адрес") { AddressView(order: $order) }
}
.navigationTitle("Cupcake Corner")
}
}
}CupcakeCornerApp.swift
import SwiftUI
@main
struct CupcakeCornerApp: App {
var body: some Scene {
WindowGroup { ContentView() }
}
}Order.swift
import Foundation
struct Order: Codable {
var cost: Decimal { Decimal(quantity) * 2 }
var hasValidAddress: Bool {
!name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty &&
!city.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
}
var quantity = 3
var name = ""
var city = ""
}AddressView.swift
import SwiftUI
struct AddressView: View {
@Binding var order: Order
@State private var message = ""
@State private var isSending = false
private func submit() async {
isSending = true
message = ""
defer { isSending = false }
do {
guard let url = URL(string: "https://httpbin.org/anything") else { throw URLError(.badURL) }
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode(order)
let (data, response) = try await URLSession.shared.data(for: request)
guard let http = response as? HTTPURLResponse,
(200..<300).contains(http.statusCode) else { throw URLError(.badServerResponse) }
let echoed = try JSONDecoder().decode(EchoResponse.self, from: data)
try Task.checkCancellation()
message = "Учебный echo подтвердил: \(echoed.json.quantity) кексов"
} catch is CancellationError {
message = "Отправка отменена"
} catch {
message = "Не удалось отправить: \(error.localizedDescription)"
}
}
var body: some View {
Form {
TextField("Имя", text: $order.name)
TextField("Город", text: $order.city)
Text("Цена: \(order.cost.description)")
Button("Отправить учебный заказ") { Task { await submit() } }
.disabled(!order.hasValidAddress || isSending)
if isSending { ProgressView("Отправка…") }
Text(message)
}
.navigationTitle("Адрес")
}
}EchoResponse.swift
struct EchoResponse: Decodable { let json: Order }Что ты сейчас использовал
Swift Знакомые основы
SwiftUI Новое в проекте
- + Form
- + Codable
- + Networking
Следующая тема — постоянная локальная база в Bookworm →.