Реализация экспорта данных (CSV, Excel) из мобильного приложения

Реализация экспорта данных (CSV, Excel) из мобильного приложения

Пользователь нажимает «Экспортировать» — и ждёт. Если у него 5000 строк в локальной SQLite или Room-базе, а экспорт происходит на main thread, приложение замирает секунды на три, а на старых устройствах ANR (Application Not Responding) не заставит себя ждать. Это первая и самая частая ошибка при реализации экспорта.

Что на практике ломается чаще всего

Блокировка UI при генерации файла. Сериализация 10 000 строк в CSV — это не «мгновенная операция». На Android нужен CoroutineScope(Dispatchers.IO), на iOS — DispatchQueue.global(qos: .userInitiated). Генерацию файла всегда выносим в фоновый поток, результат возвращаем через callback или Flow.

Кодировка и разделитель. CSV — это ловушка. Excel в Windows по умолчанию ожидает кодировку Windows-1252 и разделитель ;, а не ,. Если отдать UTF-8 без BOM — кириллица превратится в кракозябры прямо в офисе клиента. Правильный CSV для Excel: UTF-8 с BOM (\uFEFF в начале файла) и разделитель ;. Либо сразу экспортировать .xlsx через библиотеку.

Экспорт в Excel (.xlsx). На Android используем Apache POI или более лёгкий FastExcel. На iOS — xlsxwriter через Swift Package или собственный XML-генератор (.xlsx — это ZIP с XML-файлами внутри). Для React Native есть react-native-xlsx поверх js-библиотеки xlsx.

Как строим экспорт

Схема простая: читаем данные из локальной БД → трансформируем в модель строк → пишем в файл → делимся через системный ShareSheet / Intent.ACTION_SEND.

На Android с Room это выглядит так:

viewModelScope.launch(Dispatchers.IO) {
    val rows = database.transactionDao().getAll()
    val file = CsvExporter.export(rows, context.cacheDir)
    withContext(Dispatchers.Main) {
        shareFile(file, "text/csv")
    }
}

На iOS аналогично через Task.detached:

Task.detached(priority: .userInitiated) {
    let rows = await store.fetchAll()
    let url = try CsvExporter.write(rows, to: .cachesDirectory)
    await MainActor.run { presentShareSheet(url) }
}

Для .xlsx на iOS генерируем XML-структуру вручную или через CoreXLSX / xlsxwriter. Для простых таблиц — XML-подход быстрее и без зависимостей.

Прогресс при большом объёме

Если строк больше 50 000 — показываем ProgressView с реальным процентом. На Android через StateFlow<Int> в ViewModel, на iOS через @Published var progress: Double. Пишем файл батчами по 1000 строк, обновляем счётчик после каждого батча.

Формат файла и Share

После генерации файл кладём в cacheDir (Android) или FileManager.default.temporaryDirectory (iOS). Делимся через:

• Android: FileProvider + Intent.ACTION_SEND с правильным MIME-типом (text/csv или application/vnd.openxmlformats-officedocument.spreadsheetml.sheet)
• iOS: UIActivityViewController с [fileURL]

Не сохраняем в Downloads без явного запроса пользователя — это нарушает гайдлайны обеих платформ.

Что входит в работу

• Выбор формата (CSV / XLSX) и согласование структуры колонок
• Фоновая генерация файла без блокировки UI
• Корректная кодировка и локализация разделителей
• Прогресс-индикатор для больших выгрузок
• Шаринг через системный ShareSheet / Intent
• Тесты на реальных объёмах данных

Сроки

Простой CSV-экспорт из готовой базы данных: 0,5–1 день. С выбором формата (CSV/XLSX), фильтрами по диапазону дат и прогрессом: 1,5–2 дня. Стоимость рассчитывается после анализа структуры данных.