增加NSHipster文章xcconfig翻译 #300

ericchuhong · 2020-04-06T07:52:12Z

这篇文章对应的 Issue 链接是：
#294
本文的大致阅读时长：[15 ] 分钟。

PR Checklist:

我已经仔细阅读翻译说明文档
我的文章符合格式要求
我的文章头部符合头部格式
我已经完成自查环节，从读者角度阅读，我确定文章足够通顺易懂

请校对同学帮忙校对。

Nemocdz

一次校对

Nemocdz · 2020-04-06T08:49:00Z

nshipster/20200227_xcconfig.md

+
+<!--此处开始正文-->
+
+软件开发最佳实践中 [规定](https://12factor.net/config) 配置要与代码分离。但是在 Apple 平台的开发者经常努力使这些规范与 Xcode 繁重的项目工作流保持一致。


努力使这些规范与 Xcode 繁重的项目工作流保持一致 -> 需要花很大力气将这些规范和 Xcode 繁重的项目工作流整合起来

Nemocdz · 2020-04-06T08:50:54Z

nshipster/20200227_xcconfig.md

+
+软件开发最佳实践中 [规定](https://12factor.net/config) 配置要与代码分离。但是在 Apple 平台的开发者经常努力使这些规范与 Xcode 繁重的项目工作流保持一致。
+
+了解每个项目设置的作用是什么，以及它们间是如何相互影响的，是一项需要多年磨练的技能。而事实上，无论在 Xcode 的 GUI 上做多么深入的研究，都对我们没帮助。


在 Xcode 的 GUI 上做多么深入的研究 -> 在 Xcode 的 GUI 上研究多么深入

Nemocdz · 2020-04-06T08:53:05Z

nshipster/20200227_xcconfig.md

+
+* * *
+
+[Xcode 编译配置文件](https://help.apple.com/xcode/mac/8.3/#/dev745c5c974)，更常见的是它们的 `xcconfig` 文件扩展，可以让你不用 Xcode 就能 声明和管理你应用的编译设置。它们是纯文本，意味着它们对版本管理系统更加友好，并且能被任意编辑器修改。


更常见的是 -> 更常被大家所认知的是

Nemocdz · 2020-04-06T08:53:29Z

nshipster/20200227_xcconfig.md

+
+* * *
+
+[Xcode 编译配置文件](https://help.apple.com/xcode/mac/8.3/#/dev745c5c974)，更常见的是它们的 `xcconfig` 文件扩展，可以让你不用 Xcode 就能 声明和管理你应用的编译设置。它们是纯文本，意味着它们对版本管理系统更加友好，并且能被任意编辑器修改。


就能声明，中间有个括号

应该是想说空格

Nemocdz · 2020-04-06T08:53:58Z

nshipster/20200227_xcconfig.md

+
+[Xcode 编译配置文件](https://help.apple.com/xcode/mac/8.3/#/dev745c5c974)，更常见的是它们的 `xcconfig` 文件扩展，可以让你不用 Xcode 就能 声明和管理你应用的编译设置。它们是纯文本，意味着它们对版本管理系统更加友好，并且能被任意编辑器修改。
+
+基本说来，每一个配置文件包含了一组带有以下语法的键值对：


基本说来 -> 通常来首

Nemocdz · 2020-04-06T09:20:33Z

nshipster/20200227_xcconfig.md

+#include "<#path/to/File.xcconfig#>"
+```
+
+正如我们将在本文后面看到的，你可以利用这一点，以非常强大的方式构建编译设置的级联列表。


在下文会看到

Nemocdz · 2020-04-06T09:25:29Z

nshipster/20200227_xcconfig.md

+```
+通常当编译器遇到无法解析的 `include` 指令时，它会抛出异常。但是 `xcconfig` 文件也支持 `#include?` 指令，如果找不到文件则不会有任何问题。
+
+在很多情况下，你不会希望文件的存在与否会改变编译时的行为；毕竟，在编译时就可被预测才是最好的方式。但你可以在类似 [Reveal](https://revealapp.com/) 这样的可选开发工作中，将其做为 hook 使用。


但你可以在类似 Reveal 这样的可选开发工作中 -> 但你可以用它来为像 Reveal 这类可选开发工具实现一个 hook，使用下面的配置

Nemocdz · 2020-04-06T09:27:30Z

nshipster/20200227_xcconfig.md

+
+![xcconfig-project-configurations--light](https://nshipster.com/assets/xcconfig-project-configurations--light-a82440e27f27e3b139ab51c7317780c6b4a017dfcc56532972da5d521f1f0988.png)
+
+> 编译配置文件不应该被包含在你的任一项目 targets 中。如果你在应用的 `.ipa` 归档文件中发现 `.xcconfig` 文件，确保它们不是任何 targets 的配置文件，并且确保其不会出现在任何一个 "Copy Bundle Resources" 构建阶段。


任何一个 -> 任何的...中

Nemocdz · 2020-04-06T09:31:33Z

nshipster/20200227_xcconfig.md

+
+> `xcconfig` 将 `//` 视为注释分隔符, 不管它是否被括在引号中。如果你尝试用反斜杠 `/\/` 进行转义，那这些反斜杠只会按字面描述进行显示，但在处理后的值中又必须将其删除。当需要指定每个环境的 URL 常量时，这尤其不方便。
+
+> 如果你不想处理这种不幸的行为，则可以省略该方案并在代码中预先改成 `https://`。_（你是有在用 https... 对吧?）_


你是有在用 -> 你应该在用...的吧？

Nemocdz · 2020-04-06T09:41:33Z

nshipster/20200227_xcconfig.md

+
+* * *
+
+Xcode 的各个项目程序是庞大而僵化的、不稳定而且封闭的。它们是团队成员之间协作的矛盾源，并且经常成为我们工作的阻力。


Xcode 的项目是大型集中化的，但脆弱又封闭。

Nemocdz

还有一处需要修改

Nemocdz · 2020-04-07T01:50:09Z

nshipster/20200227_xcconfig.md

+
+<!--more-->
+
+打开项目编辑器的 “Build Settings” 标签，你会看到 _上百条_ 编译设置，其中含括了有 project、targets 和配置 -- _更不用说其他的_ _6_ _个标签了！_


上百条前后无需空格，--前后无需空格，切破折号用的不是中文，下文同

我说下文同是让你全文检查一遍呀，我记得不止一处的

numbbbbb · 2020-04-10T02:24:01Z

nshipster/20200227_xcconfig.md

+![xcconfig-project-build-settings--light](https://nshipster.com/assets/xcconfig-project-build-settings--light-f7043782f0b56d637bec89eefa0d37939b38ef33f55c293e326d3fecbc06df49.png)
+
+还好我们有一个更好的方式来管理这些配置，而不用点击迷宫般的标签和一个个箭头。
+这一周，我们会给你展示如何使用基于文本的 `xcconfig` 文件，来表示 Xcode 中的编译设置，从而让你的项目具有更好的内聚性、更清晰易懂，也更加强大。


这两段之间需要空行隔开，否则会被合并成一段。

numbbbbb · 2020-04-10T02:25:12Z

nshipster/20200227_xcconfig.md

+
+* * *
+
+[Xcode 编译配置文件](https://help.apple.com/xcode/mac/8.3/#/dev745c5c974)，更常被大家所认知的是它们的 `xcconfig` 文件扩展，可以让你不用 Xcode 就能声明和管理你应用的编译设置。它们是纯文本，意味着它们对版本管理系统更加友好，并且能被任意编辑器修改。


更常被大家所认知的是它们的 => 也就是我们熟悉的

numbbbbb · 2020-04-10T02:26:01Z

nshipster/20200227_xcconfig.md

+
+![xcconfig-new-file--light](https://nshipster.com/assets/xcconfig-new-file--light-1569134f8ecaeaee6640f28e544443da0136ff72b00f9343126147934ac134d4.png)
+
+一旦你创建好了一份 `xcconfig` 文件，你可以在它关联 target 中，分配给它一份或者多份编译配置。


去掉第二个”你“

numbbbbb · 2020-04-10T02:26:15Z

nshipster/20200227_xcconfig.md

+
+* * *
+
+既然我们已经介绍了使用 Xcode 编译配置文件的基本知识，那么让我们来看几个示例，说明一下如何使用它们来管理开发、阶段和生产环境。


那么让我们来 => 接下来

开发、阶段和生产环境

stage 并不是阶段，一般是表示测试或者预上线环境，和生产环境做对应。我个人比较倾向于翻译成预上线。

numbbbbb · 2020-04-10T02:29:15Z

nshipster/20200227_xcconfig.md

+
+## 自定义内部版本的应用程序名称和图标
+
+开发 iOS 应用通常需要在模拟器和测试设备上处理各种内部版本（以及 App Store 的最新版本作为参考）。


以及 App Store 的最新版本作为参考 => 当然还包括 App Store 上的最新版本

numbbbbb · 2020-04-10T02:29:51Z

nshipster/20200227_xcconfig.md

+
+开发 iOS 应用通常需要在模拟器和测试设备上处理各种内部版本（以及 App Store 的最新版本作为参考）。
+
+您可以使用 `xcconfig` 文件简化您的工作，它会给每个配置分配一个不同的名称和应用图标。


全文的”您“和”你“要统一，一般全部翻译成”你“。

numbbbbb · 2020-04-10T02:30:18Z

nshipster/20200227_xcconfig.md

+
+## 跨环境管理常量
+
+如果你的后端开发人员们按前面提到的 [12 Factor App](https://12factor.net/confi)）那样做，那么他们将会有独立的终端用于开发、阶段和生产的环境。


你的后端开发人员们 => 后端开发人员

这里还是 stage 的翻译问题，和前面统一一下。

numbbbbb · 2020-04-10T02:31:58Z

nshipster/20200227_xcconfig.md

+
+Xcode 的项目是大型集中化的，但脆弱又封闭。它们是团队成员之间协作的矛盾源，并且经常成为我们工作的阻力。
+
+幸运的是，`xcconfig` 在很大程度上解决了这些问题。将配置从 Xcode 中移到 `xcconfig` 会带来很多好处，也提供了一种隔离项目和 Xcode 工作流的方式，同时不会偏离 Cupertino 允许的 “康庄大道”。


引号和中文之间不需要空格。

【feature】增加翻译

1498031

Nemocdz requested changes Apr 6, 2020

View reviewed changes

一次校对修改

fc40f75

Nemocdz requested changes Apr 7, 2020

View reviewed changes

调整符号问题

1b96b5d

numbbbbb requested changes Apr 10, 2020

View reviewed changes

二次校验修改

d19ee5d

numbbbbb approved these changes Apr 12, 2020

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

增加NSHipster文章xcconfig翻译 #300

增加NSHipster文章xcconfig翻译 #300

ericchuhong commented Apr 6, 2020 •

edited

Loading

Nemocdz left a comment

Nemocdz Apr 6, 2020

Nemocdz Apr 6, 2020

Nemocdz Apr 6, 2020

Nemocdz Apr 6, 2020

ericchuhong Apr 7, 2020

Nemocdz Apr 6, 2020

Nemocdz Apr 6, 2020

Nemocdz Apr 6, 2020

Nemocdz Apr 6, 2020

Nemocdz Apr 6, 2020

Nemocdz Apr 6, 2020

Nemocdz left a comment

Nemocdz Apr 7, 2020

Nemocdz Apr 9, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020

numbbbbb Apr 10, 2020


		<!--此处开始正文-->

		软件开发最佳实践中 [规定](https://12factor.net/config) 配置要与代码分离。但是在 Apple 平台的开发者经常努力使这些规范与 Xcode 繁重的项目工作流保持一致。


		软件开发最佳实践中 [规定](https://12factor.net/config) 配置要与代码分离。但是在 Apple 平台的开发者经常努力使这些规范与 Xcode 繁重的项目工作流保持一致。

		了解每个项目设置的作用是什么，以及它们间是如何相互影响的，是一项需要多年磨练的技能。而事实上，无论在 Xcode 的 GUI 上做多么深入的研究，都对我们没帮助。


		* * *

		[Xcode 编译配置文件](https://help.apple.com/xcode/mac/8.3/#/dev745c5c974)，更常见的是它们的 `xcconfig` 文件扩展，可以让你不用 Xcode 就能声明和管理你应用的编译设置。它们是纯文本，意味着它们对版本管理系统更加友好，并且能被任意编辑器修改。


		[Xcode 编译配置文件](https://help.apple.com/xcode/mac/8.3/#/dev745c5c974)，更常见的是它们的 `xcconfig` 文件扩展，可以让你不用 Xcode 就能声明和管理你应用的编译设置。它们是纯文本，意味着它们对版本管理系统更加友好，并且能被任意编辑器修改。

		基本说来，每一个配置文件包含了一组带有以下语法的键值对：


		![xcconfig-project-configurations--light](https://nshipster.com/assets/xcconfig-project-configurations--light-a82440e27f27e3b139ab51c7317780c6b4a017dfcc56532972da5d521f1f0988.png)

		> 编译配置文件不应该被包含在你的任一项目 targets 中。如果你在应用的 `.ipa` 归档文件中发现 `.xcconfig` 文件，确保它们不是任何 targets 的配置文件，并且确保其不会出现在任何一个 "Copy Bundle Resources" 构建阶段。


		> `xcconfig` 将 `//` 视为注释分隔符, 不管它是否被括在引号中。如果你尝试用反斜杠 `/\/` 进行转义，那这些反斜杠只会按字面描述进行显示，但在处理后的值中又必须将其删除。当需要指定每个环境的 URL 常量时，这尤其不方便。

		> 如果你不想处理这种不幸的行为，则可以省略该方案并在代码中预先改成 `https://`。_（你是有在用 https... 对吧?）_


		* * *

		Xcode 的各个项目程序是庞大而僵化的、不稳定而且封闭的。它们是团队成员之间协作的矛盾源，并且经常成为我们工作的阻力。


		<!--more-->

		打开项目编辑器的 “Build Settings” 标签，你会看到 _上百条_ 编译设置，其中含括了有 project、targets 和配置 -- _更不用说其他的_ _6_ _个标签了！_


		![xcconfig-new-file--light](https://nshipster.com/assets/xcconfig-new-file--light-1569134f8ecaeaee6640f28e544443da0136ff72b00f9343126147934ac134d4.png)

		一旦你创建好了一份 `xcconfig` 文件，你可以在它关联 target 中，分配给它一份或者多份编译配置。


		* * *

		既然我们已经介绍了使用 Xcode 编译配置文件的基本知识，那么让我们来看几个示例，说明一下如何使用它们来管理开发、阶段和生产环境。


		## 自定义内部版本的应用程序名称和图标

		开发 iOS 应用通常需要在模拟器和测试设备上处理各种内部版本（以及 App Store 的最新版本作为参考）。


		开发 iOS 应用通常需要在模拟器和测试设备上处理各种内部版本（以及 App Store 的最新版本作为参考）。

		您可以使用 `xcconfig` 文件简化您的工作，它会给每个配置分配一个不同的名称和应用图标。


		## 跨环境管理常量

		如果你的后端开发人员们按前面提到的 [12 Factor App](https://12factor.net/confi)）那样做，那么他们将会有独立的终端用于开发、阶段和生产的环境。


		Xcode 的项目是大型集中化的，但脆弱又封闭。它们是团队成员之间协作的矛盾源，并且经常成为我们工作的阻力。

		幸运的是，`xcconfig` 在很大程度上解决了这些问题。将配置从 Xcode 中移到 `xcconfig` 会带来很多好处，也提供了一种隔离项目和 Xcode 工作流的方式，同时不会偏离 Cupertino 允许的 “康庄大道”。

增加NSHipster文章xcconfig翻译 #300

Are you sure you want to change the base?

增加NSHipster文章xcconfig翻译 #300

Conversation

ericchuhong commented Apr 6, 2020 • edited Loading

Nemocdz left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Nemocdz left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ericchuhong commented Apr 6, 2020 •

edited

Loading