
Официальный VPN-клиент для iOS и macOS, обеспечивающий шифрованное туннелирование, безопасное хранение учётных данных, автоматическую настройку сервера и поддержку популярных VPN-протоколов.
Copyright (c) 2025 Proton Technologies AG
Этот проект использует Swift Package Manager для всех своих зависимостей. Разрешите Xcode разрешить пакеты перед запуском любого таргета.
Разрешённые версии записываются в ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved. Собственный общий
код Proton поставляется как git-сабмодули в каталоге external/, и они должны быть инициализированы до того,
как workspace сможет разрешить зависимости.
Самый быстрый путь — ./Integration/Scripts/bootstrap.sh из корня репозитория, который устанавливает
зависимости Homebrew, клонирует и связывает репозиторий учётных данных, инициализирует сабмодули и устанавливает
pre-commit hook. Шаги ниже — это то, что он делает, плюс то, что он не может сделать за вас.
git submodule init + git submodule update)brew bundleCmd+Shift+K)Для сборки проекта требуется набор секретов.
Они включают URL-адреса и ключи и хранятся в файлах с именем ObfuscatedConstants.swift.
Эти файлы хранятся в отдельном репозитории, что требует дополнительной настройки для поддержания синхронизации.
Сначала вызовите скрипт, расположенный по адресу Integration/Scripts/credentials.sh, с командой setup.
Укажите путь, по которому вы хотите клонировать репозиторий секретов локально, с помощью аргумента -p, и URL репозитория с помощью аргумента -r.
./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>
Затем, чтобы убедиться, что настройка прошла успешно:
./Integration/Scripts/credentials.sh checkout
При правильной настройке обфусцированные константы будут автоматически синхронизироваться на этапе сборки Generate Obfuscated Constants каждого приложения.
Проект упакован по слоям, чтобы избежать ада зависимостей между модулями:
Добавления нового кода/функций в LegacyCommon и NEHelper по возможности следует избегать. Эти пакеты следует постепенно разбирать, чтобы разместить их компоненты в новых/существующих пакетах в трёх категориях выше.
Во время разработки swiftlint запускается в нестрогом режиме, чтобы было проще разрабатывать, не беспокоясь о форматировании кода. В CI линтинг строгий и завершится ошибкой при любом предупреждении. Перед коммитом кода в этот репозиторий запустите следующий скрипт, чтобы добавить pre-commit hook, который будет проверять все новые/изменённые файлы в строгом режиме и не даст вам закоммитить код, который не пройдёт CI.
./Integration/Scripts/pre_commit_lint.sh setup
Приложение использует SwiftGen для генерации типобезопасных аксессоров для строк в пакете Strings. Добавляйте новую строку только в английский Localizable.strings, затем запустите swiftgen из libraries/Foundations/Strings и закоммитьте перегенерированный Strings.swift. Все остальные языки поступают из Crowdin и не должны редактироваться вручную.
Обратите внимание, что названия невыпущенных функций добавляются как заполнители, такие как $HERMES, и на этапе сборки они подставляются с использованием сопоставлений в libraries/Foundations/Strings/Codewords.strings.env. При добавлении такой строки используйте заполнитель, а не реальное название.
Код и файлы данных в этом дистрибутиве лицензированы на условиях GPLv3, опубликованной Free Software Foundation. См. https://www.gnu.org/licenses/ для получения копии этой лицензии.
Copyright (c) 2025 Proton Technologies AG