不等式表达式

它由几个元素组成

• ie: - 不等式表达式的前缀
• x - 您必须始终传递它，这意味着这里是一个匹配数字的位置。与Ints和浮点数一起工作。
• <, <=, =, >=, > - 使用一个不等式符号
• 1, 3, 5, 6, … - 要匹配的值是这个表达式中的最后一个

示例

"cars": {
    "ie:x=1": "1 car",
    "ie:x=0": "no cars",
    "ie:x>1": "%d cars"
}

扩展不等式表达式

这是扩展不等式表达式的版本。它由两个值组成，一个标值和一个两个不等式符号。

• iex: - 扩展不等式表达式的前缀
• x - 将要匹配的数字的位置。与Ints和浮点数一起工作。
• 只能接受<和<=。

示例

"tomatos": {
    "iex:2<x<10": "%d tomatos is between 2 and 10"
}

正则表达式表达式

这是最强大的表达式类型。它需要正则表达式；)

• exp: - 正则表达式表达式的前缀
• 字符串 - 它可以接受包含正则表达式的字符串

示例：(波兰语的警车)

"police-cars": {
    "exp:^1$": "1 samochód policyjny",
    "exp:(((?!1).[2-4]{1})$)|(^[2-4]$)": "%d samochody policyjne",
    "exp:(.*(?=1).[0-9]$)|(^[05-9]$)|(.*(?!1).[0156789])": "%d samochodów policyjnych"
}

功能强大，不是吗？：>

PS. 有内置的波兰语解决方案，所以您可以通过以下方式使用它

"police-cars": {
    "one": "1 samochód policyjny",
    "few": "%d samochody policyjne",
    "many": "%d samochodów policyjnych"
}

这被称为“共享内置表达式”，下面会介绍。

共享表达式

共享表达式是所有本地化文件中可用的表达式。它们在expressions.json文件中根据语言进行声明，您可以在本地化文件中使用这些表达式。

该功能允许开发者遵循DRY原则，并避免因在多个地方重复代码而产生的错误。

通常，您可以这样声明表达式

...
"ie:x>1": "Localized String"
...

如果您希望在同一文件中重复使用相同的表达式，无需在别处重复该表达式。当您决定改进/更改表达式以处理您忘记的其他情况时，这也可能成为一个问题 - 您将不得不在多个位置更改表达式。正因为如此，才有了共享表达式。这些特性允许您在一个地方创建表达式，并在需要放置该表达式的多个地方使用其标识符。

您需要做的就是创建以下结构的expressions.json文件。

{
    "base": {
        "one": "ie:x>1"
    },

    "pl": {
        // ... other than "one" because "one" is available here too.
    }
}

现在在pl.json、en.json等文件中，您需要如下使用它。

...
"one": "Localized String"
...

在您决定创建自己的表达式之前，查看是否已存在同名的内置表达式或是否有类似的但名称不同的表达式。也许您根本不需要这样做，只需使用它即可。

内置表达式

如名称所示，内置表达式是预建入框架中的共享表达式，无需配置即可使用。它们按国家划分，并非所有国家都有自己的内置表达式。目前，例如有基本内置表达式和波兰内置表达式。基本表达式在所有国家都可用，它们非常通用，可以匹配所有国家的复数/基数数词逻辑。

支持的内置共享表达式列表

Base (English fits to this completely)
- one - detects if number is equal 1
- >one - detects if number is greater than 1
- two - detects if number is equal 2
- other - detects if number is not 1, so 0, 2, 3 and so on.

Polish
- few - matches (2-4), (22-24), (32-4), ..., (..>22, ..>23, ..>24)
- many - matches 0, (5-9), (10-21), (25-31), ..., (..0, ..1, ..5-9)

如您所见，由于默认继承自基本类型，波兰没有“one”、“>one”等。

入门指南

本章向您展示如何开始使用Swifternalization以及如何将其与您的代码集成。

文档

文档涵盖了100%的代码，太好了！有两种类型的文档。第一种仅涵盖公开API，这是为那些只想使用框架而不想深入了解的人准备的。第二种涵盖了所有的API - 公开、内部和私有。

您可以在docs目录中找到公共API和完整文档。

它还托管在我的博客上http://szulctomasz.com。

• 公共API文档
• 完整API文档

文档集

• 公共API文档集
• 完整API文档集

安装

它与iOS 8.0和更高版本兼容。

使用CocoaPods

pod 'Swifternalization', '~> 1.3.1'

如果您不使用CocoaPods，只需将Swifternalization/Swifternalization目录中的文件导入到您的项目中即可。

Swifternalization也支持Carthage。

配置 - 可选

在您获取第一个本地化字符串之前，您必须通过传递本地化JSON文件所在的捆绑包来配置Swifternalization。如果您不调用configure()，它将默认使用内部NSBundle.mainBundle()。

它将从配置它所使用的捆绑包中获得语言。因此，如果它没有翻译您的字符串，请确保您已在项目>信息>本地化部分添加了本地化 - 与常规本地化相同的部分。

I18n.configure(bundle) // if files are in another bundle

创建包含共享表达式的文件

共享表达式必须放在expressions.json中。文件的语法看起来如下。

{
    "base": {
        "ten": "ie:x=10",
        ">20": "ie:x>20",
        "custom-pl-few": "exp:(.*(?=1).[0-9]$)|(^[05-9]$)|(.*(?!1).[0156789])"
    },

    "pl": {
        "few": "exp:(((?!1).[2-4]{1})$)|(^[2-4]$)",
        "two": "ie:x=2",
        "three": "ie:x=3"
    }
}

在伪语言中

{
    "language-1": {
        "shared-expression-key-1": "expression-1",
        "shared-expression-key-2": "expression-2"
    },

    "language-2": {
        "shared-expression-key-1": "expression-1"
    }
}

可以从文件中获取表达式并将其用于可本地化文件中。不同语言的共享表达式都放在同一文件中，因为每种语言的表达式数量很少。大部分表达式都定义在 基础 变体中，因为如果在 基础 中，那么在每种其他语言中也可以使用。所以，“十”在“pl”中可用，但“三”在“base”中不可用。

按国家创建具有本地化的文件

可本地化文件包含特定语言的翻译。文件可能看起来如下

{
    "welcome-key": "welcome",

    "cars": {
        "one": "one car",
        "ie:x>=2": "%d cars",
        "ie:x<=-2": "minus %d cars"
    }
}

文件的名称应与国家代码相同。例如，对于英语，它是 en.json，对于波兰语，它是 pl.json，对于基础本地化，它是 base.json 等。

你可以在这种文件中放置一些内容。更复杂的文件如下所示

{
    "welcome": "welcome",

    "cars": {
        "one": {
            "@100": "one car",
            "@200": "You have one car",
            "@400": "You have got one car"
        },

        "other": "%d cars"
    }
}

在伪语言中

{
    "key": "value",

    "key": {
        "expression-1": {
            "length-variation-1": "value-1",
            "length-variation-2": "value-2",
            "length-variation-3": "value-3"
        },

        "expression-2": "value"
    }
}

获取本地化字符串

Swifternalization 允许您使用其一个类方法，该方法公开您用于本地化应用程序所需的所有方法。

这些方法具有许多可选参数，如果您想的话，可以省略它们。有一些常见参数

• key - 本地化字符串的键。
• fittingWidth - 您要在其中放置本地化字符串的屏幕或位置的宽度。它是整数。
• defaultValue - 如果传递给方法的键没有本地化字符串，将返回的值。如果没有指定，则返回 key。
• comment - 仅由开发人员使用的注释，用以了解翻译的上下文。

首次调用方法 localizedString(_:fittingWidth:defaultValue:comment:) 允许您获取简单键的值，而不包含表达式。

示例

I18n.localizedString("welcome")
I18n.localizedString("welcome", fittingWidth: 200)
I18n.localizedString("welcome", defaultValue: "Welcome", comment: "Displayed on app start")

下一个方法 localizedString(_:stringValue:fittingWidth:defaultValue:comment:) 允许您获取与表达式匹配的字符串值的本地化字符串。实际上，字符串值通常包含数字或您想匹配的其他字符串。

I18n.localizedString("cars", stringValue: "5")
// Other cases similar to above example

最后一个方法 localizedString(_:intValue:fittingWidth:defaultValue:comment:) 允许您获取整数值的本地化字符串。此方法调用上述方法，并将整数值转换为字符串，因为所有框架都基于字符串操作。

I18n.localizedString("cars", intValue: 5)

贡献

Swifternalization 是开源的，因此如果愿意，任何人都可做出贡献。如果您想为其开发，只需将仓库分支出来，做您的工作并创建拉取请求。如果您有一些想法或问题，请随时创建问题并为它添加适当的标签。

没有为贡献者提供指南，但如果您添加了新功能，您必须为它编写单元测试。

未来版本中的任务

• 为其他国家的更多内建表达式添加支持。
• 为内建表达式添加对浮点数的支持，这些表达式使用正则表达式。

LICENSE

Swifternalization 在 MIT 许可下发布。