1. Configuring Network Settings

启动 Charles 。它应该请求允许自动配置您的网络设置。如果没有，请按 Shift-Command-P 以查看此提示：

2. Installing SSL Certificates

Charles 介于 Web 浏览器和 API 之间。它使用自己的根证书 (root certificate) （也称为证书颁发机构 (CA)）动态创建和签署它发送到本地浏览器的证书，让您以纯文本形式查看网络流量。

为此，您必须在要查看网络请求和响应的设备或模拟器中安装并信任 Charles 根证书。

转到运行 StarCharles 的模拟器。打开 Safari ，然后输入 chls.pro/ssl 。

Focusing on a Host

默认情况下， Charles 会跟踪 Mac 上的所有网络调用。现在，您只对一个特定的 host 感兴趣： https://swapi.dev/ 。通过只关注这个域，您可以避免在 Charles 中看到每个网络请求时分心。

按照以下步骤专注于单个域：

单击 Sequence 选项卡以按时间顺序显示网络调用。

这样，您就向 focus 列表添加了一个域名。您可以随时禁用 Focus 过滤器并选择要关注的任何其他域。

注意：通过按 Shift-Command-O ，您可以查看 Focused Hosts 列表、添加或删除域以及导入和导出此列表。

Enabling SSL Proxying

查看其中一个 swapi.dev 请求中的内容。选择任何请求，然后单击屏幕下方的 Contents 选项卡。哇，那是什么？

注意：如果您看到 Request 和 Response 而不是 Contents ，请单击其中之一。这只是意味着您在 Charles Preferences 对话框的 Viewers 选项卡中取消了 Combine request and response 。

如果请求的内容出现乱码，则需要启用 SSL proxying 。这会告诉 Charles 使用您之前安装的根证书与您启用 SSL 代理的域进行通信。去做这个：

1）右键单击任何


    swapi.dev

请求，然后从下拉菜单中选择


    Enable SSL Proxying

。

2）退出并重新启动


    Charles

。

3）打开


    Proxy ▸ SSL Proxying Settings

。确认


    swapi.dev

显示为


    SSL Proxying

中包含的位置。

4）点击


    Charles

主窗口中的小扫帚扫除现有网络流。然后，在


    StarCharles

中进行网络呼叫。

5）现在，选择任何


    swapi.dev

请求并选择


    Contents

选项卡。

啊，好多了！

1. Mapping Requests to Local and Remote Responses

在 Charles 中， mapping 允许您更改请求，以便从新位置透明地提供其响应，就好像它是原始响应一样。事实上，数据实际上是从其他地方到达的，比如另一台主机甚至本地文件。

这意味着您可以根据自己的喜好模拟您的响应并操纵数据，然后查看您的应用程序如何处理更改。例如，如果变量的类型从 Int 更改为 String ，您的应用程序将如何运行？如果一个值意外为 nil 怎么办？您可以轻松测试这些问题。

Map Local 工具映射单个请求以从本地计算机而不是通常的端点获取响应。接下来，您将在 StarCharles 中试用它。

在下载的项目材料中，您将找到一个包含 films.json 的资源文件夹。使用以下步骤将 https://swapi.dev/api/films/ 映射到 film.json ：

在模拟器上的


    StarCharles

应用程序中，点击


    Films

。

您只需映射一个请求即可获得自定义的本地响应。结果，您拥有相同的数据模型，但具有不同的值。

从这一点开始，您可以操作 films.json 来包含您想要的任何值。但是，请注意数据模型，以避免将错误引入应用程序。

Map Remote Tool

正如 SWAPI 的狂热粉丝已经知道的那样，没有人维护原始的 swapi.co 。然而，幸运的是， SWAPI 的副本存在于银河系的其他地方。在本节中，您将使用 Map Remote 工具在 StarCharles 使用的副本 swapi.dev 和不同的副本 swapi.tech 之间进行映射。

使用以下步骤映射 https://swapi.dev/api/people/ 请求以从 https://www.swapi.tech/api/people/ 获取其响应：

点击


    StarCharles

中的


    Characters

以生成


    https://swapi.dev/api/people/

。

您可以双击任何映射进行编辑或使用显示的按钮添加新映射、重新排序映射列表、从其他地方导入映射或导出当前映射。

注意：映射设置会影响 StarCharles 显示的数据。如果在后面的部分中没有看到预期的结果，请检查是否需要启用或禁用本地或远程映射。

2. Using Breakpoints

试图解决后端问题？通过使用断点和处理空中数据，您可以模拟可能来自后端服务器的任何状态。

在本节中，您将通过在 https://swapi.dev/api/people/1 及其相应响应上添加断点来尝试此操作。在开始之前，通过转到 Tools ▸ Map Remote 并取消选中 Enable Map Remote 来关闭您在上一节中设置的远程 map 。保留本地映射；你会在这里使用它。

按照以下步骤在 https://swapi.dev/api/people/1 请求及其相应响应上添加断点。

在


    StarCharles

中打开


    Films

。

点击


    LOCAL A New Hope

。

在


    Charles

中右键单击请求


    https://swapi.dev/api/people/1

并选择


    Breakpoints

。

返回模拟器并再次打开


    LOCAL A New Hope

。

现在，您可以在请求到达后端之前使用任何输入更改请求的字段。

单击


    Execute

。第一次用于发送请求。

单击


    Execute

。第二次为请求响应。

执行此操作时，您在特定 API 调用上放置了一个断点。然后，您可以在向实际服务器发出该请求之前捕获该调用，并且您可以操作发送的请求。您还可以更改在到达客户端之前来自后端的确切响应 - 在本例中为 StarCharles 。

注意：如果您错过了响应，您的请求很可能因为超时而失败。尝试更快地进行更改。

要停止使用断点捕获请求，请转到 Proxy ▸ Disable Breakpoints 。

3. Filtering Requests with Allow and Block Lists

在本教程的前面部分，您学习了如何关注特定 host 。现在，您将学习如何制作一个列表以允许或阻止请求。如果您想模拟服务器错误或连接丢失的情况，这会派上用场。

按照以下步骤将 https://swapi.dev/api/people/2 添加到阻止列表：

在


    StarCharles

中打开


    Films

。

点击


    LOCAL A New Hope

。

在


    Charles

中右键单击


    https://swapi.dev/api/people/2

并选择


    Block List

。

返回模拟器并再次打开


    LOCAL A New Hope

。

通过这样做，您将该请求放在 block list 中。 Charles 会一直失败，你会在 Xcode 控制台中看到以下错误：

Fetch character completed: failure(StarCharles.NetworkError.jsonDecodingError(error: Foundation.URLError(_nsError: Error Domain=NSURLErrorDomain Code=-1 "(null)")))
您可以通过在 Charles 中再次右键单击此请求来禁用block，然后在下拉菜单中取消选中Block List。
注意：通过将任何请求添加到allow list，您将创建一个white list。 Charles 现在将阻止除allow list中的请求之外的所有请求。
您可以通过选择Tools ▸ Allow List 或者 Tools ▸ Block List来查看添加到允许或阻止列表的所有请求的列表。 您也可以在此处修改该列表。
Automating Actions
既然您知道如何使用断点操作请求和响应，您可能想知道是否有一种方法可以做到这一点，而无需打开断点编辑窗格并每次都争时间的地手动更改响应。
有！ 在本节中，您将学习如何为repetitive actions编写规则。
这不仅可以节省时间，还可以帮助那些对您的应用程序没有相同访问权限的测试人员。 例如，假设测试人员想要使用特定token试用您的应用。 在这种情况下，他们不需要为所有请求添加断点。 相反，他们可以使用Rewrite工具使用规则修改所有请求上的token。
使用Rewrite工具，您可以创建规则来修改通过 Charles 的请求和响应。
1） Sets：如左侧所示，每个can可以有不同的locations和不同的rules。
2） Locations：显示在右上角，每个locations都包含destination host的规范。
3） Rules：显示在右下角，每个规则都包含实际的重写操作，您可以在其中操作请求和响应的以下属性：
Header
Query Parameters
Response Status
接下来，您将尝试一下。
1. Rewriting Responses in Action
还记得您映射 https://swapi.dev/api/people/ 以获取来自 https://www.swapi.tech/api/people/ 的响应吗？
假设您是一名黑客，他想要使用中间人服务器来接收所有请求并收集数据，并使用与客户端预期的相同结构但使用不同的值对其进行响应。 您已经将原始服务器映射到新服务器； 现在，是时候用替换来重写所有请求了。
在本节中，您将重写该请求，以便它不是从 swapi.tech 获取people，而是获取planets。
删除占位符set（如果有）。
在 Charles 中，打开Tools ▸ Rewrite。
选中Enable Rewrite。
单击Add以添加新set并将其命名为 People。
如您所见，结果与以前不同。 当然，人们可能会争辩说，planets本身也是characters。
2. Repeating Requests
当您测试后端代码时，您可能希望在不涉及客户端的情况下检查服务器的响应。 Repeat工具使这变得容易。 通过右键单击任何请求，然后选择Repeat来启用它。
在这种情况下，Charles 向服务器重新发送完全相同的请求，并将响应作为新请求显示给您，而无需对您的客户端执行任何操作。 默认情况下，这只会发生一次。
当很难导航到客户端界面中发送请求的位置时，请记住Repeat工具。 一旦您有一个示例请求，请使用Repeat发送它。
注意：您可以使用 Repeat Advanced 获得更多选项，例如迭代次数和并发性，hook可能来自后端的错误。
Recording Network Activity
通过记录网络活动并将其保存到磁盘，您可以比较一段时间内的结果。 这让您可以查看您的后端团队是否对您的服务器进行了任何更改。
如果您想将任何结果作为测试人员或作为在特定请求中发现安全问题的黑客传递任何结果，这也可以让您制作一些报告。
1. Mirroring Network Data Locally
使用 Mirror，您可以将会话的响应保存到磁盘。 这有助于：
将数据从一台服务器迁移到另一台服务器。
制作所有responses的副本。
克隆服务器以在本地使用。
Charles 将响应放置在 API 本身使用的相同目录结构中。 这意味着对于与 URL 具有相同文件名的每个响应，您将拥有相同的路径。 请注意，文件名包括查询字符串。
现在，您可以看到保存的会话响应。
2. Automatically Saving Sessions
如今，大多数开发人员使用 Charles 或其他代理来监控他们与服务器的交互。但是，有时真的很难找到导致问题的特定请求和会话。这可能是因为您清理了Charles 会话视图，或者因为弹出了许多不同的请求。
假设您有一个测试人员，他使用 Charles 设置在多个设备上并行运行前端测试。在这种情况下，测试人员应该能够看到结果并在出现错误时轻松做出报告。通过使用Auto Save工具，测试自动化的管道变得更加简单。
使用此工具，Charles 会自动保存和清除任何时间段的记录会话。
要启用此功能，请按照以下步骤操作：
在 Charles 中，打开Tools ▸ Auto Save。
选中Enable Auto Save。
输入 2 作为保存间隔。这告诉Charles每两分钟保存一次。
选择一个目的地来保存数据。
对于本教程，将Save type保留为 Charles Session File。但是，请查看所有其他选择，以了解对您的用例有意义的内容。
您可以使用这些文件制作报告并与任何人共享。他们可以在 Charles 中打开文件并查看与您在此处生成的完全相同的会话。
注意：Auto Save和Mirror保存会话中的不同信息。Auto Save保留所有内容，所有请求和响应。 Mirror 仅保留您从服务器收到的作为响应的输出数据。
Using Charles in a Team
Charles 提供了多种功能来帮助测试人员和开发人员协同工作。您已经了解了使用 Auto Save 共享会话，但还有其他方法可以将 Charles 数据发送给其他人。您还可以发送您的 Charles 设置或导入其他人的设置，以便测试团队的所有成员都可以使用相同的设置。
1. Sharing Sessions
在 Charles 中，当您右键单击其中一个请求时，您会看到以下选项：
Copy URL：复制实际 URL。
Copy cURL Request：复制包含请求的所有数据（包括标头）的 cURL 请求。
Copy Response：复制响应内容。
Save Response：保存响应内容。
Export Session：以您选择的格式导出整个会话。
2. Sharing Settings
您可能已经注意到，Charles 提供了几乎所有内容的导入和导出选项，尤其是工具的配置。 尝试以下任一方法以从 Charles 共享工具配置：
1） 当您从菜单栏中打开任何工具时，您最终会进入一个包含两个选项的窗口，即Import和Export。 这使您可以在特定工具(specific tool)中执行操作。
注意：在下载的项目资料中，您可以在资源文件夹中找到Charles Settings.xml，您可以将其导入您的Charles。 它包括您在本教程中使用的所有配置。
恭喜！ 现在您已经完成了本教程，您对 Charles Proxy 的一些更高级的功能有了更深入的了解。
在本教程中，您学习了如何：
使用Charles作为代理观察网络，并顺便rewrite数据。
使用映射和断点来操作数据。
添加不同的规则集来rewrite请求和响应。
将所有网络活动保存到磁盘。
与他人分享报告。
如果您想更深入地探索，请从这里查看 Charles documentation。 有关 iOS 网络的更多信息，请查看 Networking with URLSession网络视频课程。
本篇主要讲述了iOS的Charles Proxy教程，感兴趣的给个赞或者关注~~~