
iOS 및 macOS용 공식 VPN 클라이언트로, 암호화된 터널링, 안전한 자격 증명 저장, 자동 서버 구성, 그리고 널리 사용되는 VPN 프로토콜 지원을 제공합니다.
Copyright (c) 2025 Proton Technologies AG
이 프로젝트는 모든 종속성에 Swift Package Manager를 사용합니다. 모든 타겟을 실행하기 전에 Xcode가 패키지를 해결하도록 허용하세요.
해결된 버전은 ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved에 기록됩니다. Proton의 자체
공유 코드는 external/ 아래에 git 서브모듈로 벤더링되어 있으며, 워크스페이스가 해결되기 전에
이들을 초기화해야 합니다.
가장 빠른 방법은 저장소 루트에서 ./Integration/Scripts/bootstrap.sh를 실행하는 것으로, 이 스크립트는
Homebrew 종속성을 설치하고, 자격 증명 저장소를 복제 및 링크하며, 서브모듈을 초기화하고,
pre-commit 훅을 설치합니다. 아래 단계는 이 스크립트가 수행하는 작업과, 스크립트가 대신 해줄 수 없는 작업을 설명합니다.
git submodule init + git submodule update)brew bundle로 Homebrew 종속성을 설치하세요Cmd+Shift+K)프로젝트를 빌드하려면 일련의 비밀 값이 필요합니다.
여기에는 URL과 키가 포함되며, ObfuscatedConstants.swift라는 파일에 보관됩니다.
이 파일들은 별도의 저장소에 보관되며, 동기화를 유지하려면 추가 설정이 필요합니다.
먼저 Integration/Scripts/credentials.sh에 있는 스크립트를 setup 명령으로 실행하세요.
-p 인수로 비밀 저장소를 로컬에 복제할 경로를, -r 인수로 저장소의 URL을 제공하세요.
./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>
그런 다음 설정이 성공했는지 확인하려면:
./Integration/Scripts/credentials.sh checkout
올바르게 설정되었다면, 각 앱의 Generate Obfuscated Constants 빌드 단계에서 난독화된 상수가 자동으로 동기화됩니다.
이 프로젝트는 모듈 의존성 지옥을 피하기 위해 계층별로 패키징됩니다:
가능하면 LegacyCommon 및 NEHelper에 새로운 코드/기능을 추가하는 것은 피해야 합니다. 이 패키지들은 해당 구성 요소를 위의 세 범주에 있는 새/기존 패키지로 배치하기 위해 점진적으로 축소되어야 합니다.
개발 중에는 swiftlint가 비엄격 모드로 실행되므로 코드 서식에 신경 쓰지 않고 더 쉽게 개발할 수 있습니다. CI에서는 린팅이 엄격하게 적용되며 경고가 있으면 실패합니다. 이 저장소에 코드를 커밋하기 전에 다음 스크립트를 실행하여 엄격 모드에서 모든 새/수정된 파일을 검사하고 CI를 통과하지 못할 코드를 커밋하지 못하도록 하는 pre-commit 훅을 추가하세요.
./Integration/Scripts/pre_commit_lint.sh setup
앱은 Strings 패키지의 문자열에 대한 타입 안전 접근자를 생성하기 위해 SwiftGen을 사용합니다. 영어 Localizable.strings에만 새 문자열을 추가한 다음 libraries/Foundations/Strings에서 swiftgen을 실행하고 재생성된 Strings.swift를 커밋하세요. 다른 모든 언어는 Crowdin에서 제공되며 수동으로 편집해서는 안 됩니다.
출시되지 않은 기능의 이름은 $HERMES와 같은 자리 표시자로 체크인되며, 빌드 단계에서 libraries/Foundations/Strings/Codewords.strings.env의 매핑을 사용하여 빌드 시점에 대체됩니다. 이러한 문자열을 추가할 때 실제 이름 대신 자리 표시자를 사용하세요.
이 배포판의 코드 및 데이터 파일은 Free Software Foundation에서 발행한 GPLv3의 조건에 따라 라이선스가 부여됩니다. 이 라이선스의 사본은 https://www.gnu.org/licenses/에서 확인하세요.
Copyright (c) 2025 Proton Technologies AG