
Client VPN ufficiale per iOS e macOS che offre tunneling crittografato, archiviazione sicura delle credenziali, configurazione automatizzata del server e supporto per i protocolli VPN più diffusi.
Copyright (c) 2025 Proton Technologies AG
Questo progetto utilizza Swift Package Manager per tutte le sue dipendenze. Consenti a Xcode di risolvere i pacchetti prima di eseguire qualsiasi target.
Le versioni risolte sono registrate in ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved. Il codice condiviso di Proton è
fornito come git submodule sotto external/, e questi devono essere inizializzati prima che il
workspace possa essere risolto.
Il percorso più rapido è ./Integration/Scripts/bootstrap.sh dalla radice del repository, che installa le
dipendenze Homebrew, clona e collega il repository delle credenziali, inizializza i submodule e installa
l'hook pre-commit. I passaggi seguenti sono ciò che esegue, più ciò che non può fare per te.
git submodule init + git submodule update)brew bundleCmd+Shift+K)È richiesto un insieme di segreti per poter compilare il progetto.
Questi includono URL e chiavi, e sono conservati in file denominati ObfuscatedConstants.swift.
Questi file sono conservati in un repository separato, che richiede una configurazione aggiuntiva per rimanere sincronizzato.
Innanzitutto, invoca lo script situato in Integration/Scripts/credentials.sh con il comando setup.
Fornisci il percorso in cui desideri che il repository dei segreti venga clonato localmente usando l'argomento -p, e l'url del repository usando l'argomento -r.
./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>
Poi, per verificare che la configurazione sia andata a buon fine:
./Integration/Scripts/credentials.sh checkout
Se configurato correttamente, le costanti offuscate verranno sincronizzate automaticamente durante la fase di build Generate Obfuscated Constants di ciascuna app.
Il progetto è organizzato a pacchetti per livello al fine di evitare l'inferno delle dipendenze tra moduli:
Aggiungere nuovo codice/funzionalità a LegacyCommon e NEHelper dovrebbe essere evitato se possibile. Questi pacchetti dovrebbero essere progressivamente ridotti al fine di collocare i loro componenti in pacchetti nuovi/esistenti nelle tre categorie sopra indicate.
Durante lo sviluppo swiftlint viene eseguito in modalità non strict, così è più facile sviluppare senza preoccuparsi della formattazione del codice. In CI, il linting è strict e fallirà in presenza di qualsiasi warning. Prima di effettuare il commit del codice in questo repository, esegui il seguente script per aggiungere un hook pre-commit che controllerà tutti i file nuovi/modificati in modalità strict e ti impedirà di effettuare il commit di codice che non supererà la CI.
./Integration/Scripts/pre_commit_lint.sh setup
L'app utilizza SwiftGen per generare accessor type-safe per le stringhe nel pacchetto Strings. Aggiungi una nuova stringa solo al file inglese Localizable.strings, poi esegui swiftgen da libraries/Foundations/Strings ed effettua il commit del file Strings.swift rigenerato. Tutte le altre lingue provengono da Crowdin e non devono essere modificate manualmente.
Nota che i nomi delle funzionalità non ancora rilasciate vengono inseriti come segnaposto quali $HERMES, e una fase di build li sostituisce al momento della build utilizzando le mappature in libraries/Foundations/Strings/Codewords.strings.env. Usa un segnaposto anziché il nome reale quando aggiungi una stringa di questo tipo.
Il codice e i file di dati in questa distribuzione sono concessi in licenza secondo i termini della GPLv3 come pubblicata dalla Free Software Foundation. Vedi https://www.gnu.org/licenses/ per una copia di questa licenza.
Copyright (c) 2025 Proton Technologies AG
Scopri gli strumenti più utilizzati dalla nostra community.
Nessun dato di popolarità ancora.