feat: implement custom Coil image loader with retry interceptor and enhance UI with robust image loading states
This commit is contained in:
@@ -6,6 +6,7 @@
|
||||
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
|
||||
|
||||
<application
|
||||
android:name=".MainApplication"
|
||||
android:allowBackup="true"
|
||||
android:dataExtractionRules="@xml/data_extraction_rules"
|
||||
android:fullBackupContent="@xml/backup_rules"
|
||||
|
||||
112
app/src/main/java/com/example/MainApplication.kt
Normal file
112
app/src/main/java/com/example/MainApplication.kt
Normal 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)
|
||||
}
|
||||
}
|
||||
@@ -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
|
||||
fun FullscreenPhotoViewerDialog(
|
||||
photoPath: String,
|
||||
@@ -1215,14 +1227,41 @@ fun FullscreenPhotoViewerDialog(
|
||||
}
|
||||
|
||||
// Image display
|
||||
coil.compose.AsyncImage(
|
||||
model = photoPath,
|
||||
val resolvedModel = remember(photoPath) { resolvePhotoModel(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",
|
||||
modifier = Modifier
|
||||
.fillMaxWidth()
|
||||
.fillMaxHeight(0.82f)
|
||||
.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))
|
||||
) {
|
||||
Box(modifier = Modifier.fillMaxSize()) {
|
||||
coil.compose.AsyncImage(
|
||||
model = photoPath,
|
||||
val resolvedModel = remember(photoPath) { resolvePhotoModel(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",
|
||||
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) {
|
||||
// Badge NOVA
|
||||
|
||||
@@ -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.
|
||||
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.
|
||||
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:
|
||||
* **`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.
|
||||
### Arquivos responsáveis pela conexão, sincronização e exibição de fotos:
|
||||
* **`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.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.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.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user