Lingo

Lingo 添加了静态类型本地化字符串,从而可以实现快速且不易出错的用户可见字符串输入。

安装

📦 Swift 包管理器(推荐)

使用 SPM 可以获得本地开发和 CI 环境的最佳整体效果。

Lingo 添加到您的 Packages.swift 文件中

.package(url: "https://github.com/Mobelux/Lingo", from: "1.0.0"),

向您的 Xcode 项目添加一个 Run Script 构建阶段,并包含以下脚本

INPUT="./<app-name>/Resources/Localizable.strings"
OUTPUT="./<app-name>/Utils/Lingo.swift"

if which .build/release/lingo >/dev/null; then
.build/release/lingo --input $INPUT --output $OUTPUT
else
swift run -c release lingo --input $INPUT --output $OUTPUT
fi

🌱 Mint

mint install Mobelux/Lingo

向您的 Xcode 项目添加一个 Run Script 构建阶段,并包含以下脚本

INPUT="./<app-name>/Resources/Localizable.strings"
OUTPUT="./<app-name>/Utils/Lingo.swift"

lingo --input $INPUT --output $OUTPUT

⚙️ 手动

克隆此仓库并构建可执行文件

swift build -c release lingo

将生成的可执行文件复制到可以执行的位置。 建议将其添加到项目目录并包含在 SCM 中,以便在 CI 上获得最佳效果。

向您的 Xcode 项目添加一个 Run Script 构建阶段,并包含以下脚本

INPUT="./<app-name>/Resources/Localizable.strings"
OUTPUT="./<app-name>/Utils/Lingo.swift"

<path-to-lingo>/lingo --input $INPUT --output $OUTPUT

用法

向您的项目添加一个 Localizable.strings 文件,对于大多数配置,这都是您的 --input 文件。 第一次执行 Lingo 时,它将在 --output 中指定的位置创建一个 Swift 源文件。 将此文件添加到您的 Xcode 项目。 后续执行将更新此文件,并添加新的本地化字符串。

插件支持

Lingo 可以用作 Xcode 项目或 Swift 包的构建工具插件。 当作为插件使用时,它不需要任何配置。

Xcode

将 Lingo 作为包依赖项添加到您的项目中,而无需链接任何产品。

为所需的目标打开 Build Phases 检查器,展开 Run Build Tool Plug-ins 部分,然后选择 + 按钮。 从列表中选择 LingoPlugin 并将其添加到项目中。

Swift 包

Package.swift 中将 Lingo 添加为包依赖项后,使用 plugins 参数将 LingoPlugin 添加到目标。

targets: [
    .target(
        ...
        plugins: [
            .plugin(name: "LingoPlugin", package: "Lingo")
        ]
    )
]