objective-c - NSLocalizedString 中的注释标准

Question

人们如何为他们的 NSLocalizedString 编写评论？是否有我们应该遵循的标准指南？例如，如果我有:

NSLocalizedString(@"Tap your account to sign in", @""); 

我的评论是“要求用户通过点击帐户登录的文本”，这是否有点含糊？如果注释是不言自明的，我应该忽略它吗？

另一个问题是，如果我有一堆将文本设置为 LoggingIn 的 ProgressHUD，那么在我的应用程序项目中同步需要本地化为 NSLocalizedString (@"Logging In", @"some description"); 有执行此类任务的工具吗？

Answer 1

第二个参数是注释，如果您使用genstrings命令行实用程序，该注释将自动出现在字符串文件中，该实用程序可以通过扫描源代码为您创建字符串文件。

该评论对您的本地化人员很有用。例如:

NSLocalizedString(@"Save",@"Title of the Save button in the theme saving dialog");

当您运行 genstrings 时，这将在 Localized.strings 文件中生成一个条目，如下所示:

/* Title of the Save button in the theme saving dialog */
"Save" = "Save";

在您的具体示例中，注释的含义相当明显，但上下文却不清楚。您可能应该添加一些上下文，如下所示:

NSLocalizedString(@"Tap your account to sign in", @"Instruct user to tap their account to sign in (Facebook account, main game preferences)");

这样本地化人员就可以准确地知道您所指的按钮。

这对于标记为“共享”或其他一些非特定标签的按钮变得更加重要:

NSLocalizedString(@"Share", @"Label for sharing button on main image editing screen");

(这是我对 this similar question 的回答的修改版本)。