LocalizeWiz 0.4.0

LocalizeWiz 0.4.0

×

由 John Warmann 维护。

LocalizeWiz 0.4.0

  • 作者：
  • LocalizeWiz

LocalizeWiz iOS SDK

Version License Platform

LocalizeWiz iOS SDK 可以让您无缝地将实时云翻译集成到您的 iOS 应用中。

安装

Cocoapods

使用 Cocoapods 之前，如果您尚未安装 Cocoapods，请先安装。

sudo gem install cocoapods

然后，在项目目录中初始化 pod

pod init

在项目的根目录中打开 Podfile 文件，并添加以下行

pod LocalizeWiz

然后运行以下命令，在项目文件夹中下载并安装 LocalizeWiz sdk。

pod install

现在 LocalizeWiz SDK 已安装。打开根项目的 .xcworkspace 文件继续操作。

Carthage

您还可以使用 Carthage 安装 LocalizeWiz SDK。

如果您尚未安装 Carthage，可以使用 homebrew 安装

brew install carthage

在您的 .xcodeproj 或 .xcworkspace 文件所在的同一目录中创建一个 Cartfile。

在您创建的 Cartfile 中，添加以下行

github "localizewiz/wiz-ios-sdk"

在 shell 上运行以下命令

carthage update

Swift 包管理器

您还可以使用 Swift 包管理器 (SPM) 安装 LocalizeWiz SDK。

初始化

安装 LocalizeWiz SDK 后，下一步是在您的项目中初始化它。您需要 API 密钥和项目 ID 才能进行此操作。如果您尚未创建项目，请查看我们的网络仪表板指南，了解如何创建项目。

将以下内容添加到您的 AppDelegate.swift 文件顶部以导入库并初始化全局实例

import LocalizeWiz

let wiz = Wiz.sharedInstance

我们建议创建一个可从应用程序代码的任何位置访问的 wiz 全局变量。如果您不想创建全局变量，可以在每个想要使用 wiz 的类中创建属性，通常在视图控制器中。您只需使用 val wiz = Wiz.instance 访问 wiz 的共享实例即可。

将以下内容添加到您的 AppDelegate.swift 文件顶部，并在 application(didFinishLaunchingWithOptions:) 方法中添加此内容

wiz.setup(apiKey: "your-wiz-api-key", projectId: "your-project-id")

如果您还没有账户，在我们的网络仪表板上注册并创建工作空间和项目。

使用

我们设计了 Wiz，以便作为 NSLocalizedString 的简便替代品，因此切换到 wiz 很容易。

设置控件文本的基本用法如下。只需将 NSLocalizedString(key) 的出现替换为 wiz.getString(key)。

例如，如果您的项目中存在以下代码

var myLabel = UILabel(...)
myLabel.text = NSLocalizedString("key to set", comment: "")

将其替换为以下内容

var myLabel = UILabel(...)
myLabel.text = wiz.getString("key in localized")

这返回了指定键的字符串，为当前区域进行本地化，就像 NSLocalizedString 一样。如果没有找到字符串，或者当前区域不存在本地化，将返回项目基础语言中的原始字符串。通过使用 Wiz 而不是 NSLocalizedString，您可以在仪表板上更新字符串并在应用程序中处理，而无需执行应用程序更新。

有关设置项目的详细信息，请参阅我们的文档