
Cliente VPN oficial para iOS y macOS que proporciona túneles cifrados, almacenamiento seguro de credenciales, configuración automatizada del servidor y soporte para protocolos VPN populares.
Copyright (c) 2025 Proton Technologies AG
Este proyecto utiliza Swift Package Manager para todas sus dependencias. Permite que Xcode resuelva los paquetes antes de ejecutar cualquier target.
Las versiones resueltas se registran en ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved. El código compartido propio de Proton está incluido como submódulos de git bajo external/, y estos deben inicializarse antes de que el workspace pueda resolverse.
La ruta más rápida es ./Integration/Scripts/bootstrap.sh desde la raíz del repositorio, que instala las dependencias de Homebrew, clona y enlaza el repositorio de credenciales, inicializa los submódulos e instala el hook de pre-commit. Los pasos a continuación son lo que hace, además de lo que no puede hacer por ti.
git submodule init + git submodule update)brew bundleCmd+Shift+K)Se requiere un conjunto de secretos para poder compilar el proyecto.
Estos incluyen URLs y claves, y se guardan en archivos llamados ObfuscatedConstants.swift.
Estos archivos se guardan en un repositorio separado, que requiere una configuración adicional para mantenerse sincronizado.
En primer lugar, invoca el script ubicado en Integration/Scripts/credentials.sh con el comando setup.
Proporciona la ruta donde deseas que se clone localmente el repositorio de secretos usando el argumento -p, y la url del repositorio usando el argumento -r.
./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>
A continuación, para verificar que la configuración se ha realizado correctamente:
./Integration/Scripts/credentials.sh checkout
Si la configuración es correcta, las constantes ofuscadas se sincronizarán automáticamente durante la fase de compilación Generate Obfuscated Constants de cada aplicación.
El proyecto está empaquetado por capas para evitar el infierno de dependencias entre módulos:
Debe evitarse, en la medida de lo posible, añadir código o funcionalidades nuevas a LegacyCommon y NEHelper. Estos paquetes deben ir reduciéndose gradualmente para colocar sus componentes en paquetes nuevos o existentes de las tres categorías anteriores.
Durante el desarrollo, swiftlint se ejecuta en modo no estricto para que sea más fácil desarrollar sin preocuparse por el formato del código. En CI, el linting es estricto y fallará ante cualquier advertencia. Antes de confirmar código en este repositorio, ejecuta el siguiente script para añadir un hook de pre-commit que comprobará todos los archivos nuevos o modificados en modo estricto y te impedirá confirmar código que no pasará el CI.
./Integration/Scripts/pre_commit_lint.sh setup
La aplicación usa SwiftGen para generar accesores con seguridad de tipos para las cadenas del paquete Strings. Añade una nueva cadena solo al archivo Localizable.strings en inglés, luego ejecuta swiftgen desde libraries/Foundations/Strings y confirma el Strings.swift regenerado. Todos los demás idiomas provienen de Crowdin y no deben editarse manualmente.
Ten en cuenta que los nombres de funcionalidades no publicadas se incluyen como marcadores de posición, como $HERMES, y un paso de compilación los sustituye en tiempo de compilación usando las asignaciones de libraries/Foundations/Strings/Codewords.strings.env. Usa un marcador de posición en lugar del nombre real al añadir una cadena de este tipo.
El código y los archivos de datos de esta distribución están licenciados bajo los términos de la GPLv3 tal como la publica la Free Software Foundation. Consulta https://www.gnu.org/licenses/ para obtener una copia de esta licencia.
Copyright (c) 2025 Proton Technologies AG