
عميل VPN الرسمي لنظامي iOS وmacOS، يوفر نفقًا مشفّرًا، وتخزينًا آمنًا لبيانات الاعتماد، وتكوينًا تلقائيًا للخادم، ودعمًا لبروتوكولات VPN الشائعة.
حقوق النشر (c) 2025 Proton Technologies AG
يستخدم هذا المشروع Swift Package Manager لجميع تبعياته. اسمح لـ Xcode بحل الحزم قبل تشغيل أي هدف.
تُسجَّل الإصدارات المحلولة في ProtonVPN.xcworkspace/xcshareddata/swiftpm/Package.resolved. تُضمَّن الشيفرة المشتركة
الخاصة بـ Proton كوحدات فرعية git ضمن external/، ويجب تهيئتها قبل أن تتمكن
مساحة العمل من الحل.
أسرع طريق هو ./Integration/Scripts/bootstrap.sh من جذر المستودع، والذي يثبّت
تبعيات Homebrew، ويستنسخ مستودع بيانات الاعتماد ويربطه، ويهيّئ الوحدات الفرعية، ويثبّت
خطاف pre-commit. الخطوات أدناه هي ما يفعله، بالإضافة إلى ما لا يمكنه فعله نيابةً عنك.
git submodule init + git submodule update)brew bundleCmd+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 إن أمكن. ينبغي تقليص هذه الحزم تدريجيًا من أجل وضع مكوّناتها في حزم جديدة/قائمة ضمن الفئات الثلاث أعلاه.
أثناء التطوير يتم تشغيل swiftlint في الوضع غير الصارم حتى يسهل التطوير دون القلق بشأن تنسيق الشيفرة. في CI، يكون الفحص صارمًا وسيفشل عند أي تحذير. قبل إيداع الشيفرة في هذا المستودع، شغّل السكربت التالي لإضافة خطاف pre-commit يفحص جميع الملفات الجديدة/المعدّلة في الوضع الصارم ويمنعك من إيداع شيفرة لن تجتاز CI.
./Integration/Scripts/pre_commit_lint.sh setup
يستخدم التطبيق SwiftGen لإنشاء وصولات آمنة النوع (type-safe) إلى النصوص في حزمة Strings. أضف نصًا جديدًا إلى ملف Localizable.strings الإنجليزي فقط، ثم شغّل swiftgen من libraries/Foundations/Strings وأودِع ملف Strings.swift المُعاد إنشاؤه. تأتي جميع اللغات الأخرى من Crowdin ويجب ألا تُحرَّر يدويًا.
لاحظ أن أسماء الميزات غير المُصدَرة تُودَع كعناصر نائبة مثل $HERMES، وتستبدلها خطوة بناء وقت البناء باستخدام التعيينات في libraries/Foundations/Strings/Codewords.strings.env. استخدم عنصرًا نائبًا بدلًا من الاسم الحقيقي عند إضافة نص من هذا القبيل.
شيفرة وملفات بيانات هذا التوزيع مرخّصة بموجب شروط GPLv3 كما نشرتها مؤسسة البرمجيات الحرة. راجع https://www.gnu.org/licenses/ للحصول على نسخة من هذا الترخيص.
حقوق النشر (c) 2025 Proton Technologies AG