// =========================================================================
// ex21/Ex21Activity.kt - 一个双语应用
// -------------------------------------------------------------------------
// Android 的方式:
// - 应用的文本是资源:一个文件
// res/values/strings.xml(默认语言,这里是英语),以及每种翻译一个
// 文件(res/values-fr/strings.xml)。每段文本有一个
// 名称;代码只认这个名称(R.string.ex21_hello),
// Android 根据应用的语言选择文件;
// - stringResource(R.string.ex21_hello, "Marie"):该文本,其
// 参数(%1$s)会被替换;pluralStringResource:复数
// 文本,其形式遵循语言的规则;
// - 应用的语言:手机的语言……或者由
// 应用自己选择的语言,通过 AppCompatDelegate.setApplicationLocales。
// 随后 Android 会用新语言重新创建 Activity:文本、
// 日期、金额,以及 Android 自身的文本(
// 日历及其按钮)。
// 至于 RdvMedecins 服务器,它只返回键(“ERRORS.LOGIN_TAKEN”):
// 它们通过一张表(serverKeys)与资源关联。
// 该 Activity 是一个 AppCompatActivity:这种 Activity 类能够
// 应用所选语言,即使在 13 之前的 Android
// 版本上也是如此。
// =========================================================================
@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")
// RdvMedecins 服务器会返回的内容(参见关于黑盒的章节)
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")),
)
// 服务器的键 -> 翻译它的资源
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() } }
}
}
// 选择应用的语言:Android 会存储它,并重新创建 Activity
fun changeLanguage(language: String) {
AppCompatDelegate.setApplicationLocales(LocaleListCompat.forLanguageTags(language))
}
@Composable
fun TranslatedPage() {
// rememberSaveable:计数在 Activity 重新创建后依然保留
var count by rememberSaveable { mutableIntStateOf(2) }
var calendarOpen by rememberSaveable { mutableStateOf(false) }
// 当前语言:Activity 配置中的语言
val locale = LocalConfiguration.current.locales[0]
// 当前语言的格式化器
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),
// 语言:“分段”按钮,位于顶部栏中
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))
// 复数:法语和英语中都不存在“zero”类别
// (法语中 0 属于“one”,英语中属于“other”):0 被
// 单独处理
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)) }
}
// Material 日历:它的文本遵循应用的语言
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)
// 该键对应的资源;它的参数,按顺序排列(*:“展开”数组)
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 },
// Android 自身的 OK / Cancel 文本,使用应用的语言
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)
}
}
}