
Client VPN officiel pour iOS et macOS offrant un tunneling chiffré, un stockage sécurisé des identifiants, une configuration automatisée du serveur et la prise en charge des protocoles VPN populaires.
Copyright (c) 2025 Proton Technologies AG
Ce projet utilise Swift Package Manager pour l'ensemble de ses dépendances. Laissez Xcode résoudre les paquets avant d'exécuter une cible.
Les versions résolues sont enregistrées dans ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved. Le code partagé de Proton est intégré en tant que sous-modules git sous external/, et ceux-ci doivent être initialisés avant que le workspace puisse être résolu.
Le chemin le plus rapide est ./Integration/Scripts/bootstrap.sh depuis la racine du dépôt, qui installe les dépendances Homebrew, clone et lie le dépôt des identifiants, initialise les sous-modules et installe le hook pre-commit. Les étapes ci-dessous décrivent ce qu'il fait, ainsi que ce qu'il ne peut pas faire à votre place.
git submodule init + git submodule update)brew bundleCmd+Shift+K)Un ensemble de secrets est requis pour compiler le projet.
Ceux-ci incluent des URLs et des clés, et sont conservés dans des fichiers nommés ObfuscatedConstants.swift.
Ces fichiers sont conservés dans un dépôt séparé, ce qui nécessite une configuration supplémentaire pour rester synchronisés.
Tout d'abord, invoquez le script situé à Integration/Scripts/credentials.sh avec la commande setup.
Indiquez le chemin où vous souhaitez que le dépôt des secrets soit cloné localement à l'aide de l'argument -p, et l'url du dépôt à l'aide de l'argument -r.
./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>
Ensuite, pour vérifier que la configuration a réussi :
./Integration/Scripts/credentials.sh checkout
Si la configuration est correcte, les constantes obfusquées seront automatiquement synchronisées pendant la phase de build Generate Obfuscated Constants de chaque application.
Le projet est empaqueté par couche afin d'éviter l'enfer des dépendances entre modules :
L'ajout de nouveau code/fonctionnalité à LegacyCommon et NEHelper doit être évité autant que possible. Ces packages doivent être progressivement démantelés afin de placer leurs composants dans des packages nouveaux ou existants des trois catégories ci-dessus.
Pendant le développement, swiftlint est exécuté en mode non strict afin de faciliter le développement sans se soucier du formatage du code. Sur la CI, le linting est strict et échouera à tout avertissement. Avant de committer du code dans ce dépôt, exécutez le script suivant pour ajouter un hook pre-commit qui vérifiera tous les fichiers nouveaux/modifiés en mode strict et vous empêchera de committer du code qui ne passera pas la CI.
./Integration/Scripts/pre_commit_lint.sh setup
L'application utilise SwiftGen pour générer des accesseurs typés pour les chaînes du package Strings. Ajoutez une nouvelle chaîne uniquement dans le fichier anglais Localizable.strings, puis exécutez swiftgen depuis libraries/Foundations/Strings et committez le fichier Strings.swift régénéré. Toutes les autres langues proviennent de Crowdin et ne doivent pas être modifiées manuellement.
Notez que les noms des fonctionnalités non publiées sont enregistrés sous forme de placeholders tels que $HERMES, et une étape de build les remplace au moment de la compilation à l'aide des correspondances dans libraries/Foundations/Strings/Codewords.strings.env. Utilisez un placeholder plutôt que le vrai nom lors de l'ajout d'une telle chaîne.
Le code et les fichiers de données de cette distribution sont sous licence selon les termes de la GPLv3 telle que publiée par la Free Software Foundation. Voir https://www.gnu.org/licenses/ pour une copie de cette licence.
Copyright (c) 2025 Proton Technologies AG