Как отправить уведомление пользователю, что файл скачался

Отправка уведомления о завершении загрузки файла в Android

В Android уведомления являются стандартным механизмом для информирования пользователя о событиях, происходящих в фоновом режиме, таких как завершение загрузки файла. Для этого используется Notification API, частью которого является класс NotificationManager. Процесс состоит из создания уведомления, его конфигурации и отправки через систему.

Основные шаги реализации

1. Создание канала уведомлений (для Android 8.0+)

Начиная с Android 8.0 (API level 26), все уведомления должны быть связаны с NotificationChannel. Канал определяет поведение и визуальное представление группы уведомлений.

fun createDownloadNotificationChannel(context: Context) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channelName = "Загрузки файлов"
        val channelDescription = "Уведомления о завершении загрузки файлов"
        val importance = NotificationManager.IMPORTANCE_LOW
        val channel = NotificationChannel("download_channel", channelName, importance)
        channel.description = channelDescription
        
        val notificationManager = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

2. Строительство уведомления

Уведомление строится с помощью NotificationCompat.Builder, который обеспечивает обратную совместимость с предыдущими версиями Android.

fun buildDownloadNotification(context: Context, fileName: String, filePath: String): Notification {
    val intent = Intent(Intent.ACTION_VIEW)
    intent.setDataAndType(Uri.fromFile(File(filePath)), "application/*")
    intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
    
    val pendingIntent = PendingIntent.getActivity(
        context,
        0,
        intent,
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
    )
    
    return NotificationCompat.Builder(context, "download_channel")
        .setSmallIcon(android.R.drawable.stat_sys_download_done)
        .setContentTitle("Загрузка завершена")
        .setContentText("Файл $fileName успешно скачан")
        .setContentIntent(pendingIntent)
        .setAutoCancel(true)
        .setPriority(NotificationCompat.PRIORITY_LOW)
        .build()
}

3. Отправка уведомления

После создания уведомления оно отправляется через NotificationManager.

fun showDownloadNotification(context: Context, fileName: String, filePath: String) {
    val notificationManager = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
    val notification = buildDownloadNotification(context, fileName, filePath)
    notificationManager.notify(fileName.hashCode(), notification)
}

Ключевые аспекты реализации

• Идентификатор уведомления: В методе notify() используется уникальный ID (например, хэш имени файла), чтобы разные загрузки создавали отдельные уведомления.
• PendingIntent: Позволяет пользователю открыть скачанный файл при клике на уведомление. Используется Intent.ACTION_VIEW с MIME-типом.
• Флаги уведомления: setAutoCancel(true) автоматически закрывает уведомление при клике; FLAG_IMMUTABLE необходим для безопасности на Android 12+.
• Обработка версий Android: Для API < 26 канал не создается, но NotificationCompat.Builder требует указания канала в любом случае (он будет игнорироваться на старых устройствах).

Расширенные возможности

Для более сложных сценариев можно:

• Добавить прогресс-индикатор во время загрузки с помощью setProgress(max, progress, false).
• Использовать большой стиль уведомления (BigTextStyle) для длинных описаний.
• Добавить действия (Action buttons) для быстрого открытия файла или его удаления.
• Реализовать группировку уведомлений (для нескольких загрузок) через setGroup().

Пример интеграции в загрузчик

class DownloadService : IntentService("DownloadService") {
    override fun onHandleIntent(intent: Intent?) {
        val fileName = intent?.getStringExtra("file_name") ?: "file"
        val url = intent?.getStringExtra("url") ?: return
        
        // Создаем канал (лучше делать заранее в Application)
        createDownloadNotificationChannel(this)
        
        // Выполняем загрузку (код упрощен)
        val filePath = "/storage/emulated/0/Downloads/$fileName"
        // ... код загрузки файла ...
        
        // Показываем уведомление о завершении
        showDownloadNotification(this, fileName, filePath)
    }
}

Уведомления о загрузке файлов — это важный элемент пользовательского опыта, который позволяет системе оставаться в фоне, но информировать пользователя о результатах работы. Использование стандартных API гарантирует корректное поведение на всех версиях Android и соблюдение лучших практик.