
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 引数で、リポジトリの URL を -r 引数で指定してください。
./Integration/Scripts/credentials.sh setup -p <path to credentials repo> -r <credentials remote>
次に、セットアップが成功したことを確認するには:
./Integration/Scripts/credentials.sh checkout
セットアップが正しく行われていれば、難読化された定数は各アプリの Generate Obfuscated Constants ビルドフェーズ中に自動的に同期されます。
このプロジェクトは、モジュール依存関係の地獄を避けるためにレイヤーごとにパッケージ化されています:
LegacyCommon および NEHelper への新しいコード/機能の追加は、可能な限り避けるべきです。 これらのパッケージは、そのコンポーネントを上記の3つのカテゴリの新規/既存のパッケージに配置するために、徐々に削り取っていくべきです。
開発中は swiftlint が非厳格モードで実行されるため、コードフォーマットを気にせずに開発しやすくなっています。CI ではリンティングは厳格であり、警告があれば失敗します。このリポジトリにコードをコミットする前に、以下のスクリプトを実行して、新規/変更されたすべてのファイルを厳格モードでチェックし、CI を通過しないコードのコミットを防ぐ pre-commit フックを追加してください。
./Integration/Scripts/pre_commit_lint.sh setup
アプリは SwiftGen を使用して、Strings パッケージ内の文字列に対する型安全なアクセサを生成します。新しい文字列は英語の 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