适用于 iOS 和 macOS 的 Proton VPN

依赖项

本项目使用 Swift Package Manager 管理所有依赖。在运行任何目标之前，请允许 Xcode 解析包。

第三方依赖

ACKNOWLEDGEMENTS.md

设置

在您的机器上启用 Git LFS
克隆此仓库
确保您克隆子模块（git submodule init + git submodule update）
使用 brew bundle 安装 Homebrew 依赖
目前您需要使用 Xcode 14.x
使用付费的 Apple 开发者帐户为所有目标配置代码签名（由于 VPN 授权要求）并将 bundle 标识符更改为唯一值
在 Xcode 中清理构建文件夹（Cmd+Shift+K）

混淆常量

构建项目需要一组机密信息。其中包括 URL 和密钥，保存在名为 ObfuscatedConstants.swift 的文件中。这些文件存放在一个单独的仓库中，需要一些额外设置来保持同步。

首先，使用 setup 命令调用位于 Integration/Scripts/credentials.sh 的脚本。使用 -p 参数提供您希望将机密仓库克隆到本地的路径，并使用 -r 参数提供仓库的 URL。

./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>

然后，要验证设置是否成功：

./Integration/Scripts/credentials.sh checkout

如果设置正确，混淆常量将在每个应用的“生成混淆常量”构建阶段自动同步。

包结构

项目按层打包，以避免模块依赖地狱：

Foundations：用于构建更大功能的小型、单一用途库。这些库之间应尽可能避免相互链接，即便链接也仅限于彼此之间。
Shared：稍大一些的库，用于在应用或扩展之间共享代码。该库中过大或适合独立成模块的部分可以拆分到 Foundations。这些库应仅链接 Foundations 库，可能的例外是这些库各自链接 CoreCommon。
Features：包含单一功能的自包含库。这些库应仅链接 Shared 或 Foundations 类别的库。它们在应用、测试或扩展代码中被引入和实例化。

应尽可能避免向 LegacyCommon 和 NEHelper 添加新代码/功能。这些包应逐步拆分，以便将其组件放入上述三个类别的新/现有包中。

代码检查

在开发过程中，swiftlint 以非严格模式运行，这样更容易开发而无需担心代码格式。在 CI 上，代码检查是严格的，任何警告都会导致失败。在向此仓库提交代码之前，请运行以下脚本以添加一个 pre-commit 钩子，该钩子将以严格模式检查所有新增/修改的文件，并阻止您提交无法通过 CI 的代码。

./Integration/Scripts/pre_commit_lint.sh setup

本地化

该应用使用 SwiftGen 生成 Localizable.strings 文件，用于访问存储在标准 Localizable.strings 文件中的所有应用字符串。只需向 Strings 包添加新字符串，然后在定义了 swiftgen.yml 的目录中运行 swiftgen 命令即可。

许可证

本发行版中的代码和数据文件根据自由软件基金会发布的 GPLv3 条款授权。请参阅 https://www.gnu.org/licenses/ 获取该许可证的副本。

ios-mac-app

最受欢迎