rzaripov.kz

Реализация поиска с автодополнением в Swift для iOS

Автодополнение в Swift для iOS кажется простой функцией, но качественная реализация требует согласованной работы источника данных, сетевого слоя и интерфейса. Пользователь вводит запрос, ожидает быстрый ответ и не должен видеть устаревшие подсказки после изменения текста.

Рассмотрим практический путь от моделирования поискового запроса до готового элемента управления. Основное внимание уделяется асинхронным вызовам, отмене лишней работы и состояниям, которые часто упускают при быстрой разработке.

Подход охватывает локальные индексы, базы данных и удалённые API. Отдельные решения показаны для UIKit и SwiftUI, поскольку оба фреймворка позволяют создавать одинаково отзывчивый поиск, но по-разному организуют жизненный цикл запросов.

Я Равиль Зарипов, разработчик из Алматы. Моя практика охватывает приложения для Android, iOS, Windows, macOS и Linux, а также серверные компоненты и базы данных. Этот опыт помогает выбирать архитектуру, которая остаётся удобной за пределами одного экрана.

Архитектура источника подсказок

Поиск стоит разделить на независимые части: источник данных, сервис подсказок и представление. Единый контракт suggestions(for:) отделяет пользовательский интерфейс от способа получения результатов. Вместе с ним удобно задавать ограничение количества элементов и понятные ошибки.

Для небольшого локального каталога подходит массив, отсортированный по имени или релевантности. Более крупные наборы данных требуют индексации: SQLite с FTS5 или серверная полнотекстовая индексация. При удалённом поиске API должен принимать нормализованную строку и возвращать только необходимые поля.

Нормализация включает удаление лишних пробелов, приведение регистра и учёт особенностей локализации. В запросе не следует передавать необработанный пользовательский ввод: для базы данных безопаснее использовать параметризованные запросы, а для сетевого слоя — корректное URL-кодирование.

Задержка ввода и отмена запросов

Каждое изменение текста порождает потенциальный запрос, но выполнять все обращения к источнику нельзя. Задержка в 250–350 миллисекунд объединяет короткие последовательности нажатий и снижает нагрузку на сеть. Точное значение подбирается по типу данных и целевой скорости ответа.

В Swift отмена реализуется через Task. Перед запуском новой задачи предыдущую отменяют, а результат проверяют на актуальность после await. Это особенно важно, если удалённый сервер отвечает медленно: первый запрос может завершиться позже второго и вернуть неправильные подсказки.

Кэширование сокращает повторные обращения к одним и тем же префиксам. Размер кэша следует ограничивать, а срок жизни записей выбирать с учётом частоты обновления данных. Для сетевых вызовов отмена должна распространяться на URLSession, иначе сервер продолжит бесполезную работу.

Интеграция UISearchController в UIKit

UISearchController предоставляет готовую строку поиска, системную клавиатуру и стандартное поведение present-представлений. Для получения подсказок контроллер назначается в качестве searchResultsUpdater. Этот回调 вызывается при каждом изменении текста.

Ключевая часть контроллера выглядит следующим образом:

protocol SearchProviding: Sendable {
    func suggestions(for query: String) async throws -> [String]
}

@MainActor
final class SearchViewController: UIViewController, UISearchResultsUpdating {
    private let provider: SearchProviding
    private var searchTask: Task<Void, Never>?

    func updateSearchResults(for searchController: UISearchController) {
        let query = searchController.searchBar.text ?? ""
        searchTask?.cancel()

        searchTask = Task { [weak self] in
            guard let self else { return }

            do {
                try await Task.sleep(nanoseconds: 300_000_000)
                let items = try await provider.suggestions(for: query)
                guard !Task.isCancelled else { return }
                showSuggestions(items)
            } catch is CancellationError {
            } catch {
                showError(error)
            }
        }
    }
}

Перед запуском задачи запрос очищается от пробелов, а короткие строки отбрасываются. Полученные значения передаются в источник данных таблицы или другого выбранного представления. Выбор подсказки устанавливает текст поля и запускает переход к результату.

Обновление элементов интерфейса выполняется в главном акторе. Тяжёлый парсинг и операции с базой лучше оставлять вне главного потока, чтобы прокрутка и ввод оставались плавными.

Поиск на SwiftUI

SwiftUI предоставляет модификаторы searchable и searchSuggestions. Первый создаёт поле поиска, второй связывает его с массивом подсказок. Для загрузки результатов удобно использовать task(id:): при изменении запроса предыдущая задача автоматически отменяется.

.task(id: query) {
    guard query.count >= 2 else {
        suggestions = []
        return
    }

    do {
        try await Task.sleep(nanoseconds: 300_000_000)
        let items = try await service.suggestions(for: query)
        guard !Task.isCancelled else { return }
        suggestions = items
    } catch {
        suggestions = []
    }
}

Сервис подсказок остаётся общим для UIKit и SwiftUI. Благодаря этому правила нормализации, задержки и обработки ошибок не дублируются. Если проект использует Combine, существующие потоки можно преобразовать в асинхронные вызовы, но новая логика всё равно должна учитывать отмену.

Состояния интерфейса и обработка ошибок

Поисковый экран должен явно показывать начальное состояние, загрузку, отсутствие результатов и ошибку. Спиннер появляется после задержки, чтобы короткий запрос не вызывал заметное мерцание. Если подходящих подсказок нет, полезно предложить изменить формулировку.

Ошибки сети и данные из локального кэша требуют разных реакций. При потере соединения можно показать недавние результаты с пометкой об устаревании. Ошибка разбора ответа не должна превращаться в длинное техническое сообщение для пользователя, но её полезно зафиксировать в диагностике.

Логи автодополнения не должны содержать чувствительные запросы без необходимости. Особенно это касается аналитики и журналов сервера. Интерфейс также необходимо проверить с VoiceOver, увеличенным размером текста и локализованной клавиатурой.

Тестирование и производительность

Модульные тесты используют подставной сервис, который имитирует разные задержки и ошибки. Проверяются пустой запрос, минимальная длина ввода, отмена задачи и защита от устаревшего ответа. Отдельно тестируются нормализация и порядок подсказок.

Интерфейсные тесты вводят текст, выбирают результат и проверяют переход к найденному объекту. Сценарий unavailable-сети подтверждает появление кэшированных данных. Инструменты Instruments помогают измерить задержки, allocations и влияние обновлений на главный поток.

Для сравнения вариантов можно ориентироваться на следующие характеристики:

Критерий UISearchController SwiftUI Собственная реализация
Тип проекта Существующий UIKit-проект SwiftUI-проект Особые требования
Задержка ввода Debounce и отмена задачи Задача с идентификатором Полный контроль
Состояния Делегирование UIKit Делегирование SwiftUI Ручная реализация
Гибкость Высокая Высокая Максимальная
Сложность Низкая Низкая Высокая

Собственная реализация оправдана при нестандартной визуализации, сложной фильтрации или необходимости объединить поиск с другими элементами управления. Для большинства приложений системный компонент сокращает объём кода и сохраняет привычное поведение.

Опыт, проекты и ресурсы

Мобильная разработка для меня остаётся частью более широкой практики. В портфолио представлены проекты на Delphi, FireMonkey, Kotlin, Swift и PHP, а также решения с использованием баз данных. Общие для них принципы — разделение ответственности, тестируемые контракты и контролируемая работа с ресурсами.

Материалы блога и GitHub дополняют портфолино примерами реализации и практическими заметками. Они позволяют увидеть не только отдельный экран, но и архитектурные решения, которые можно перенести в другой проект или стек.

Дополнительным ориентиром для читателей служит страница MihneaDB. Рядом с мобильным поиском она показывает, что качество пользовательского сценария зависит не только от интерфейса, но и от выбранной модели данных.

Надёжное автодополнение получается при сочетании задержки ввода, отменяемых задач, актуальных ответов и понятных состояний. Такой сценарий одинаково хорошо работает в UIKit и SwiftUI, сохраняя бизнес-логику в независимом сервисе.