جدول المحتويات

1. بدء الاستخدام
2. المتطلبات
3. المكونات
4. الاختبار والتطوير
5. التوقيع
6. البناء
7. المشكلات/الأخطاء/الميزات
8. استكشاف الأخطاء وإصلاحها
9. المهام المتبقية

بدء الاستخدام

قدمت Apple بعض آليات الأمان الجديدة التي نحتاج إلى تفعيلها لتشغيل Crescendo.

1. تأكد من نقل التطبيق إلى مجلد /Applications لديك وإلا سيفشل تحميل امتداد النظام.

2. في التشغيل الأول، سيُطلب منك الموافقة على امتداد النظام بعد النقر على زر 'بدء'.

   ملاحظة: لاحظت وجود مشكلة حيث لا تظهر تفضيلات النظام زر السماح. أفترض أن هذه مشكلة داخلية تحتاج Apple إلى حلها. النقر للعودة إلى تفضيلات النظام ثم التصفح للأمام مرة أخرى يبدو أنه يحل المشكلة.

   

3. ستحتاج إلى تمكين الوصول الكامل للقرص لامتداد النظام.

   

المتطلبات

Crescendo متوافق فقط مع >=10.15.X و Xcode 10 على الأقل.

المكونات

يتكون هذا المشروع من ثلاثة مكونات رئيسية:

1. امتداد نظام (CrescendoExtension)
2. إطار عمل (Framework) يغلف إطار أمان نقطة النهاية (Crescendo)
3. تطبيق لعرض الأحداث في واجهة مستخدم صغيرة لطيفة (CrescendoApp)

الاختبار والتطوير

يُوصى بشدة اختبار هذا الكود في جهاز افتراضي مع تعطيل SIP، نظرًا لأن هذا المشروع يتطلب صلاحية endpoint-security و TCC والتوقيع المناسب عند تمكين SIP.

1. التمهيد إلى وضع الاسترداد على macOS
2. تعطيل SIP و AMFI

csrutil disable
nvram boot-args="amfi_get_out_of_my_way=0x1"

3. إعادة التشغيل
4. تمكين وضع المطور بحيث يتم إعادة تحميل امتداداتنا في كل مرة نستدعي فيها OSSystemExtensionManager.shared.submitRequest

systemextensionsctl developer on

التوقيع

إذا كنت ترغب في توقيع تطبيقك الخاص، فمن المستحسن بشدة قراءة وثائق Apple حول متطلبات امتداد النظام و التوثيق.

التوقيع والصلاحيات مهمة غير تافهة.

البناء

لقد أدرجت ملف .xproj الخاص بي في هذا الإصدار لبدء المستخدمين. في المستقبل، من المحتمل أن أنتقل إلى استخدام ملف xcconfig الجديد حيث يبدو هذا نهجًا أكثر منطقية بدلاً من الالتزام بملفات xproj. إذا كنت ترغب ببساطة في بناء تطبيق cli المثال، يمكنك القيام بذلك باستخدام Xcode.

من أجل بناء هذا التطبيق وتشغيله على نظام macOS إنتاجي، ستحتاج إلى صلاحية endpoint-security وشهادة مطور من Apple.

يمكن تجميع إطار عمل Crescendo بسهولة مع أي تطبيق Swift. قد أنتقل إلى CocoaPods في المستقبل، لكنني غير معتاد عليها الآن.

المشكلات/الأخطاء/الميزات

لا تتردد في فتح مشكلة إذا كنت ترغب في رؤية ميزة مضافة أو واجهت مشكلة. إذا كنت ترغب في المساهمة بطلب سحب، يرجى التأكد من تشغيل swiftlint على الكود الخاص بك قبل المساهمة.

سأقوم بإنشاء إصدارات للتطبيق المترجم + الموقع وتضمينها في علامة التبويب 'الإصدارات' حسب الحاجة.

استكشاف الأخطاء وإصلاحها

• إذا كنت تعمل على Mac إنتاجي، فيجب عليك عدم تعطيل SIP أو AMFI. هذه التعليمات للمطورين الراغبين في إجراء تغييرات على الكود.

• هل قمت بتمكين امتداد النظام بالنقر على زر 'السماح' في تفضيلات النظام -> الأمان والخصوصية؟ إذا لم تفعل، فلن ترى أي أحداث.

• هل قمت بتمكين الوصول الكامل للقرص في تفضيلات النظام -> الأمان والخصوصية -> علامة التبويب الخصوصية؟ إذا لم تفعل، فلن ترى أي أحداث.

• إذا واجهت أي مشكلات، افتح Console.app وابحث عن crescendo أو <your_bundle_id>/com.suprhackersteve كمرشح، يجب أن يساعدك ذلك في استكشاف أي مشكلات محتملة. من الجيد أيضًا التحقق في CrashReporter ومعرفة ما إذا كان الامتداد قد تعطل أو خرج مع fatalError.

• إذا كنت ترغب في تفريغ امتداد النظام بالقوة، يوجد عنصر قائمة باسم 'تفريغ امتداد النظام' الذي سيقوم بتفريغه. قد يؤدي هذا الإجراء إلى آثار جانبية غريبة، افعل ذلك فقط إذا كنت تعرف ما تفعله.

• إذا أضفت عملية إلى القائمة السوداء وما زالت مسموح لها بالتنفيذ، تذكر التحقق من المسار الكامل الحقيقي. استخدام /Applications/Foo.app ببساطة لن يكون كافيًا لمنع التنفيذ. أيضًا، يتم تشغيل العديد من تطبيقات macOS عبر xpcproxy.

المهام المتبقية

1. اختبارات الوحدة (بحاجة إلى إيجاد طريقة معقولة لتشغيلها)
2. أحداث الشبكة (متابعة في هذه المشكلة)
3. دعم أفضل للتصفية والبحث في بيانات الأحداث
4. اختيار نظام تغليف للإطار (Cocoapods, Swift Package Manager, إلخ)
5. محاولة توزيع امتداد النظام بمفرده باستخدام صلاحية إعادة التوزيع الجديدة؟