عن المشروع
تطبيق كيك ستارتر لنظام iOS هو الإصدار الرسمي مفتوح المصدر لتطبيق كيك ستارتر الأصلي لنظام iOS، شاركته الشركة كمورد تعليمي حول كيفية بناء فريقها الأصلي للتطبيق وصيانته. كما تم إتاحة نظير التطبيق لنظام أندرويد كمصدر مفتوح بشكل منفصل.
يتطلب البدء وجود Xcode (تشير ملف README إلى دعم Xcode 14.3 / Swift 5.8) واستنساخ المستودع. يؤدي ضبط `KsApi.Secrets.isOSS` على `true` إلى توفير نسخة وهمية تقدّم بيانات مُضمّنة مسبقًا على الفور، بحيث يمكن استكشاف التطبيق دون بيانات اعتماد خادم حية.
ممارسات هندسية ملحوظة موصوفة في README:
- اختبارات اللقطات: يحتوي كل مجلد ميزة في `Kickstarter-Framework-iOS` على مجلد لقطات، وتضم معًا ما يقرب من 600 لقطة شاشة تغطي العديد من اللغات والأجهزة وحالات الحواف، وتُستخدم للحفاظ على استقرار سلوك واجهة المستخدم.
- نماذج العرض: تُستخدم كطريقة خفيفة لعزل الآثار الجانبية حول نواة وظيفية، مكتوبة كتعيينات خالصة لإشارات الإدخال إلى إشارات الإخراج، مع اختبارات مكثفة تشمل الترجمة وإمكانية الوصول وتتبع الأحداث.
يمكن تشغيل الاختبارات من سطر الأوامر باستخدام `make test-all`، أو لكل مخطط في Xcode باستخدام CMD+U. توجد وثائق إضافية في مستودع `native-docs` المنفصل.
تشمل التبعيات مكتبات الطرف الأول Prelude (أنواع ودوال مفقودة من مكتبة Swift القياسية) وReactiveExtensions (عوامل مضافة إلى ReactiveCocoa، مبنية على ReactiveSwift)، بالإضافة إلى مشاريع طرف ثالث مثل AlamofireImage وSnapshotTesting وApollo وStripe وKingfisher وSwiftSoup وFacebook SDK وFirebase وAppboy وPerimeterX. توجد إشعارات الطرف الثالث في `NOTICE.md`.
تُرحّب المساهمات بشكل أساسي كقضايا على GitHub لتقديم الملاحظات وتقارير الأخطاء، مع تعليمات لتضمين نظام التشغيل والجهاز ورقم الإصدار وخطوات إعادة الإنتاج. تنطبق مدونة سلوك على جميع المشاركين. المشروع مرخّص بموجب رخصة أباتشي 2.0، حقوق النشر 2021 Kickstarter, PBC.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.