Реализация загрузки файлов (Upload) в мобильном приложении
Загрузка файла с мобильного устройства выглядит как простая задача до первого краша на Android 10+ из-за изменения URI в FileProvider, или до первого rejected review в App Store из-за неправильного запроса разрешений на медиатеку. Разбираем, что важно сделать правильно.
Типичные проблемы при реализации
На Android основная боль — работа с content:// URI вместо прямых путей к файлу. Начиная с Android 10 (API 29) прямой доступ к файловой системе ограничен, и попытки передать file:// путь напрямую в Retrofit/OkHttp приводят к FileUriExposedException. Правильный подход — читать файл через ContentResolver.openInputStream() и передавать поток, а не путь.
На iOS доступ к фотобиблиотеке требует корректного Info.plist: NSPhotoLibraryUsageDescription для iOS 13 и ниже, PHPickerViewController для iOS 14+ (не требует разрешений на весь фотоальбом). Использование устаревшего UIImagePickerController с .photoLibrary в 2024 году — прямая дорога к замечанию от ревьюера Apple.
Реализация
Multipart upload через Retrofit на Android:
@Multipart
@POST("upload")
suspend fun uploadFile(
@Part file: MultipartBody.Part,
@Part("description") description: RequestBody
): Response<UploadResponse>
// вызов:
val requestBody = file.asRequestBody("image/*".toMediaTypeOrNull())
val part = MultipartBody.Part.createFormData("file", file.name, requestBody)
Для больших файлов (видео, архивы) — потоковая передача через RequestBody с переопределённым writeTo, чтобы не грузить весь файл в память.
На iOS используем URLSession.uploadTask(with:from:) или Alamofire:
AF.upload(
multipartFormData: { form in
form.append(fileURL, withName: "file")
},
to: "https://api.example.com/upload"
).uploadProgress { progress in
print(progress.fractionCompleted)
}.responseDecodable(of: UploadResponse.self) { response in
// handle
}
Flutter: пакет dio с FormData и MultipartFile.fromFile(). Прогресс через onSendProgress.
Важно отдельно обработать прогресс загрузки — пользователь должен видеть ProgressBar/LinearProgressIndicator с реальными процентами, а не спиннер. Отмена загрузки реализуется через CancellationToken (Kotlin) или Task (Swift/Alamofire).
Что входит в работу
Выбор подхода (multipart, presigned S3 URL, chunked upload) зависит от размера файлов и инфраструктуры. Реализуем пикер файлов под платформу, обработку разрешений, отображение прогресса, повтор при ошибке сети.
Срок: 1–2 дня для стандартного случая, до 4 дней если нужен chunked upload с resumable поведением.