feat: implement custom Coil image loader with retry interceptor and enhance UI with robust image loading states

This commit is contained in:
Jhony Cesar
2026-08-06 08:07:07 -04:00
parent 554a34f8b1
commit ec48078f1a
4 changed files with 191 additions and 10 deletions

View File

@@ -6,6 +6,7 @@
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<application <application
android:name=".MainApplication"
android:allowBackup="true" android:allowBackup="true"
android:dataExtractionRules="@xml/data_extraction_rules" android:dataExtractionRules="@xml/data_extraction_rules"
android:fullBackupContent="@xml/backup_rules" android:fullBackupContent="@xml/backup_rules"

View File

@@ -0,0 +1,112 @@
package com.example
import android.app.Application
import coil.ImageLoader
import coil.ImageLoaderFactory
import coil.disk.DiskCache
import coil.memory.MemoryCache
import coil.request.CachePolicy
import com.example.util.AppLogger
import okhttp3.Interceptor
import okhttp3.OkHttpClient
import okhttp3.Response
import java.io.IOException
import java.util.Random
class MainApplication : Application(), ImageLoaderFactory {
override fun onCreate() {
super.onCreate()
}
override fun newImageLoader(): ImageLoader {
val okHttpClient = OkHttpClient.Builder()
.retryOnConnectionFailure(true)
.addInterceptor(RetryInterceptor(applicationContext, maxRetries = 3))
.build()
return ImageLoader.Builder(this)
.okHttpClient(okHttpClient)
.memoryCache {
MemoryCache.Builder(this)
.maxSizePercent(0.25) // 25% da memória RAM disponível
.build()
}
.diskCache {
DiskCache.Builder()
.directory(cacheDir.resolve("image_cache"))
.maxSizeBytes(50 * 1024 * 1024) // 50 MB de cache em disco (~100 fotos de 500KB)
.build()
}
.diskCachePolicy(CachePolicy.ENABLED)
.memoryCachePolicy(CachePolicy.ENABLED)
.networkCachePolicy(CachePolicy.ENABLED)
.crossfade(true)
.build()
}
}
class RetryInterceptor(
private val context: android.content.Context,
private val maxRetries: Int = 3
) : Interceptor {
private val random = Random()
private val appLogger by lazy { AppLogger.getInstance(context) }
override fun intercept(chain: Interceptor.Chain): Response {
val request = chain.request()
val urlStr = request.url.toString()
var response: Response? = null
var lastException: Exception? = null
for (attempt in 1..maxRetries) {
try {
response?.close()
response = chain.proceed(request)
if (response.isSuccessful) {
return response
} else if (response.code in 500..599 && attempt < maxRetries) {
response.close()
val delayMs = 300L + random.nextInt(700) // Intervalo aleatório de 300ms a 1000ms
appLogger.logWarning(
"ImageDownload",
"Tentativa $attempt de $maxRetries falhou para $urlStr (HTTP ${response.code}). Aguardando ${delayMs}ms para tentar novamente..."
)
Thread.sleep(delayMs)
} else {
if (!response.isSuccessful) {
appLogger.logWarning(
"ImageDownload",
"Download de imagem retornou HTTP ${response.code} para $urlStr após $attempt tentativa(s)."
)
}
return response
}
} catch (e: IOException) {
lastException = e
if (attempt < maxRetries) {
val delayMs = 300L + random.nextInt(700)
appLogger.logWarning(
"ImageDownload",
"Falha de rede na tentativa $attempt de $maxRetries para $urlStr: ${e.message}. Tentando em ${delayMs}ms..."
)
try {
Thread.sleep(delayMs)
} catch (ie: InterruptedException) {
Thread.currentThread().interrupt()
throw e
}
}
}
}
if (response != null) {
return response
}
val errorMsg = "Falha no download da foto após $maxRetries tentativas: ${lastException?.message ?: "Erro de rede"}. URL: $urlStr"
appLogger.logError("ImageDownload", errorMsg, lastException)
throw lastException ?: IOException(errorMsg)
}
}

View File

@@ -1115,6 +1115,18 @@ fun OSListItemCard(
} }
} }
fun resolvePhotoModel(path: String): String {
val trimmed = path.trim()
if (trimmed.startsWith("http://") || trimmed.startsWith("https://") || trimmed.startsWith("/")) {
return trimmed
}
if (trimmed.startsWith("photos/")) {
val encoded = android.net.Uri.encode(trimmed)
return "https://firebasestorage.googleapis.com/v0/b/cargill-parada-os.appspot.com/o/$encoded?alt=media"
}
return trimmed
}
@Composable @Composable
fun FullscreenPhotoViewerDialog( fun FullscreenPhotoViewerDialog(
photoPath: String, photoPath: String,
@@ -1215,14 +1227,41 @@ fun FullscreenPhotoViewerDialog(
} }
// Image display // Image display
coil.compose.AsyncImage( val resolvedModel = remember(photoPath) { resolvePhotoModel(photoPath) }
model = photoPath, var retryKey by remember { mutableStateOf(0) }
coil.compose.SubcomposeAsyncImage(
model = coil.request.ImageRequest.Builder(context)
.data(resolvedModel)
.setParameter("retry_key", retryKey)
.crossfade(true)
.diskCachePolicy(coil.request.CachePolicy.ENABLED)
.memoryCachePolicy(coil.request.CachePolicy.ENABLED)
.build(),
contentDescription = "Visualização em Tela Cheia", contentDescription = "Visualização em Tela Cheia",
modifier = Modifier modifier = Modifier
.fillMaxWidth() .fillMaxWidth()
.fillMaxHeight(0.82f) .fillMaxHeight(0.82f)
.padding(16.dp), .padding(16.dp),
contentScale = androidx.compose.ui.layout.ContentScale.Fit contentScale = androidx.compose.ui.layout.ContentScale.Fit,
loading = {
Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
CircularProgressIndicator(color = Color.White, modifier = Modifier.size(36.dp), strokeWidth = 3.dp)
}
},
error = {
Box(
modifier = Modifier
.fillMaxSize()
.clickable { retryKey++ },
contentAlignment = Alignment.Center
) {
Column(horizontalAlignment = Alignment.CenterHorizontally) {
Icon(Icons.Default.Refresh, contentDescription = "Recarregar", tint = Color.White, modifier = Modifier.size(32.dp))
Spacer(modifier = Modifier.height(8.dp))
Text("Falha ao carregar imagem. Toque para tentar novamente.", color = Color.White, fontSize = 12.sp)
}
}
}
) )
} }
} }
@@ -1838,11 +1877,35 @@ fun EditActivityBottomSheet(
border = BorderStroke(2.dp, if (isNew) BrandGreen else Color(0xFFE0E0E0)) border = BorderStroke(2.dp, if (isNew) BrandGreen else Color(0xFFE0E0E0))
) { ) {
Box(modifier = Modifier.fillMaxSize()) { Box(modifier = Modifier.fillMaxSize()) {
coil.compose.AsyncImage( val resolvedModel = remember(photoPath) { resolvePhotoModel(photoPath) }
model = photoPath, var retryKey by remember { mutableStateOf(0) }
coil.compose.SubcomposeAsyncImage(
model = coil.request.ImageRequest.Builder(LocalContext.current)
.data(resolvedModel)
.setParameter("retry_key", retryKey)
.crossfade(true)
.diskCachePolicy(coil.request.CachePolicy.ENABLED)
.memoryCachePolicy(coil.request.CachePolicy.ENABLED)
.build(),
contentDescription = "Miniatura da foto", contentDescription = "Miniatura da foto",
modifier = Modifier.fillMaxSize(), modifier = Modifier.fillMaxSize(),
contentScale = androidx.compose.ui.layout.ContentScale.Crop contentScale = androidx.compose.ui.layout.ContentScale.Crop,
loading = {
Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
CircularProgressIndicator(color = BrandGreen, modifier = Modifier.size(18.dp), strokeWidth = 2.dp)
}
},
error = {
Box(
modifier = Modifier
.fillMaxSize()
.background(Color(0xFFF5F5F5))
.clickable { retryKey++ },
contentAlignment = Alignment.Center
) {
Icon(Icons.Default.Refresh, contentDescription = "Recarregar", tint = Color.Gray, modifier = Modifier.size(16.dp))
}
}
) )
if (isNew) { if (isNew) {
// Badge NOVA // Badge NOVA

View File

@@ -55,14 +55,19 @@ O armazenamento é realizado por meio do **Room Database**, que é uma camada de
1. **Captura, Suporte HEIC e Compactação Local (Offline-First):** As fotos capturadas pela Câmera ou selecionadas da Galeria (nos formatos JPEG, PNG ou HEIC/HEIF) são processadas pelo `ImageCompressor.kt`. O app decodifica a imagem, corrige a orientação EXIF, reduz a resolução para no máximo 1920x1920 px se necessário, e compacta iterativamente para garantir tamanho final **<= 500 KB**. O arquivo resultante é armazenado em `filesDir/os_photos/` e registrado no Room DB. 1. **Captura, Suporte HEIC e Compactação Local (Offline-First):** As fotos capturadas pela Câmera ou selecionadas da Galeria (nos formatos JPEG, PNG ou HEIC/HEIF) são processadas pelo `ImageCompressor.kt`. O app decodifica a imagem, corrige a orientação EXIF, reduz a resolução para no máximo 1920x1920 px se necessário, e compacta iterativamente para garantir tamanho final **<= 500 KB**. O arquivo resultante é armazenado em `filesDir/os_photos/` e registrado no Room DB.
2. **Upload Único para o Firebase Storage:** Durante a sincronização, o `MaintenanceRepository.kt` lê as fotos pendentes locais e aciona o `FirebaseStorageSyncService.kt`. Fotos que já possuem URL remota (`http://` ou `https://`) são ignoradas, garantindo que cada foto seja enviada apenas uma vez. As fotos pendentes são enviadas com trava de segurança de 500KB para a pasta `photos/OS_{numeroOs}/`. 2. **Upload Único para o Firebase Storage:** Durante a sincronização, o `MaintenanceRepository.kt` lê as fotos pendentes locais e aciona o `FirebaseStorageSyncService.kt`. Fotos que já possuem URL remota (`http://` ou `https://`) são ignoradas, garantindo que cada foto seja enviada apenas uma vez. As fotos pendentes são enviadas com trava de segurança de 500KB para a pasta `photos/OS_{numeroOs}/`.
3. **URL de Download e Sincronismo com Google Sheets:** O serviço obtém a `downloadUrl` do Firebase Storage, atualizando a Room DB. Ao reconciliar os históricos (`remoteHistory + localHistory`), o sistema prioriza as URLs remotas em relação a caminhos locais desatualizados, refletindo o link público na aba `history` do Google Sheets. 3. **URL de Download e Sincronismo com Google Sheets:** O serviço obtém a `downloadUrl` do Firebase Storage, atualizando a Room DB. Ao reconciliar os históricos (`remoteHistory + localHistory`), o sistema prioriza as URLs remotas em relação a caminhos locais desatualizados, refletindo o link público na aba `history` do Google Sheets.
4. **Soft Delete:** A exclusão de fotos no app executa um Soft Delete no Firebase Storage (renomeando a referência no mesmo diretório adicionando o sufixo `_DELETED`) e atualiza os registros locais. 4. **Download Inteligente com Re-tentativas Automáticas (Retry & Cache):** Para garantir a exibição de fotos em ambientes de campo com oscilações de rede, o aplicativo utiliza o Coil configurado via `MainApplication.kt` com um `RetryInterceptor` customizado no OkHttp. Caso um download falhe por instabilidade de rede ou erro temporário do servidor, o app executa **até 3 tentativas** com **intervalo aleatório (jitter)** de 300ms a 1000ms. Fotos baixadas com sucesso são gravadas em um cache em disco dedicado de **50 MB** (`cacheDir/image_cache`), permitindo visualização offline instantânea de até ~100 fotos de 500KB.
5. **Soft Delete e Consistência Local:** A exclusão de fotos executa um Soft Delete no Firebase Storage (adicionando o sufixo `_DELETED` ao arquivo) e atualiza incrementalmente os registros das tabelas `MaintenanceActivity`, `OSUpdateHistory` e `OSFinding` no Room DB local. A sincronização respeita a marcação `_DELETED` local, impedindo que fotos deletadas reapareçam.
6. **Registro de Falhas no Histórico de Logs (`AppLogger`):** Todas as falhas de sincronização, erros de envio no Firebase e falhas no download de fotos (após o limite de 3 re-tentativas) são automaticamente registradas pelo `AppLogger.kt` na tabela `AppLog` do Room DB e ficam acessíveis para consulta na aba **Histórico de Logs** da tela de **Configurações**.
7. **Controle de Acesso para Usuários Sem Login:** Usuários não autenticados via conta do Google têm acesso exclusivamente à visualização dos dados. Ações de edição de progresso, alteração de observações, inclusão/edição/exclusão de Achados e exclusão de fotos de campo são bloqueadas na UI e validadas no `MaintenanceViewModel.kt`.
### Arquivos responsáveis pela conexão e sincronização: ### Arquivos responsáveis pela conexão, sincronização e exibição de fotos:
* **`com.example.util.ImageCompressor`:** Utilitário responsável pelo decodecimento de HEIC/HEIF/JPEG/PNG, rotação EXIF e compactação garantida de imagens para até 500KB. * **`com.example.MainApplication`:** Configura o `ImageLoaderFactory` do Coil, interceptor OkHttp de retries automáticos com delay aleatório (300-1000ms), cache em memória (25% RAM) e cache em disco (50MB).
* **`com.example.util.AppLogger`:** Gerencia o registro persistente de logs de auditoria (WARN, ERROR, INFO) exibidos no painel da tela de Configurações.
* **`com.example.util.ImageCompressor`:** Utilitário responsável pelo decodificação de HEIC/HEIF/JPEG/PNG, rotação EXIF e compactação garantida de imagens para até 500KB.
* **`com.example.data.remote.FirebaseStorageSyncService`:** Gerencia upload seguro de fotos (com trava de 500KB) e soft delete no Firebase Storage. * **`com.example.data.remote.FirebaseStorageSyncService`:** Gerencia upload seguro de fotos (com trava de 500KB) e soft delete no Firebase Storage.
* **`com.example.data.remote.GoogleSheetsSyncService`:** Gerencia autenticação via Service Account e reconciliação bidirecional com a planilha central do Google Sheets. * **`com.example.data.remote.GoogleSheetsSyncService`:** Gerencia autenticação via Service Account e reconciliação bidirecional com a planilha central do Google Sheets.
* **`com.example.data.repository.MaintenanceRepository`:** Centraliza a orquestração do sync, upload de mídias pendentes sem reenvios duplicados, resolução de conflitos (LWW) e soft delete. * **`com.example.data.repository.MaintenanceRepository`:** Centraliza a orquestração do sync, upload de mídias pendentes sem reenvios duplicados, resolução de conflitos (LWW) e soft delete.
* **`com.example.ui.viewmodel.MaintenanceViewModel`:** Gerencia os estados de sync na UI, disparos assíncronos e callbacks de gerenciamento de fotos. * **`com.example.ui.viewmodel.MaintenanceViewModel`:** Gerencia os estados de sync na UI, disparos assíncronos, validação de permissões de acesso e callbacks de gerenciamento de fotos.
--- ---