SuperAPI AI 工具集

ios-localization

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:为 Apple 平台应用实现、审查和改进本地化与国际化,涵盖 String Catalogs、现代字符串类型、区域感知格式化与从右到左布局。

主要能力:

  1. String Catalogs(.xcstrings):Xcode 15+ 推荐工作流,集中管理可本地化字符串、复数规则与设备变体;旧 .strings/.stringsdict 可在迁移期共存。Xcode 构建时自动提取 SwiftUI 文本(如 Text("Welcome back"))、String(localized:)、LocalizedStringResource 等模式,普通 String 不会被提取。
  2. 生成式符号:Xcode 26 在 String Catalog 之上的类型化访问层,需在 Build Settings > Localization > Generate String Catalog Symbols 设为 Yes,目录格式版本 1.1。手动键默认勾选生成 Swift 符号,自动提取键可通过 Refactor > Convert Strings to Symbols 转换;符号为 internal,跨模块需公开包装扩展或使用 xcstrings-tool。
  3. 字符串类型选择:SwiftUI 视图文本用 LocalizedStringKey;视图模型、服务与错误用 String(localized:);App Intents、小组件、延迟系统 UI 用 LocalizedStringResource;日志与分析用普通 String。
  4. 插值与复数:插值转为可重排的位置参数;整数插值触发 String Catalog 复数变体,按 CLDR 类别(zero/one/two/few/many/other)提供翻译,other 必填。
  5. FormatStyle:日期、数字、货币、度量单位等区域感知格式化,避免硬编码格式,建议在 en_US、de_DE、ar_SA、ja_JP 等区域下测试。
  6. RTL 布局:SwiftUI 自动镜像 HStack 顺序、leading/trailing、导航返回按钮等;需镜像的图片用 .flipsForRightToLeftLayoutDirection(true),电话号等强制 LTR。

使用方式:在 Xcode 中启用 String Catalog 并添加目标语言;用上述字符串类型编写代码;在编辑器中标记 Needs Review/Translated/Stale;用预览环境变量测试 RTL 与长文本。

适用场景:iOS/macOS 应用多语言发布、App Intents 与小组件本地化、区域格式化与 RTL 适配。

限制:生成式符号需 Xcode 26 与目录格式 1.1;LocalizedStringResource 需 iOS 16+;String(localized:) 插值初始化需 iOS 15+;Swift 包本地化需声明 defaultLocalization 并处理资源路径。资料未提供具体收费、价格或平台支持范围。