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

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

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

Наши инженеры с семилетним опытом в мобильной разработке выполнили более 50 проектов с экспортом данных. Каждый проект проходил через тестирование на реальных данных с объёмом до 500 000 строк. Свяжитесь с нами — разберём вашу архитектуру за 30 минут.

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

Блокировка 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 без явного запроса пользователя — это нарушает гайдлайны обеих платформ.

Почему экспорт на фоновом потоке критичен?

Любая работа с I/O и сериализацией должна быть вынесена из главного потока. На практике это сокращает время отклика приложения в 5–10 раз для выгрузок от 10 000 строк. Наши инженеры проверяют это на каждом проекте.

Как корректно отображать кириллицу в CSV для Excel?

Используйте UTF-8 с BOM и точку с запятой в качестве разделителя. Альтернатива — экспорт в .xlsx, где кодировка не вызывает проблем. У нас есть опыт адаптации экспорта для локальных рынков, включая кириллицу и азиатские символы.

Пошаговая инструкция по реализации экспорта

1. Выбор формата (CSV или XLSX) и согласование структуры колонок.
2. Чтение данных из БД в фоновом потоке.
3. Генерация файла с корректной кодировкой и разделителями.
4. Отображение прогресса при больших объёмах.
5. Шаринг через системный диалог.

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

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

Сроки

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