Proton VPN لنظامي iOS وmacOS

حقوق النشر (c) 2025 Proton Technologies AG

الاعتماديات

يستخدم هذا المشروع Swift Package Manager لجميع اعتمادياته. اسمح لبرنامج Xcode بحل الحزم قبل تشغيل أي هدف.

اعتماديات الجهات الخارجية

ACKNOWLEDGEMENTS.md

الإعداد

• فعّل Git LFS على جهازك
• استنسخ هذا المستودع
• تأكد من استنساخ الوحدات الفرعية (git submodule init + git submodule update)
• ثبّت اعتماديات Homebrew باستخدام brew bundle
• ستلزمك Xcode 14.x في الوقت الحالي
• قم بإعداد توقيع الكود لجميع الأهداف باستخدام حساب مطوّر Apple مدفوع (مطلوب بسبب صلاحيات VPN) وغيّر معرّفات الحزمة إلى قيم فريدة
• نظّف مجلد البناء في Xcode (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 في كل تطبيق.

بنية الحزم

يتم تقسيم المشروع إلى حزم حسب الطبقة لتجنب جحيم تبعيات الوحدات:

• Foundations: مكتبات صغيرة أحادية الغرض لبناء أشياء أكبر. يجب ألا ترتبط هذه المكتبات إلا ببعضها البعض فقط، إذا ارتبطت بأي شيء إطلاقًا.
• Shared: مكتبات أكبر قليلًا تهدف إلى مشاركة الكود بين التطبيقات أو الامتدادات. يمكن فصل الأجزاء من هذه المكتبة التي تكبر كثيرًا أو التي قد تستفيد من كونها وحدة مستقلة إلى Foundations. يجب ألا ترتبط هذه المكتبات إلا بمكتبات Foundations فقط، مع استثناء محتمل حيث ترتبط كل من هذه المكتبات بـ CoreCommon.
• Features: مكتبات قائمة بذاتها تحتوي على ميزة واحدة. يجب ألا ترتبط هذه المكتبات إلا بمكتبات من فئتي Shared أو Foundations فقط. يتم تضمينها وإنشاء مثيلات منها داخل كود التطبيق أو الاختبار أو الامتداد.

يجب تجنب إضافة كود/ميزات جديدة إلى LegacyCommon وNEHelper إن أمكن. يجب تفكيك هذه الحزم تدريجيًا من أجل وضع مكوناتها في حزم جديدة أو موجودة ضمن الفئات الثلاث المذكورة أعلاه.

فحص الكود

أثناء التطوير، يتم تشغيل swiftlint في الوضع غير الصارم لتسهيل التطوير دون القلق بشأن تنسيق الكود. في بيئة CI، يكون الفحص صارمًا وسيفشل عند أي تحذير. قبل إيداع الكود في هذا المستودع، قم بتشغيل البرنامج النصي التالي لإضافة خطاف pre-commit الذي سيتحقق من جميع الملفات الجديدة أو المعدّلة في الوضع الصارم ويمنعك من إيداع الكود الذي لن يجتاز CI.

./Integration/Scripts/pre_commit_lint.sh setup

التوطين

يستخدم التطبيق SwiftGen لإنشاء ملف Localizable.strings للوصول إلى جميع نصوص التطبيق المخزنة في ملفات Localizable.strings القياسية. فقط أضف نصًا جديدًا إلى حزمة Strings وشغّل أمر swiftgen في دليل يحتوي على swiftgen.yml.

الترخيص

الكود وملفات البيانات في هذا التوزيع مرخصة بموجب شروط GPLv3 كما نشرتها مؤسسة البرمجيات الحرة. راجع https://www.gnu.org/licenses/ للحصول على نسخة من هذا الترخيص.

حقوق النشر (c) 2025 Proton Technologies AG