Localite 是一个轻量级的 iOS 本地化包,可简化字符串文件的远程管理。
它允许您从远程服务器下载并缓存本地化文件,
从而更轻松地保持应用程序的本地化更新,而无需频繁的应用程序更新。

特性

安装

Swift 包管理器

您可以使用 Swift 包管理器将 Localite 集成到您的 Xcode 项目中。

在 Xcode 中,转到 File > Swift Packages > Add Package Dependency 并输入仓库 URL

https://github.com/TelemTobi/Localite.git

用法

初始化

通过设置您的应用程序以使用特定语言并提供字符串文件的 URL 来初始化 Localite 配置。

import Localite

// Get the first language in user's preferred langauges your app supports
Localite.shared.configure(using: yourStringsFileURL, for: "en", version: 1)

或者,当您的应用程序仅支持一种语言时

// Initialize Localite for a single language
Localite.shared.configure(using: yourStringsFileURL)

该文件将被缓存以支持离线模式。

获取和使用字符串

配置 Localite 后,您可以使用标准的 NSLocalizedString 函数访问本地化的字符串。
Localite 将自动从提供的 URL 获取字符串文件,对其进行缓存,并将其用于本地化。

let localizedString = NSLocalizedString("hello_key", comment: "")

版本管理

Localite 为本地化文件提供版本管理。
当您使用版本号初始化 Localite 时,它仅在版本大于上次获取的版本时才获取文件。
如果未提供版本,则始终会获取该文件。

您还可以检查特定语言的缓存版本

let cachedVersion = Localite.shared.cachedVersion(for: "en")

清除缓存

要清除 Localite 缓存,包括缓存的字符串文件和内容,请使用 clearCache 方法

Localite.shared.clearCache()

要求

许可证

Localite 在 MIT 许可证下可用。 有关更多信息,请参见 LICENSE 文件。

贡献

我们鼓励并欢迎来自社区的贡献。
如果您想为 Localite 的开发做出贡献,请随时参与。
您可以从以下方面入手

非常感谢您的参与,这有助于使 Localite 变得更好。 感谢您考虑贡献!