Project 14 — Bucket List
Bucket List хранит памятные места на карте. Пользователь добавляет точки, редактирует название и описание, сохраняет список в файл. Защиту через Face ID или Touch ID разберём после рабочей карты в дополнительном блоке.
Готовность к проекту
0 из 6 рекомендуемых тем изучено. Проект всегда доступен — это не ограничение.
Стартовая точка
Создай новый iOS → App с именем BucketList и интерфейсом SwiftUI. В сгенерированном ContentView.swift оставь минимальное состояние ниже. Сохрани файл BucketListApp.swift, созданный Xcode; если шаг меняет точку входа, замени существующий файл, не создавай второй @main.
import SwiftUI
struct ContentView: View {
var body: some View {
Text("Начало")
}
}Сначала прочитай задание шага и попробуй выполнить его. Решение закрыто: открой его для сверки или если застрял. Применяй изменения по порядку — каждый шаг опирается на предыдущий.
Шаг 1. Карта
Цель: Карта.
Попробуй сам: Подключи MapKit и покажи Map без собственных точек.
Показать решение шага 1
В ContentView.swift добавь код сразу после строкой import SwiftUI:
import MapKitВ ContentView.swift найди этот блок:
Text("Начало")Замени его следующим блоком; остальной код файла сохрани:
Map()Ожидаемый результат: Отображается карта, которую можно перемещать и масштабировать. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Map отображает картографические данные. Для карты без текущей геолокации пользователя разрешение на location не требуется.
Map сам управляет стандартными жестами перемещения и масштаба. Пока не добавляем запрос текущей позиции: это отдельная возможность с собственным разрешением. Для проверки достаточно появления картографической подложки и реакции на жесты; при отсутствии сети новые тайлы могут загружаться не сразу.
Шаг 2. Модель места и Marker
Цель: Модель места и Marker.
Попробуй сам: Создай Codable Location с UUID, названием, описанием, широтой и долготой. Покажи тестовую точку Эрмитажа через Marker.
Показать решение шага 2
Location.swift — создай файл и включи его в target приложения.
import Foundation
import MapKit
struct Location: Identifiable, Codable, Equatable {
var id = UUID()
var name: String
var description = ""
let latitude: Double
let longitude: Double
var coordinate: CLLocationCoordinate2D { .init(latitude: latitude, longitude: longitude) }
}В ContentView.swift добавь код перед строкой var body: some View {:
@State private var locations = [Location(name: "Эрмитаж", latitude: 59.9398, longitude: 30.3146)]В ContentView.swift найди этот блок:
Map()Замени его следующим блоком; остальной код файла сохрани:
Map {
ForEach(locations) { location in
Marker(location.name, coordinate: location.coordinate)
}
}Ожидаемый результат: Карта показывает одну подписанную точку. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Координаты сохраняем как Double, а CLLocationCoordinate2D вычисляем для Map. Так модель остаётся Codable без ручного кодирования framework-типа.
Location — value type, поэтому её можно скопировать для редактирования. id отличает место от других даже при одинаковом названии. Computed coordinate создаёт framework-значение только там, где его требует Marker; сохранение по-прежнему работает с обычными числами.
Шаг 3. Добавление точки касанием
Цель: Добавление точки касанием.
Попробуй сам: Оберни Map в MapReader. Преобразуй локальную позицию tap в координату и добавь новую Location.
Показать решение шага 3
В ContentView.swift найди этот блок:
Map {
ForEach(locations) { location in
Marker(location.name, coordinate: location.coordinate)
}
}Замени его следующим блоком; остальной код файла сохрани:
MapReader { proxy in
Map {
ForEach(locations) { location in
Marker(location.name, coordinate: location.coordinate)
}
}
.onTapGesture { position in
guard let coordinate = proxy.convert(position, from: .local) else { return }
locations.append(Location(name: "Новое место", latitude: coordinate.latitude, longitude: coordinate.longitude))
}
}Ожидаемый результат: Касание пустого места создаёт новую точку; Optional-преобразование не вызывает падения. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: MapProxy переводит координаты View в географические координаты. Проверяй guard let, потому что преобразование может быть недоступно.
Позиция tap измеряется внутри View, latitude и longitude — на Земле. Поэтому нельзя просто записать position.x в longitude. Proxy учитывает масштаб и положение карты. Попробуй добавить точки при двух разных масштабах: они должны оставаться привязаны к географии.
Шаг 4. Редактирование копии
Цель: Редактирование копии.
Попробуй сам: Сделай annotation кнопкой и покажи EditLocationView через sheet(item:). Редактируй копию и возвращай её через onSave.
Показать решение шага 4
EditLocationView.swift — создай файл и включи его в target приложения.
import SwiftUI
struct EditLocationView: View {
@Environment(\.dismiss) private var dismiss
@State var location: Location
let onSave: (Location) -> Void
var body: some View {
NavigationStack {
Form {
TextField("Название", text: $location.name)
TextField("Описание", text: $location.description)
}
.toolbar {
Button("Отмена") { dismiss() }
Button("Сохранить") { onSave(location); dismiss() }
.disabled(location.name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty)
}
}
}
}В ContentView.swift добавь код перед строкой var body: some View {:
@State private var selection: Location?В ContentView.swift найди этот блок:
Marker(location.name, coordinate: location.coordinate)Замени его следующим блоком; остальной код файла сохрани:
Annotation(location.name, coordinate: location.coordinate) {
Button { selection = location } label: {
Image(systemName: "star.circle.fill").font(.title)
}
.accessibilityLabel("Изменить \(location.name)")
}В ContentView.swift найди этот блок:
.onTapGesture { position inЗамени его следующим блоком; остальной код файла сохрани:
.sheet(item: $selection) { location in
EditLocationView(location: location) { updated in
guard let index = locations.firstIndex(where: { $0.id == updated.id }) else { return }
locations[index] = updated
}
}
.onTapGesture { position inОжидаемый результат: Нажатие значка открывает форму; «Сохранить» заменяет место по id, отмена оставляет исходное значение. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Копия защищает ещё не подтверждённый ввод. Closure возвращает результат владельцу массива. Идентификатор остаётся прежним, даже когда название изменилось.
.sheet(item:) использует Optional: nil означает закрытую форму, выбранная Location — открытую. EditLocationView получает исходное значение в собственный @State и передаёт подтверждённую копию через closure. Поиск по id при сохранении нужен потому, что название пользователь мог изменить.
Шаг 5. Файловое сохранение
Цель: Файловое сохранение.
Попробуй сам: Сохраняй JSON в documentsDirectory после добавления и редактирования. При первом запуске отсутствие файла нормально; повреждённый файл покажи как ошибку.
Показать решение шага 5
В ContentView.swift добавь код перед строкой var body: some View {:
private let saveURL = URL.documentsDirectory.appending(path: "locations.json")
@State private var errorMessage: String?
@State private var canSave = true
private func load() {
guard FileManager.default.fileExists(atPath: saveURL.path) else { return }
do { locations = try JSONDecoder().decode([Location].self, from: Data(contentsOf: saveURL)) }
catch { canSave = false; errorMessage = "Не удалось прочитать места: \(error.localizedDescription)" }
}
private func save() {
guard canSave else { errorMessage = "Сначала восстанови повреждённый файл мест"; return }
do {
try JSONEncoder().encode(locations).write(to: saveURL, options: [.atomic, .completeFileProtection])
} catch { errorMessage = "Не удалось сохранить: \(error.localizedDescription)" }
}В ContentView.swift найди этот блок:
locations[index] = updatedЗамени его следующим блоком; остальной код файла сохрани:
locations[index] = updated
save()В ContentView.swift найди этот блок:
locations.append(Location(name: "Новое место", latitude: coordinate.latitude, longitude: coordinate.longitude))Замени его следующим блоком; остальной код файла сохрани:
locations.append(Location(name: "Новое место", latitude: coordinate.latitude, longitude: coordinate.longitude))
save()В ContentView.swift найди этот блок:
.sheet(item: $selection)Замени его следующим блоком; остальной код файла сохрани:
.task { load() }
.alert("Ошибка данных", isPresented: Binding(
get: { errorMessage != nil }, set: { if !$0 { errorMessage = nil } }
)) { Button("OK") { errorMessage = nil } }
message: { Text(errorMessage ?? "") }
.sheet(item: $selection)Ожидаемый результат: Новые точки и названия переживают перезапуск. Ошибка чтения или записи видна на карте. Выполни Build, затем Run и проверь это поведение перед продолжением.
Новые концепции: Data.write с atomic заменяет файл целиком. File protection действует при блокировке устройства; это отличается от отдельного экрана входа. После ошибки чтения не перезаписываем файл автоматически.
documentsDirectory — каталог данных конкретного приложения. .atomic сначала подготавливает новую версию файла и затем заменяет старую, уменьшая риск частичной записи. При ошибке чтения canSave запрещает незаметно затереть повреждённый файл новыми тестовыми данными. В учебной проверке используй только созданные тобой записи.
Глубже — необязательно
Глубже: Face ID / Touch ID
Сначала попробуй закрыть карту экраном с кнопкой «Открыть». Добавь NSFaceIDUsageDescription в Target → Info. Следующий самостоятельный пример показывает весь цикл аутентификации; он не заменяет собранную карту и не сохраняет места. После проверки перенеси ветку карты и её загрузку внутрь if isUnlocked.
import SwiftUI
import MapKit
import LocalAuthentication
struct Location: Identifiable {
let id = UUID()
let name: String
let coordinate: CLLocationCoordinate2D
}
struct ContentView: View {
@State private var isUnlocked = false
@State private var message = "Откройте список мест"
private let locations = [
Location(name: "Эрмитаж", coordinate: .init(latitude: 59.9398, longitude: 30.3146))
]
var body: some View {
Group {
if isUnlocked {
Map {
ForEach(locations) { location in
Marker(location.name, coordinate: location.coordinate)
}
}
} else {
ContentUnavailableView {
Label("Места закрыты", systemImage: "lock")
} description: {
Text(message)
} actions: {
Button("Открыть") { Task { await authenticate() } }
.buttonStyle(.borderedProminent)
}
}
}
}
@MainActor
private func authenticate() async {
let context = LAContext()
var error: NSError?
guard context.canEvaluatePolicy(.deviceOwnerAuthentication, error: &error) else {
message = "На устройстве не настроена аутентификация"
return
}
do {
isUnlocked = try await context.evaluatePolicy(
.deviceOwnerAuthentication,
localizedReason: "Открыть сохранённые места"
)
} catch {
message = "Не удалось открыть места"
}
}
}Политика deviceOwnerAuthentication допускает системный код-пароль. Ошибка или отмена оставляют экран закрытым. Этот экран не шифрует данные в памяти; completeFileProtection относится к файлу на заблокированном устройстве. Загрузку nearby places через сеть добавляй отдельным упражнением после карты и persistence.
Самостоятельное изменение
Испытание
Задание
Добавь удаление выбранного места из формы редактирования.Что уже нужно знать
Используй состояние и функции, которые уже собрал в этом проекте.Показать подсказку 1
Показать подсказку 2
Показать решение
// Closure, передаваемая родителем в редактор:
locations.removeAll { $0.id == location.id }
save()
// После вызова onDelete редактор выполняет dismiss().Reference: полный код проекта
Основной маршрут, без самостоятельного challenge. Используй этот блок для сверки уже собранного приложения.
Открыть все итоговые файлы проекта
ContentView.swift
import SwiftUI
import MapKit
struct ContentView: View {
@State private var locations = [Location(name: "Эрмитаж", latitude: 59.9398, longitude: 30.3146)]
@State private var selection: Location?
private let saveURL = URL.documentsDirectory.appending(path: "locations.json")
@State private var errorMessage: String?
@State private var canSave = true
private func load() {
guard FileManager.default.fileExists(atPath: saveURL.path) else { return }
do { locations = try JSONDecoder().decode([Location].self, from: Data(contentsOf: saveURL)) }
catch { canSave = false; errorMessage = "Не удалось прочитать места: \(error.localizedDescription)" }
}
private func save() {
guard canSave else { errorMessage = "Сначала восстанови повреждённый файл мест"; return }
do {
try JSONEncoder().encode(locations).write(to: saveURL, options: [.atomic, .completeFileProtection])
} catch { errorMessage = "Не удалось сохранить: \(error.localizedDescription)" }
}
var body: some View {
MapReader { proxy in
Map {
ForEach(locations) { location in
Annotation(location.name, coordinate: location.coordinate) {
Button { selection = location } label: {
Image(systemName: "star.circle.fill").font(.title)
}
.accessibilityLabel("Изменить \(location.name)")
}
}
}
.task { load() }
.alert("Ошибка данных", isPresented: Binding(
get: { errorMessage != nil }, set: { if !$0 { errorMessage = nil } }
)) { Button("OK") { errorMessage = nil } }
message: { Text(errorMessage ?? "") }
.sheet(item: $selection) { location in
EditLocationView(location: location) { updated in
guard let index = locations.firstIndex(where: { $0.id == updated.id }) else { return }
locations[index] = updated
save()
}
}
.onTapGesture { position in
guard let coordinate = proxy.convert(position, from: .local) else { return }
locations.append(Location(name: "Новое место", latitude: coordinate.latitude, longitude: coordinate.longitude))
save()
}
}
}
}BucketListApp.swift
import SwiftUI
@main
struct BucketListApp: App {
var body: some Scene {
WindowGroup { ContentView() }
}
}Location.swift
import Foundation
import MapKit
struct Location: Identifiable, Codable, Equatable {
var id = UUID()
var name: String
var description = ""
let latitude: Double
let longitude: Double
var coordinate: CLLocationCoordinate2D { .init(latitude: latitude, longitude: longitude) }
}EditLocationView.swift
import SwiftUI
struct EditLocationView: View {
@Environment(\.dismiss) private var dismiss
@State var location: Location
let onSave: (Location) -> Void
var body: some View {
NavigationStack {
Form {
TextField("Название", text: $location.name)
TextField("Описание", text: $location.description)
}
.toolbar {
Button("Отмена") { dismiss() }
Button("Сохранить") { onSave(location); dismiss() }
.disabled(location.name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty)
}
}
}
}Что ты сейчас использовал
Swift Знакомые основы
SwiftUI Новое в проекте
- + Codable
- + MapKit
- + Biometrics
- + FileManager
Дальше проверим, доступен ли интерфейс разным пользователям: Accessibility →.