Сталкивались с ситуацией: ожидаете структурированный CSV, а получаете файл, где колонки переименованы, добавлен заголовок «Мои данные», кодировка Windows-1251 и разделитель — запятая, хотя раньше была точка с запятой. Мы, команда с 7-летним опытом мобильной разработки, реализовали импорт для более 50 проектов — от банковских приложений до ритейл-решений. Наша задача — чтобы любой файл загрузился без крашей и с понятными отчётами об ошибках. Экономия бюджета на ручном вводе достигает 30–40% от затрат на персонал. Свяжитесь с нами для оценки вашего проекта.
Разбор входящего файла — самое непредсказуемое
Определение кодировки. CSV приходит в UTF-8, UTF-8 с BOM, Windows-1251, CP866. Универсальное решение — библиотека определения кодировки: на Android juniversalchardet, на iOS — собственный анализ BOM + fallback на String.Encoding.windowsCP1251. Если кодировка не определена правильно — Клиент вместо «Клиент». Univocity-parsers на Android — один из лучших вариантов для работы с CSV.
Определение разделителя. Парсер должен пробовать ,, ;, \t и выбирать тот, что даёт наибольшее количество однородных колонок. Либо дать пользователю выбрать вручную — честнее и надёжнее.
Пустые строки, дубли заголовков, смешанные типы. Реальные пользовательские файлы содержат пустые строки между блоками, объединённые ячейки в Excel, числа в колонке «дата». Каждый из этих случаев нужно обрабатывать явно, а не падать с ArrayIndexOutOfBoundsException.
Как автоматически определить кодировку CSV?
На Android используем juniversalchardet или ICU4C. На iOS — проверяем BOM, затем пробуем наиболее вероятные кодировки: UTF-8, Windows-1251, CP866. Если ни одна не подходит, предлагаем пользователю выбрать вручную. Это покрывает 99% случаев.
Почему важна транзакционная запись?
Импорт без транзакции — риск получить частично загруженные данные при сбое. Транзакционная запись гарантирует, что либо все строки будут записаны, либо ни одна. На Android Room реализует это через @Transaction, на iOS Core Data — через performAndWait. Как указано в документации Room, это стандартная практика.
Архитектура импорта
Реализация импорта по шагам
Выбор файла через DocumentPicker (Android) или UIDocumentPickerViewController (iOS).
// Android — DocumentPicker val launcher = registerForActivityResult( ActivityResultContracts.GetContent() ) { uri -> uri?.let { viewModel.importFile(it) } } launcher.launch("text/csv,application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet") // iOS — UIDocumentPickerViewController let picker = UIDocumentPickerViewController(forOpeningContentTypes: [.commaSeparatedText, .spreadsheet]) picker.delegate = self present(picker, animated: true) Парсинг. На Android для CSV — opencsv или univocity-parsers (последний быстрее на больших файлах и корректно обрабатывает экранирование кавычек). Для .xlsx — Apache POI XSSFWorkbook. На iOS для CSV — собственный парсер через Scanner или CSVParser из SwiftCSV. Для .xlsx — CoreXLSX.
// Android, univocity-parsers val settings = CsvParserSettings().apply { isHeaderExtractionEnabled = true format.delimiter = ';' } val parser = CsvParser(settings) val rows: List<Record> = parser.parseAllRecords(inputStream.reader(Charsets.UTF_8)) Валидация и маппинг. Перед записью в базу — валидация каждой строки. Не «упасть на первой ошибке», а собрать все невалидные строки и показать сводку: «Импортировано 847 из 900 строк. 53 строки пропущены — некорректный формат даты в колонке D». Пользователь должен понять, что пошло не так, и исправить файл.
data class ImportResult( val imported: Int, val skipped: List<SkippedRow> ) data class SkippedRow(val line: Int, val reason: String) Запись в базу данных. Транзакция целиком — либо всё, либо ничего. На Room:
@Transaction suspend fun importRows(rows: List<TransactionEntity>) { database.clearAll() database.insertAll(rows) } Для инкрементального импорта (добавить новые, обновить существующие) — INSERT OR REPLACE с уникальным полем-идентификатором.
Сравнение форматов файлов
| Формат | Android парсер | iOS парсер | Особенности |
|---|---|---|---|
| CSV | opencsv / univocity-parsers | SwiftCSV / Scanner | Автоопределение кодировки и разделителя |
| XLS | Apache POI HSSFWorkbook | — | Устаревший формат, редко используется |
| XLSX | Apache POI XSSFWorkbook | CoreXLSX | Поддержка макросов, большие объёмы |
Типичные ошибки и их решения
| Проблема | Решение |
|---|---|
| Парсинг на main thread | Выполнять на фоновом потоке (CoroutineScope, DispatchQueue) |
| Не экранированные кавычки в CSV | Использовать парсер с обработкой экранирования (univocity, CoreXLSX) |
| Неоднозначный формат даты | Детектить по регулярным выражениям или дать выбор пользователю |
UI-паттерны
Прогресс-бар с текущей строкой (Обработано 3 412 из 10 000), отмена через Job.cancel() на Android / Task cancellation на iOS. После импорта — экран с итогами: сколько добавлено, сколько обновлено, сколько пропущено с причинами.
Предпросмотр первых 5–10 строк перед подтверждением импорта — хорошая UX-практика, которая снижает количество «я не то загрузил».
Что входит в работу под ключ
- Выбор файла через DocumentPicker (CSV, XLS, XLSX)
- Автоопределение кодировки и разделителя
- Валидация с отчётом об ошибках по строкам
- Транзакционная запись в локальную БД
- UI прогресса и предпросмотра
- Поддержка отмены импорта
Сроки
Базовый CSV-импорт с фиксированной структурой: 1–1,5 дня. С автоопределением формата, валидацией, предпросмотром и отчётом об ошибках: 3–4 дня. Стоимость разработки варьируется в зависимости от сложности, но в среднем окупается за 2–3 месяца. Закажите реализацию импорта — получите стабильный модуль за 3–4 дня. Получите консультацию по вашему проекту.