// =========================================================================
// ex21/Ex21Activity.kt - um aplicativo em dois idiomas
// -------------------------------------------------------------------------
// O jeito Android:
// - os TEXTOS do aplicativo são RECURSOS: um arquivo
// res/values/strings.xml (o idioma padrão, aqui o inglês) e um
// arquivo por tradução (res/values-fr/strings.xml). Cada texto tem um
// nome; o código só conhece esse nome (R.string.ex21_hello), e o
// Android escolhe o arquivo de acordo com o idioma do aplicativo;
// - stringResource(R.string.ex21_hello, "Marie"): o texto, cujos
// parâmetros (%1$s) são substituídos; pluralStringResource: um texto
// no plural, cuja forma segue as regras do idioma;
// - o idioma do aplicativo: o do celular... ou o que o
// aplicativo escolhe por conta própria, AppCompatDelegate.setApplicationLocales.
// O Android então RECRIA a activity, no novo idioma: os textos,
// as datas, os valores monetários e os textos do próprio Android (o
// calendário, seus botões).
// O servidor RdvMedecins, por sua vez, só retorna CHAVES ("ERRORS.LOGIN_TAKEN"):
// elas são associadas aos recursos por uma tabela (serverKeys).
// A activity é uma AppCompatActivity: a classe de activity que pode
// aplicar o idioma escolhido, mesmo nas versões do Android anteriores
// à 13.
// =========================================================================
@file:OptIn(ExperimentalMaterial3Api::class, ExperimentalLayoutApi::class)
package fr.stahe.examples.ex21
import android.os.Bundle
import androidx.activity.compose.setContent
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.appcompat.app.AppCompatDelegate
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.ExperimentalLayoutApi
import androidx.compose.foundation.layout.FlowRow
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.width
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.DateRange
import androidx.compose.material3.Card
import androidx.compose.material3.DatePicker
import androidx.compose.material3.DatePickerDialog
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedButton
import androidx.compose.material3.SegmentedButton
import androidx.compose.material3.SegmentedButtonDefaults
import androidx.compose.material3.SingleChoiceSegmentedButtonRow
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.material3.rememberDatePickerState
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalConfiguration
import androidx.compose.ui.res.pluralStringResource
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.text.font.FontFamily
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import androidx.core.os.LocaleListCompat
import fr.stahe.examples.R
import fr.stahe.examples.common.ExamplePage
import fr.stahe.examples.common.ExamplesTheme
import java.text.NumberFormat
import java.time.LocalDate
import java.time.format.DateTimeFormatter
import java.time.format.FormatStyle
import java.util.Currency
val languages = listOf("fr", "en")
// o que o servidor RdvMedecins retornaria (cf. capítulo sobre a caixa-preta)
data class ServerResponse(val statusCode: Int, val key: String, val params: Map<String, String>)
val serverResponses = listOf(
ServerResponse(409, "ERRORS.LOGIN_TAKEN", emptyMap()),
ServerResponse(429, "ERRORS.TOO_MANY_ATTEMPTS", mapOf("minutes" to "15")),
)
// a chave do servidor -> o recurso que a traduz
val serverKeys = mapOf(
"ERRORS.LOGIN_TAKEN" to R.string.errors_login_taken,
"ERRORS.TOO_MANY_ATTEMPTS" to R.string.errors_too_many_attempts,
)
class Ex21Activity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
enableEdgeToEdge()
setContent { ExamplesTheme { TranslatedPage() } }
}
}
// escolhendo o idioma do aplicativo: o Android o armazena e recria a activity
fun changeLanguage(language: String) {
AppCompatDelegate.setApplicationLocales(LocaleListCompat.forLanguageTags(language))
}
@Composable
fun TranslatedPage() {
// rememberSaveable: a contagem sobrevive à recriação da activity
var count by rememberSaveable { mutableIntStateOf(2) }
var calendarOpen by rememberSaveable { mutableStateOf(false) }
// o idioma ATUAL: o da configuração da activity
val locale = LocalConfiguration.current.locales[0]
// formatadores no idioma atual
val date = LocalDate.now().format(DateTimeFormatter.ofLocalizedDate(FormatStyle.FULL).withLocale(locale))
val price = NumberFormat.getCurrencyInstance(locale).apply { currency = Currency.getInstance("EUR") }.format(1234.5)
ExamplePage(
title = stringResource(R.string.ex21_title),
// os idiomas: botões "segmentados", na barra superior
actions = {
SingleChoiceSegmentedButtonRow(Modifier.padding(end = 8.dp).width(120.dp)) {
languages.forEachIndexed { i, l ->
SegmentedButton(
selected = locale.language == l,
onClick = { changeLanguage(l) },
shape = SegmentedButtonDefaults.itemShape(i, languages.size),
icon = {},
) { Text(l.uppercase()) }
}
}
},
) {
Card(Modifier.fillMaxWidth()) {
Column(Modifier.padding(12.dp)) {
Text(stringResource(R.string.ex21_hello, "Marie"))
Text(stringResource(R.string.ex21_today, date))
Text(stringResource(R.string.ex21_price, price))
Spacer(Modifier.height(8.dp))
// o plural: a categoria "zero" não existe nem em francês nem em
// inglês (0 é "one" em francês, "other" em inglês): 0 é
// tratado separadamente
Text(
if (count == 0) stringResource(R.string.ex21_no_appointment) else pluralStringResource(R.plurals.ex21_appointments, count, count),
fontWeight = FontWeight.Bold,
)
FlowRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
TextButton(onClick = { count++ }) { Text(stringResource(R.string.ex21_add)) }
TextButton(onClick = { count-- }, enabled = count > 0) { Text(stringResource(R.string.ex21_remove)) }
}
// o calendário Material: seus textos seguem o idioma do aplicativo
OutlinedButton(onClick = { calendarOpen = true }) {
Icon(Icons.Default.DateRange, contentDescription = null)
Spacer(Modifier.width(8.dp))
Text(stringResource(R.string.ex21_calendar))
}
}
}
Card(Modifier.fillMaxWidth()) {
Column(Modifier.padding(12.dp)) {
Text(stringResource(R.string.ex21_server_title), style = MaterialTheme.typography.titleSmall)
Text(stringResource(R.string.ex21_server_explanation))
Spacer(Modifier.height(8.dp))
for (r in serverResponses) {
Text("${r.statusCode} ${r.key}", fontFamily = FontFamily.Monospace, fontSize = 12.sp)
// o recurso da chave; seus parâmetros, em ordem (*: "espalha" o array)
val id = serverKeys[r.key]
Text("→ " + if (id == null) r.key else stringResource(id, *r.params.values.toTypedArray()))
Spacer(Modifier.height(6.dp))
}
}
}
}
if (calendarOpen) {
val state = rememberDatePickerState()
DatePickerDialog(
onDismissRequest = { calendarOpen = false },
// os textos OK / Cancelar do próprio Android, no idioma do aplicativo
confirmButton = { TextButton(onClick = { calendarOpen = false }) { Text(stringResource(android.R.string.ok)) } },
dismissButton = { TextButton(onClick = { calendarOpen = false }) { Text(stringResource(android.R.string.cancel)) } },
) {
DatePicker(state = state)
}
}
}