
Cliente VPN oficial para iOS e macOS que fornece tunelamento criptografado, armazenamento seguro de credenciais, configuração automatizada de servidor e suporte aos protocolos VPN mais populares.
Copyright (c) 2025 Proton Technologies AG
Este projeto utiliza o Swift Package Manager para todas as suas dependências. Permita que o Xcode resolva os pacotes antes de executar qualquer target.
As versões resolvidas são registradas em ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved. O código compartilhado da própria Proton é fornecido como submódulos git em external/, e estes devem ser inicializados antes que o workspace possa ser resolvido.
O caminho mais rápido é ./Integration/Scripts/bootstrap.sh a partir da raiz do repositório, que instala as dependências do Homebrew, clona e vincula o repositório de credenciais, inicializa os submódulos e instala o hook de pre-commit. As etapas abaixo são o que ele faz, além do que ele não pode fazer por você.
git submodule init + git submodule update)brew bundleCmd+Shift+K)Um conjunto de segredos é necessário para compilar o projeto.
Estes incluem URLs e chaves, e são mantidos em arquivos chamados ObfuscatedConstants.swift.
Esses arquivos são mantidos em um repositório separado, o que requer alguma configuração adicional para se manter sincronizado.
Primeiramente, invoque o script localizado em Integration/Scripts/credentials.sh com o comando setup.
Forneça o caminho onde você deseja que o repositório de segredos seja clonado localmente usando o argumento -p, e a url do repositório usando o argumento -r.
./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>
Em seguida, para verificar se a configuração foi bem-sucedida:
./Integration/Scripts/credentials.sh checkout
Se configurado corretamente, as constantes ofuscadas serão sincronizadas automaticamente durante a fase de build Generate Obfuscated Constants de cada app.
O projeto é empacotado por camadas para evitar o inferno de dependências entre módulos:
Adicionar novo código/funcionalidade a LegacyCommon e NEHelper deve ser evitado se possível. Estes pacotes devem ser gradualmente reduzidos para colocar seus componentes em pacotes novos/existentes nas três categorias acima.
Durante o desenvolvimento, o swiftlint é executado em modo não estrito para facilitar o desenvolvimento sem se preocupar com formatação de código. No CI, o linting é estrito e falhará em qualquer aviso. Antes de commitar código neste repositório, execute o seguinte script para adicionar um hook de pré-commit que verificará todos os arquivos novos/modificados em modo estrito e impedirá que você faça commit de código que não passará no CI.
./Integration/Scripts/pre_commit_lint.sh setup
O app usa SwiftGen para gerar acessadores type-safe para as strings no pacote Strings. Adicione uma nova string apenas ao Localizable.strings em inglês, depois execute swiftgen a partir de libraries/Foundations/Strings e faça commit do Strings.swift regenerado. Todos os outros idiomas vêm do Crowdin e não devem ser editados manualmente.
Observe que nomes de funcionalidades não lançadas são incluídos como placeholders, como $HERMES, e uma etapa de build os substitui no momento do build usando os mapeamentos em libraries/Foundations/Strings/Codewords.strings.env. Use um placeholder em vez do nome real ao adicionar tal string.
O código e os arquivos de dados nesta distribuição estão licenciados sob os termos da GPLv3 conforme publicada pela Free Software Foundation. Consulte https://www.gnu.org/licenses/ para obter uma cópia desta licença.
Copyright (c) 2025 Proton Technologies AG