
iOS और macOS के लिए आधिकारिक VPN क्लाइंट जो एन्क्रिप्टेड टनलिंग, सुरक्षित क्रेडेंशियल स्टोरेज, स्वचालित सर्वर कॉन्फ़िगरेशन और लोकप्रिय VPN प्रोटोकॉल के लिए समर्थन प्रदान करता है।
Copyright (c) 2025 Proton Technologies AG
यह प्रोजेक्ट अपनी सभी निर्भरताओं के लिए Swift Package Manager का उपयोग करता है। किसी भी लक्ष्य को चलाने से पहले Xcode को पैकेजों को हल करने दें।
हल किए गए संस्करण ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved में दर्ज किए गए हैं। Proton का अपना
साझा कोड external/ के अंतर्गत git सबमॉड्यूल के रूप में vendored है, और वर्कस्पेस के हल होने से पहले उन्हें
आरंभ किया जाना चाहिए।
सबसे तेज़ तरीका रिपॉज़िटरी रूट से ./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 पर, लिंटिंग सख्त होती है और किसी भी चेतावनी पर विफल हो जाएगी। इस रिपॉज़िटरी में कोड कमिट करने से पहले निम्नलिखित स्क्रिप्ट चलाएं ताकि एक pre-commit हुक जोड़ा जा सके जो सभी नए/संशोधित फ़ाइलों को सख्त मोड में जांचेगा और आपको ऐसा कोड कमिट करने से रोकेगा जो CI से पास नहीं होगा।
./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