Реалізація експорту даних (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 дні. Вартість рассчитывается після аналізу структури даних.