项目： Smart PDF
技术栈： Android, Kotlin, Jetpack Compose
一、 字符串资源解耦 (String Externalization)
1. 现状： 代码中存在硬编码（Hard-coded）字符串插值，如 "${pdf.pages}P"。
2. 问题： * 无法支持多语言翻译。
- UI 内容与业务逻辑耦合。
- 无法处理不同语言的后缀逻辑。
3. 解决方案： 将静态文本与动态参数剥离，存入 strings.xml 资源文件。
-
中文 (
values/strings.xml):<string name="page_count">%1$dP</string> -
英文 (
values-en/strings.xml):<string name="page_count">%1$d Pages</string>
二、 动态内容占位符与语序逻辑 (String Formatting)
1. 现状： 使用字符串拼接处理动态标签，如 "修改时间：" + date。
2. 问题： 不同语言的语法结构（Syntax）差异导致拼接顺序固定，不符合非中文语境的表达习惯。
3. 解决方案： 使用带索引的占位符（Argument Specifiers），允许翻译文件控制参数位置。
-
实现：
context.getString(R.string.modified_date, dateString) -
配置： * 中文：
修改时间：%1$s- 英文：
Modified on %1$s
- 英文：
三、 区域感知日期格式化 (Locale-aware Date Formatting)
1. 现状： 采用固定模式 YYYY-MM-DD。
2. 问题： * 美国 (US): 习惯 MM/DD/YYYY。
-
英/澳/新 (UK/AU/NZ): 习惯
DD/MM/YYYY。 - 固定格式在 UI 层会产生识别歧义（Ambiguity）。
3. 解决方案： 放弃手动硬编码模式（Pattern），调用系统 Locale 感知格式化工具。
- 核心代码：
// 使用系统预设的中等长度格式
val formatter = DateTimeFormatter.ofLocalizedDate(FormatStyle.MEDIUM)
val label = date.format(formatter)
四、 语法一致性处理 (Plurals/Quantity Strings)
1. 现状： 数字与单位直接组合，如 1 Pages。
2. 问题： 不符合英语及其他西方语言的单复数（Singular/Plural）语法规则。
3. 解决方案： 使用 Android plurals 资源处理数量级映射。
- 配置示例：
<plurals name="pdf_pages">
<item quantity="one">%d Page</item>
<item quantity="other">%d Pages</item>
</plurals>
-
调用：
pluralStringResource(R.plurals.pdf_pages, count, count)
五、 结论与工程价值
- 架构解耦： UI 文案成为可配置项，逻辑代码不再感知具体语言内容。
- 消除歧义： 通过系统级 API 解决日期格式在不同国家/地区的认知冲突。
- 语法合规： 确保全球化环境下 UI 文本的语法正确性。
- 求职导向： 该实践符合北美及全球化 IT 企业的通用工程规范（Engineering Best Practices）。
