بنيت Pocket Budget على مدى أربعة عشر درسًا. تخيّل الآن أنك ستغيّر CategoryBudget الشهر القادم لدعم ترحيل الرصيد بين الأشهر. كيف تعرف أن قاعدة تجاوز الحدّ ما زالت تعمل؟ يمكنك أن تنقر في التطبيق في كل مرة، أو أن تجعل الحاسوب يتحقّق منها في جزء من الثانية، مع كل تغيير، إلى الأبد. ثم، بعد أن يعمل، تحتاج إلى أشخاص حقيقيين يستخدمونه على هواتف حقيقية قبل أن تثق به في إطلاق على App Store.
Swift Testing هو إطار الاختبار من Apple، المدمج في Xcode 16 وما بعده. حين تنشئ مشروعًا، اختر Swift Testing كنظام الاختبار وسيضيف Xcode هدف اختبار (test target)؛ ولمشروع موجود، اختر File › New › Target › Unit Testing Bundle ثم اختر Swift Testing. اختبر منطق الميزانية من درس معالجة الأخطاء:
\nimport Testing\n@testable import PocketBudget\n\nstruct CategoryBudgetTests {\n @Test func recordingAnExpenseIncreasesSpent() throws {\n var food = CategoryBudget(limit: 300)\n try food.record(title: \"Groceries\", amount: 64.2)\n #expect(food.spent == 64.2)\n #expect(food.limit - food.spent == 235.8)\n }\n\n @Test(\"Going over the limit throws and leaves the budget unchanged\")\n func overLimitThrows() throws {\n var food = CategoryBudget(limit: 50)\n try food.record(title: \"Lunch\", amount: 12)\n\n #expect(throws: BudgetError.overLimit(by: 7)) {\n try food.record(title: \"Dinner\", amount: 45)\n }\n #expect(food.spent == 12)\n }\n}تعطي @testable import الاختبارات صلاحية الوصول إلى الأنواع الداخلية في تطبيقك. الاختبار هو أي دالة معلّمة بـ @Test؛ والنص الاختياري اسم مقروء يظهر في متصفّح الاختبارات. وتجميع الاختبارات في struct يجعله suite (مجموعة اختبارات)، ويحصل كل اختبار على instance جديد، فلا تستطيع الاختبارات تسريب state إلى بعضها.
يأخذ #expect تعبير Swift عاديًا. وحين يفشل، يتضمّن التقرير القيم الفعلية، مثل Expectation failed: (food.spent → 12) == 57، وهذا يخبرك في الغالب بما حدث قبل أن تفتح الـ debugger. أما #expect(throws:) فلا ينجح إلا إن رمى الـ closure ذلك الخطأ بالضبط. ولهذا يتوافق BudgetError مع Equatable منذ درس معالجة الأخطاء. شغّل كل شيء بـ Cmd-U، أو انقر على المعيّن بجانب اختبار واحد.
@Test func parsesValidAmount() throws {\n let amount = try #require(parseAmount(\"12.50\"))\n #expect(amount == 12.5)\n}\n\n@Test(arguments: [\"\", \"abc\", \"0\", \"-3\"])\nfunc rejectsInvalidAmounts(text: String) {\n #expect(parseAmount(text) == nil)\n}#require هو #expect مع زر إيقاف: إن فشل الشرط، ينتهي الاختبار عند ذلك السطر. وإن أعطيته optional، يفكّه، فيستخدم باقي الاختبار قيمة Decimal حقيقية. استخدمه للشروط المسبقة؛ واستخدم #expect للادّعاءات الفعلية، فيُبلغ التشغيل الواحد عن كل ادّعاء مكسور، لا عن الأول فقط.
يشغّل @Test(arguments:) الاختبار نفسه مرة لكل مُدخَل ويُبلغ عن كل حالة على حدة. أربعة مدخلات سيئة، ودالة واحدة، والفشل يخبرك بالضبط أيّ مُدخَل كسر الكود.
ابدأ حيث تؤذي الأخطاء المستخدمين وحيث تكون الاختبارات رخيصة: المنطق الخالص بلا واجهة. في Pocket Budget هذا يعني حسابات الميزانية، وتحليل المبالغ، وتحويل العملات، وانتقالات LoadState. تعمل هذه الاختبارات في أجزاء من الثانية ولا تتذبذب نتائجها أبدًا. وللكود الذي يحتاج SwiftData، أنشئ الـ container في الذاكرة من الدرس السابق داخل الاختبار، وعلّم الاختبار بـ @MainActor حين يلمس الـ context الرئيسي. اترك فحوصات الواجهة على مستوى البكسل لوقت لاحق؛ فالـ previews تكتشف معظم مشاكل التخطيط أسرع.
TestFlight هو طريقتك لإيصال نسخة إلى أجهزة iPhone الخاصة بأشخاص آخرين قبل الإطلاق. تحتاج إلى عضوية مدفوعة في Apple Developer Program وسجلّ للتطبيق في App Store Connect بمعرّف الحزمة (bundle identifier) نفسه الذي في مشروعك. ثم:
\nيثبّت المختبِرون تطبيق TestFlight المجاني، ويقبلون الدعوة، ويثبّتون نسختك التجريبية. ويستطيعون إرسال ملاحظات مع لقطات شاشة مباشرة من التطبيق، وستجد تقاريرهم، مع سجلّات الأعطال، في App Store Connect. وتبقى كل نسخة قابلة للاختبار 90 يومًا.
\n\nهذه هي الدورة الكاملة التي يمرّ بها مطوّر iOS المحترف كل أسبوع: صمّم البيانات بالأنواع، وابنِ الشاشات بـ SwiftUI، واجلب البيانات واحفظها بأمان تحت فحوصات الـ concurrency في Swift 6، وأثبت المنطق بالاختبارات، وضع النسخ بين أيدي المختبِرين. ومن هنا، من الخطوات التالية الجيدة إضافة رسوم بيانية للإنفاق حسب التصنيف باستخدام Swift Charts، والمزامنة مع iCloud عبر SwiftData، وتجهيز صفحة تطبيقك على App Store. لديك الأساسات اللازمة لكل ذلك.
\n","toc":[{"id":"sec-1","text":"Swift Testing في خمس دقائق","level":2},{"id":"sec-2","text":"#require والاختبارات ذات المعاملات","level":2},{"id":"sec-3","text":"ماذا تختبر أولًا","level":2},{"id":"sec-4","text":"إطلاق نسخة تجريبية عبر TestFlight","level":2}],"takeaways":["اختبارات Swift Testing دوال عادية معلّمة بـ@Test؛ و#expect يفحص شرطًا ويُبلغ عن القيم الفعلية حين يفشل.","#require يوقف الاختبار مبكرًا حين يفشل شرط مسبق، ويفكّ الـ optionals أيضًا فيعمل باقي الاختبار بقيم حقيقية.","#expect(throws:) يتحقّق من أن الكود يرمي خطأً محدّدًا، و@Test(arguments:) يشغّل اختبارًا واحدًا على مدخلات كثيرة.","اختبر المنطق الخالص أولًا، مثل الميزانيات والتحليل والتنسيق، لأنه سريع ومستقر ويحمل القواعد التي تهمّ المستخدمين أكثر.","يوزّع TestFlight النسخ على ما يصل إلى 100 مختبِر داخلي دون مراجعة، وعلى ما يصل إلى 10,000 مختبِر خارجي بعد Beta App Review."],"further":[{"title":"Swift Testing","url":"https://developer.apple.com/documentation/testing"},{"title":"TestFlight","url":"https://developer.apple.com/testflight/"},{"title":"Distributing your app for beta testing and releases","url":"https://developer.apple.com/documentation/xcode/distributing-your-app-for-beta-testing-and-releases"}],"quiz":[{"q":"يحتاج اختبار إلى مبلغ محلَّل قبل أن يستطيع فحص أي شيء آخر، وparseAmount تعيد Decimal?. أيّ سطر هو الأنسب؟
let amount = parseAmount("12.50")!","why":"الفكّ القسري يُسقط عملية الاختبارات كلها عند nil بدل أن يُفشل اختبارًا واحدًا برسالة واضحة."},{"text":"let amount = try #require(parseAmount("12.50"))","why":"صحيح. يفكّ القيمة، وإن كانت nil يتوقّف الاختبار عندها ويُسجَّل فاشلًا."},{"text":"#expect(parseAmount("12.50") != nil)، ثم تستخدم الـ optional.","why":"سيستمر الاختبار بعد الفشل، وسيضطر كل سطر لاحق إلى التعامل مع الـ optional."}],"answer":1},{"q":"فشل #expect(food.spent == 57). بماذا يُبلغ Swift Testing؟
#expect الفاشل يُسجَّل كمشكلة، فيفشل الاختبار رغم أنه يستمر في العمل."},{"text":"التعبير مع قيمته الفعلية، مثل (food.spent → 12) == 57.","why":"صحيح. رؤية القيمة الحقيقية تكشف لك الخطأ في الغالب دون debugger."}],"answer":2},{"q":"من يستطيع تثبيت نسخة TestFlight دون أن تمرّ بـ Beta App Review؟
","options":[{"text":"المختبِرون الداخليون، وهم أعضاء فريقك في App Store Connect.","why":"صحيح. الاختبار الداخلي موجود للتكرار السريع داخل الفريق."},{"text":"أي شخص يفتح الرابط العام الخاص بك.","why":"الروابط العامة مخصّصة للمختبِرين الخارجيين، الذين تحتاج نسخهم إلى Beta App Review أولًا."},{"text":"المختبِرون الخارجيون الذين تدعوهم بالبريد الإلكتروني.","why":"المختبِرون الخارجيون، أيًّا كانت طريقة دعوتهم، يحتاجون إلى نسخة اعتمدتها Beta App Review."}],"answer":0}],"exercise":{"kind":"fill","language":"swift","template":"import Testing\n@testable import PocketBudget\n\nstruct ParsingTests {\n @{{0}} func parsesValidAmount() throws {\n let amount = try {{1}}(parseAmount(\"12.50\"))\n {{2}}(amount == 12.5)\n }\n\n @Test({{3}}: [\"\", \"abc\", \"0\", \"-3\"])\n func rejectsInvalidAmounts(text: String) {\n #expect(parseAmount(text) == nil)\n }\n}","blanks":[{"answers":["Test"]},{"answers":["#require"]},{"answers":["#expect"]},{"answers":["arguments"]}],"title":"اختبر محلّل المبالغ","prompt":"اكتب اختبارات Swift Testing للدالة parseAmount(_:)، التي تعيد Decimal موجبًا أو nil. يجب أن يفكّ الاختبار الأول القيمة المحلَّلة ويتوقّف إن كانت nil، ثم يتحقّق من أنها تساوي 12.5. ويجب أن يعمل الاختبار الثاني مرة لكل مُدخَل غير صالح.
nil؛ ويُستخدم مع try.","الماكرو الآخر يسجّل الفشل لكنه يترك الاختبار يستمر. وللفراغ الأخير، انظر إلى المعامل الذي يستقبله الاختبار الثاني."],"explanation":"تعلّم @Test دالة اختبار. ويفكّ try #require(parseAmount("12.50")) الـ optional، وإن أعاد التحليل nil يتوقّف الاختبار بفشل واضح بدل أن يتعطّل. ثم يتحقّق #expect(amount == 12.5) من النتيجة، وعند الفشل يُبلغ عن القيمة الفعلية. أما @Test(arguments:) فيشغّل rejectsInvalidAmounts مرة لكل نص، ويظهر كل مُدخَل كحالة اختبار مستقلّة، فيسمّي الفشل المُدخَل الذي كسر الكود بالضبط.
@Test func parsesValidAmount() throws {\n let amount = try #require(parseAmount(\"12.50\"))\n #expect(amount == 12.5)\n}