跟着视频学编程：使用 Xcode 探索本地化

跟着视频学编程：使用 Xcode 探索本地化

探索如何使用 Xcode 将你的 App 本地化为其他语言。我们将逐步介绍创建 String Catalog、翻译文本以及与外部翻译器交换文件的流程。你将了解为翻译器提供必要语境信息的最佳实践，以及 Xcode 如何帮你自动提供这类信息。对于大型项目，我们将还深入探讨使用类型安全的 Swift 代码来管理复杂度并简化字符串管理的实用技巧。

章节
- 0:00 - 简介
- 0:38 - 入门指南
- 5:33 - 翻译的语境
- 9:33 - 管理复杂度
- 20:49 - 后续步骤
资源
相关视频

WWDC23
- 探索字符串目录
大家好！我是本地化团队的 Andreas 在这个讲座中我们将探讨如何使用 Xcode 进行本地化
这个讲座不需要提前掌握专门知识我们将一起探讨如何设置 App 以进行本地化然后我们将讨论如何为从事 App 翻译工作的人员提供合适的上下文信息最后我们将深入了解随着项目不断壮大你可能会遇到的一些复杂情况并讨论可以帮助你管理这些情况的新功能我们这就开始吧！
这个讲座支持同步编程也就是说你可以将这个视频中的步骤应用到通过描述中的链接提供的示例项目中请下载 Landmarks 项目然后和我一起开始将它本地化！我在 Xcode 中打开了这个项目这个版本的 Landmarks 英文版效果很棒但还没有翻译成任何其他语言首先我们使用“File”菜单添加一个字符串目录
可以使用默认名称“Localizable” 但我希望将它放在 Resources 组中素材目录也在这个位置现在已经添加了字符串目录接下来可以构建项目了当存在字符串目录时 Xcode 会在每次构建后发现可本地化的字符串并自动将这些字符串添加到字符串目录中我们无需特意执行任何操作就能让这个目录中的字符串与代码保持同步但 Xcode 如何知道我们要将哪些字符串本地化呢？大多数 SwiftUI API 都默认使字符串可本地化包括文本和按钮等视图在示例代码的其余部分 String(localized: ) 也使字符串可用于本地化
现在我将使用辅助编辑器来了解字符串目录中的字符串是从什么位置提取的
这一个字符串来自一个确认对话框
这里有一个字符串用作 LabeledContent 的标题这个字符串用作导航标题这个字符串来自使用插值变量的 Text 函数如你所见大多数 SwiftUI API 都可以直接本地化你可能已经注意到这个字符串表示项目数量占位符 %lld 在运行时会被替换为地标的数量我们希望这个字符串根据具体数字而有所不同例如我们希望它显示为 “1 item”和“2 items”
为此我们打开上下文菜单并选择“Vary by Plural”
现在我们可以编写适用于一个项目以及多个项目的短语
在运行时系统会选择与数字相匹配的正确字符串这个问题很容易解决
接下来要说的是本地化的重点在于其他语言我碰巧会说德语所以我也可以直接在字符串目录中自己编写一些翻译我们关闭辅助编辑器为了为这个项目添加语言我点按底部栏中的加号按钮然后选择“German (de)” 就这么简单然后我要开始添加一些翻译
请注意随着我将翻译进行下去已翻译字符串的状态会从“NEW” 变为右侧的绿色勾号！
与此同时边栏中显示的整体翻译进度增加到 8%
不过我做翻译不如搞开发在行所以我与一名语言专家开展合作我希望由对方来完成剩余的德语翻译
为了将我到目前为止做出来的东西发送给对方我前往 Xcode 中的 “Product”菜单然后选择 “Export Localizations” 因为我要将 App 翻译成德语版所以我想只导出德语版
这项操作会生成一个本地化目录文件其中包含了到目前为止我已经完成的所有德语翻译以及尚未翻译的英文字符串这个打包文件包含了多项翻译服务都能轻松处理的业界通用 XLIFF 文件对方完成翻译后就会发回全部翻译好的本地化目录
为了将它重新导入到项目中我再次前往“Product”菜单然后选择 “Import Localizations” Xcode 需要一点时间来构建项目但随后所有字符串都会被标记为已翻译
德语版的整体翻译进度也达到了 100% 你也可以这么做！示例项目包含了全部翻译好的 de.xcloc 文件你可以像我一样将它导入到 Xcode 中现在是时候在实际操作中测试一下了我想运行德语版 App 打开方案编辑器编辑方案选择“Run”然后导航到“Options”
在这里我们可以将下一次调试时 App 的语言更改为德语
现在我将在 Mac 上构建并运行这个 App
这是完全本地化的德语版我很喜欢这个全新外观！
设置新 App 以进行本地化就是这么简单接下来我们深入了解一下如何向翻译人员提供额外的上下文信息以确保出色的翻译质量 Xcode 中的 Assistant 编辑器可以在字符串目录旁边显示代码效果非常棒但翻译人员在进行翻译时往往看不到我们的代码或是运行中的 App 我们需要提供额外的上下文信息来帮助他们编写出色的翻译内容
这些上下文信息是以注释形式添加的可以直接在代码中添加也可在字符串目录的注释列中添加如果没有注释翻译人员可能会很难理解字符串的使用方式例如 “Landmarks”只是一个词我们指的是 App 的名称还是地图上的地标？这个字符串键的内容是 “%@ is contained in %@” 翻译人员如何判断 %@ 占位符代表什么？这会影响这个字符串的翻译效果！好的注释可以说明字符串用于哪个界面元素比如标签栏、按钮或副标题
描述周围的用户界面元素也很有帮助例如补充说明第一个字符串是边栏中的条目会很有帮助！第二个字符串是列表中地标的副标题所以我们也要补充说明这一点最后注释应该说明每个占位符中可以出现哪种内容在这里第一个占位符是地标的名称第二个占位符是这个地标所属精选集的名称如果没有注释就不可能正确翻译这个字符串因此提供准确的注释至关重要！
去年我们为字符串目录添加了一项功能可以跟踪字符串是从代码中的什么位置提取的今年我们将利用这些信息来帮助你 Xcode 26 中推出了自动注释生成功能！
Xcode 会使用设备端模型来分析你的代码现在还可以为你编写注释！我们来看看它的实际效果！到目前为止我们只为代码中的部分字符串提供了注释了解注释的重要性之后我们来改进一下给翻译人员提供的上下文信息！这里有一个没有注释的字符串看起来像是用于按钮的打开它的上下文菜单然后选择“Generate Comment” 在分析字符串的使用位置后 Xcode 生成的注释内容是 “The text label on a button to cancel the deletion of a collection.” 非常精准！
这个字符串也没有注释所以我让 Xcode 为我们生成一条注释
它生成的内容是“A label displayed above the location of a landmark.” 没问题我想强调的是我们在这里仍然可以进行编辑你输入的内容始终会覆盖生成的注释我喜欢与模型协同工作以提供一些额外的信息所以我要补充说明这个字符串会显示在检查器中
我觉得这项功能非常有用我还希望 Xcode 为它从代码中提取的所有新字符串生成注释！为此我打开“Settings”
然后导航到“Editing”
在这里启用“Automatically generate string catalog comments”这项设置从现在开始当 Xcode 检测到代码中新增了可本地化的字符串时就会自动生成注释这样就可以非常轻松地向翻译人员提供所需的上下文信息
为了帮助翻译工具的开发者指出注释由 Xcode 生成的情况 Xcode 导出的 XLIFF 文件会将这类注释标注为“auto-generated”
要进一步了解与其他工具的互操作性以及字符串目录可以实现的所有其他功能请观看“探索字符串目录”
随着项目不断壮大并变得越来越复杂还有其他的 Xcode 功能和本地化 API 可以帮助你让项目保持井井有条例如随着项目规模越来越大或许会有多名开发者开始从事这个项目我们有时会将代码库拆分为多个扩展、框架和 Swift 软件包其中每一项都可能包含一个或多个字符串目录现在在这类情况下我们必须在本地化 API 上使用另一个参数：bundle 这将告诉系统在运行时可以在什么位置找到这个字符串现在 “Bundle.main” 始终指主 App 如果不提供 bundle 参数则默认使用 .main
今年新增的功能是 #bundle 宏你可以使用它来引用包含当前目标所需资源的 bundle 如果代码在主 App 中运行那么当前目标就是主 App 如果不是这样它会自动查找框架或 Swift 软件包所需的资源此外它还能在旧版操作系统上正常运行顺利完成任务！
还有一种字符串整理方法是将相关的字符串分组到一起例如把与特定屏幕、功能或用户流程相关的所有字符串分组到一起我们将字符串组称为“表” 而每个字符串目录都代表一个表
默认情况下所有字符串都被提取到名为“Localizable”的表中这与创建字符串目录时的默认文件名相一致当然我们可以更改这个名称！可以使用参数 tableName 将字符串放入我们选择的字符串目录中例如使用表名称“Discover” 会自动将字符串放入 “Discover.xcstrings”中
虽然 Landmarks App 在创建私人地标精选集时效果很棒但我还想开发一项可以发现更多内容的功能这些内容要么来自我关注的好友要么来自精选内容源接下来我们开始在新框架中开发这项功能
首先打开“File”菜单然后添加一个新目标搜索“framework”
这个框架是用来发现新地标的因此我将它命名为“DiscoverKit”
我要从零开始创建一个新屏幕我还想将这个屏幕的所有字符串放在一个单独的表中我们向 DiscoverKit 添加一个新文件
选择“String Catalog” 然后将它命名为“Discover”
为方便起见按住 Shift 和 Option 同时点按新的 Swift 文件从而在右侧编辑器中打开代码
然后关闭导航器以腾出更多空间
我将开始使用枚举在模型层中开发这项功能我的新枚举定义了内容是来自好友还是精选内容它有一个属性用于公开自身的本地化标题我们来实现这个属性首先使用 String(localized: ) 来公开要本地化的字符串然后使用 table 参数来更好地进行整理由于我们处于一个框架内因此我也需要使用 bundle 参数然后对另一种情况执行相同的操作
这样枚举就完成了现在我要导入 SwiftUI 并添加一个视图从而在屏幕上显示一些内容
我还没有实施任何业务逻辑所以现在显示一个占位符内容说的是有 42 个新帖子
键入这些内容就够了接下来是时候让 Xcode 干点活了！我要将方案更改为新框架然后进行构建
一旦构建完毕新字符串就会出现在我的目录中
而且它们已经带有注释了！太棒了！
对于剩余的 UI 工作我想向大家介绍 Xcode 26 中的一个全新工作流程字符串目录在面世时就支持从代码中提取字符串今年它们可以通过为手动添加的字符串生成符号来帮助你编写代码我们来通过这个新的工作流程继续构建视图我的目标是添加导航标题和导航副标题现在整个视图都处于开发阶段通过让字符串键与它们的值分离开来我无需更新代码就能对具体措辞进行迭代
首先点按字符串目录中的加号按钮来添加新字符串更受许多项目青睐的设置是使用由大写字母组成的键来说明字符串的语义含义我在这里也会这么做键应该是“TITLE” 值应该是“Discover Landmarks” 由于我手动添加了这个字符串因此我需要自己编写注释
属性检查器告诉我如何在代码中使用这个字符串这对我大有帮助！我会分毫不差地照做！
为了在导航栏中显示标题我要使用视图修饰符 “.navigationTitle”
对于它的值键入一个前导圆点然后开始键入表的名称 Xcode 可以为我自动补全表名称还会推荐这个表中包含的所有手动添加的字符串
真简单！请注意这一次我不必手动键入 bundle 和表名称
我们再来一遍不过针对的是导航副标题！我要向目录添加一个新字符串并将它命名为“SUBTITLE”
我想让它总结一下来自好友的帖子数量以及属于精选内容的帖子数量为此我需要一个占位符而格式说明符可以做到这一点！首先键入 % 现在 Xcode 会推荐几个可供使用的格式说明符在这里我想要数字所以选择整数占位符
这个占位符代表来自好友的帖子数量所以我将它命名为“friendsPosts”
接下来为精选帖子添加另一个占位符
然后到了添加注释的时候
现在这个字符串已经可以用在代码里了这一次我要使用修饰符 “navigationSubtitle”
我再次开始键入 “.Discover” 以找到正确的表自动补全功能会完成剩余的部分
键入工作量少了很多！请注意 Xcode 为我推荐了正确的类型！这项新功能让手动字符串变得非常易于使用现在我可以依靠自动补全功能和编译器来载入这些本地化之后的资源！现在如果我稍后想要更改字符串的值可以直接在字符串目录中更新而不必修改代码你是否遇到过曾经用多种方式拼写“OK” 后来希望通过一个简单的操作纠正所有拼写的情况？
为了生成在 Swift 中感觉恰到好处的符号名称 Xcode 会使用字符串的键和值对于不包含占位符的字符串可以像访问任何其他静态属性一样访问如果字符串包含占位符那么 Xcode 会改为生成一个函数并使用占位符名称作为参数标签生成符号是 LocalizedStringResource 类型上的静态变量或函数这项功能非常强大因为这些符号可以用在任何使用 LocalizedStringResource 的位置！这些位置包括文本或按钮等 SwiftUI 视图还有 .navigationSubtitle() 等视图修饰符如果不使用 SwiftUI 的话 Foundation 的 String(localized: ) 也适用于 LocalizedStringResource 类型
现在还可以使用生成符号来调用那些使用 LocalizedStringResource 的自定视图和其他声明
如果使用默认表名称“Localizable” 就可以在 LocalizedStringResource 上直接访问你的符号如果使用非默认表名称那么生成符号会嵌套在这个表的命名空间中这意味着你可以在以表名称开头的代码中访问你的符号由 Xcode 26 创建的新项目默认启用符号生成功能要在现有项目中使用这项功能请打开构建设置的 “Generate String Catalog Symbols”
我们已经看到 Xcode 现在完全支持两种不同的字符串管理工作流程：从代码中提取以及使用类型安全的 API 进行引用这就引出了一个问题：我应该使用哪个工作流程？我们建议你首先依靠字符串提取你在开发 UI 的位置编写字符串能让你更快地阅读和理解代码使用这个工作流程时你可以利用 Xcode 的注释生成功能在减少键入工作量的同时仍然可以向翻译人员提供有意义的上下文信息随着项目发展壮大你可能会发现自己想要更好地控制对字符串的整理在这个示例中我们建议使用生成符号这样可以将键与它们的值分离开来让你能够在不更改代码的情况下对文本进行迭代此外借助 Xcode 的自动补全功能你可以轻松引用各个表中的字符串最后生成符号可以帮助你避免框架和软件包中出现样板代码
这两种方法各有优势我们认为应该由你来自由决定哪一种方法最适合你的项目因此我们添加了强大的重构功能这样你就可以在两种方法之间轻松切换接下来我们在 DiscoverKit 框架中试试这个功能！我认为导航堆栈中的占位符文本非常适合被符号引用打开它的上下文菜单然后选择 “Refactor > Convert Strings to Symbols”
系统会打开一个预览用户界面其中显示将会使用符号来替代字符串的确切位置点按突出显示的部分可以将符号与原来的代码进行比较
我们将键的名称更改为 “feedTitle”让它更具语义性还可以为 Argument 1 添加一个好名字！我要将它命名为“newPosts” 看起来不错！我要确认重构
考虑了这两种方法之后我决定对这个表中的所有字符串使用生成符号我们选择其余两个
选择“Refactor”> “Convert Strings to Symbols”
我对符号名称很满意因此我要点按“Convert”
整个表的重构一下子就完成了就是这么简单！强烈建议大家自行探索 Xcode 中的这些本地化功能首先依靠字符串提取来进行项目本地化向翻译人员提供有意义的注释可以自己编写注释也可使用 Xcode 的注释生成功能随着项目的复杂性越来越高可以考虑使用生成符号来保持对字符串的精确控制
最后如需详细了解字符串目录请观看我们之前的视频 “探索字符串目录” 谢谢观看我希望这些新功能可以帮助大家简化本地化工作流程

// import SwiftUI
Text("Featured Landmark", comment: "Big headline in the hero image of featured landmarks.")

Button("Keep") { }

// import Foundation
String(localized: "New Collection", comment: "Default name for a new user-created collection.")

6:00 - Adding a comment

Text("Delete",
comment: "Delete button shown in an alert asking for confirmation to delete the collection.")

String(localized: "Shared by Friends", comment: "Subtitle of post that was shared by friends.")

9:13 - XLIFF file

// Field for automatically generated comments in the XLIFF

<trans-unit id="Grand Canyon" xml:space="preserve">
<source>Grand Canyon</source>
<target state="new">Grand Canyon</target>
<note from="auto-generated">Suggestion for searching landmarks</note>
</trans-unit>

9:58 - Localized String in the main app and a Swift Package or Framework

// Localized String in the main app:
Text("My Collections", 
comment: "Section title above user-created collections.")

// Localized String in a Swift Package or Framework
Text("My Collections", 
bundle: #bundle, 
comment: "Section title above user-created collections.")

10:56 - Localized String with a tableName parameter

// Localized String in the main app:
Text("My Collections",
tableName: "Discover",
comment: "Section title above user-created collections.")

// Localized String in a Swift Package or Framework
Text("My Collections",
tableName: "Discover",
bundle: #bundle, 
comment: "Section title above user-created collections.")

17:31 - Symbol usage

// Symbol usage in SwiftUI
Text(.introductionTitle)

.navigationSubtitle(.subtitle(friendsPosts: 42))


// Symbol usage in Foundation
String(localized: .curatedCollection)


// Working with generated symbols in your own types
struct CollectionDetailEditingView: View {
    let title: LocalizedStringResource
    
    init(title: LocalizedStringResource) {
        self.title = title
    }
}
CollectionDetailEditingView(title: .editingTitle)

- 0:00 - 简介
- 在这段适合所有技能水平的代码实践过程中，你将学习如何设置 App 以进行本地化、如何与翻译人员协作，以及如何在项目规模不断增长时有效管理其中的复杂性。
- 0:38 - 入门指南
- 我们将介绍如何使用 Xcode 对名为“Landmarks”的 SwiftUI App 进行本地化。这一过程从添加字符串目录开始，该目录会在每次构建后自动发现可本地化的字符串。你可以自行对字符串目录进行本地化，也可以通过 XLIFF 文件与专业翻译人员协作完成翻译工作。
- 5:33 - 翻译的语境
- 在向翻译人员提供文件时，上下文对于准确翻译至关重要。你可以直接在代码中或在字符串目录中添加注释。Xcode 26 推出了自动注释生成功能，它使用设备端模型来分析你的代码并提供注释建议。
- 9:33 - 管理复杂度
- 随着项目规模不断增长，你可能希望将其组织成捆绑包或框架。使用本地化 API 标识字符串时，可以指定捆绑包和表格参数。Xcode 26 还引入了一个新的工作流程，可以自动生成字符串的符号，从而实现字符串键与值的分离。你可以选择并轻松切换两种工作流程：从代码中提取字符串，或者使用生成的符号。
- 20:49 - 后续步骤
- 要本地化你的 App，你可以先从代码中提取字符串，随着项目变得日益复杂，再逐步过渡到使用生成的符号，以实现更高效的字符串管理。

章节

资源

相关视频

WWDC23