XCStrings 工具

Tests

一个插件,用于为您的 String Catalogs 和 Apple 平台上的其他本地化字符串资源生成 Swift 常量。

动机

在代码中硬编码本地化字符串,然后让编译器自动将它们提取到 Strings Catalog(或旧版 .strings 文件)中,在小型项目中效果很好,但随着时间的推移,您通常会发现这种方法无法很好地扩展。

您通常会发现自己需要在代码质量、译者注释或必须定义自己的常量而产生的样板代码之间做出妥协,但情况不必如此!

struct ContentView: View {
    @Query var items: [Item]

    var body: some View {
        List {
            Section {
                ForEach(items) { item in
                    ItemView(item)
                }
            } footer: {
                Text(.localizable(.footerText(items.count)))
            }
        }
        .navigationTitle(.localizable(.contentViewTitle))
    }
}

XCStrings 工具旨在扩展您的本地化体验,使您不必在任何方面做出妥协。它通过使用您的 Strings Catalog 作为源,生成优雅的 Swift 代码,您可以在项目的其余部分直接引用这些代码。

要求

入门指南

XCStrings 工具是一个 Swift Package 插件,可以集成到包含 Strings Catalog (.xcstrings) 文件的 Xcode 和 Swift Package 目标中。

有关 Strings Catalog 格式的更多信息,请查看 WWDC 2023 的 Discover Strings Catalogs 视频。

演示

要查看 XCStrings 工具的实际应用,请查看 Dog Tracker 演示项目

文档

在 Swift Package Index 上查看文档

如果您有文档改进建议,可以在此处修改

贡献

欢迎为 XCStrings 工具做出贡献!