
Offizieller VPN-Client für iOS und macOS mit verschlüsseltem Tunneling, sicherer Speicherung von Anmeldedaten, automatisierter Serverkonfiguration und Unterstützung für gängige VPN-Protokolle.
Copyright (c) 2025 Proton Technologies AG
Dieses Projekt verwendet den Swift Package Manager für alle seine Abhängigkeiten. Erlaube Xcode, Pakete aufzulösen, bevor du ein Ziel ausführst.
Aufgelöste Versionen werden in ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved aufgezeichnet. Pro-tons eigener
gemeinsam genutzter Code ist als Git-Submodule unter external/ eingebunden, und diese müssen initialisiert werden, bevor
der Workspace aufgelöst werden kann.
Der schnellste Weg ist ./Integration/Scripts/bootstrap.sh aus dem Repository-Stamm, welches die
Homebrew-Abhängigkeiten installiert, das Credentials-Repository klont und verlinkt, Submodule initialisiert und den
Pre-Commit-Hook installiert. Die folgenden Schritte sind das, was es tut, plus das, was es nicht für dich tun kann.
git submodule init + git submodule update)brew bundleCmd+Shift+K)Eine Reihe von Geheimnissen ist erforderlich, um das Projekt zu bauen.
Diese umfassen URLs und Schlüssel und werden in Dateien namens ObfuscatedConstants.swift aufbewahrt.
Diese Dateien werden in einem separaten Repository aufbewahrt, welches eine zusätzliche Einrichtung erfordert, um synchronisiert zu bleiben.
Rufe zunächst das Skript unter Integration/Scripts/credentials.sh mit dem Befehl setup auf.
Gib den Pfad an, an dem das Geheimnis-Repository lokal geklont werden soll, über das Argument -p und die URL des Repositorys über das Argument -r.
./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>
Anschließend, um zu überprüfen, ob die Einrichtung erfolgreich war:
./Integration/Scripts/credentials.sh checkout
Wenn die Einrichtung korrekt ist, werden obfuskierte Konstanten während der Build-Phase „Generate Obfuscated Constants“ jeder App automatisch synchronisiert.
Das Projekt ist schichtweise paketiert, um Modulabhängigkeitshölle zu vermeiden:
Das Hinzufügen von neuem Code/neuen Funktionen zu LegacyCommon und NEHelper sollte nach Möglichkeit vermieden werden. Diese Pakete sollten schrittweise abgetragen werden, um ihre Komponenten in neue/bestehende Pakete der oben genannten drei Kategorien zu überführen.
Während der Entwicklung wird swiftlint im nicht-strikten Modus ausgeführt, damit die Entwicklung einfacher ist, ohne sich um die Codeformatierung kümmern zu müssen. In der CI ist das Linting strikt und schlägt bei jeder Warnung fehl. Bevor Code in dieses Repository committet wird, führe das folgende Skript aus, um einen Pre-Commit-Hook hinzuzufügen, der alle neuen/geänderten Dateien im strikten Modus prüft und dich daran hindert, Code zu committen, der die CI nicht bestehen wird.
./Integration/Scripts/pre_commit_lint.sh setup
Die App verwendet SwiftGen, um typsichere Zugriffe für die Strings im Strings-Paket zu generieren. Füge einen neuen String nur der englischen Localizable.strings hinzu, führe dann swiftgen aus libraries/Foundations/Strings aus und committe die neu generierte Strings.swift. Alle anderen Sprachen stammen von Crowdin und dürfen nicht manuell bearbeitet werden.
Beachte, dass Namen unveröffentlichter Funktionen als Platzhalter wie $HERMES eingecheckt werden, und ein Build-Schritt ersetzt sie zur Build-Zeit anhand der Zuordnungen in libraries/Foundations/Strings/Codewords.strings.env. Verwende einen Platzhalter statt des echten Namens, wenn du einen solchen String hinzufügst.
Der Code und die Datendateien in dieser Distribution sind unter den Bedingungen der GPLv3 lizenziert, wie von der Free Software Foundation veröffentlicht. Siehe https://www.gnu.org/licenses/ für eine Kopie dieser Lizenz.
Copyright (c) 2025 Proton Technologies AG