Swift Academy · درس

أساسيات SwiftFormat وSwiftLint

أعِد إعداد SwiftFormat لتنسيق الشيفرة تلقائيًا و SwiftLint لاكتشاف مشكلات الأسلوب. شغّلهما محليًا وفي CI باستخدام قواعد بسيطة ملائمة للمبتدئين.

الدرس 1 من 38 خطوة

أساسيات SwiftFormat وSwiftLint درس مجاني في Swift Academy على CoddyKit. هذا هو الدرس 1 من أصل 3. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Swift Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Swift Academy 3 دروس في المجموع.

لماذا التنسيق والفحص؟

الهدف: الحفاظ على اتساق الشيفرة وسهولة قراءتها.

  • SwiftFormat → تنسيق المصدر تلقائيًا
  • SwiftLint → الإبلاغ عن مشكلات الأسلوب
  • تشغيل الأداتين محليًا وفي CI للحفاظ على جودة ثابتة

SwiftFormat: البدء

يعيد SwiftFormat كتابة الملفات بأسلوب موحّد. احتفظ بملف .swiftformat في المستودع وشغّله قبل عمليات الإيداع.

// Install & run (examples):
//   mint install nicklockwood/SwiftFormat     // via Mint
//   swiftformat .                             // format repo
//   swiftformat Sources --config .swiftformat // use config file
//
// Minimal .swiftformat (put in repo root):
// --ifdef no
// --wrapcollections before-first
// --maxwidth 100
print("SwiftFormat: run to auto-format code consistently")

SwiftLint: الأساسيات

يحلّل SwiftLint الملفات ويُبلغ عن المخالفات. اضبط القواعد في .swiftlint.yml، واجعل الحدود مناسبة للمبتدئين.

// Install & run (examples):
//   brew install swiftlint         // macOS example
//   swiftlint lint                 // check whole repo
//   swiftlint lint --strict        // fail on warnings in CI
//
// Minimal .swiftlint.yml (example):
// disabled_rules:
//   - trailing_whitespace
// opt_in_rules:
//   - empty_count
// line_length: 100
// identifier_name:
//   min_length: 3
print("SwiftLint: report style issues with configurable rules")

من المخالفة إلى الشيفرة النظيفة

يُصلح التنسيق المسافات وفواصل الأسطر، بينما تدفع قواعد الفحص إلى تحسين الأسماء والاستخدام. واجعل الأمثلة صغيرة كي يرى المبتدئون الفرق.

// BEFORE (bad spacing, short name, unused let)
//let x=1
//print(  "Hi"  )
//
// AFTER (formatted & lint-friendly):
let count = 1
print("Hi")
print("count =", count)

سير عمل الأتمتة

أتمت الأداتين: شغّلهما محليًا قبل الإيداع، وفي CI استخدم --strict لمنع التراجعات.

// Simple pre-commit idea (document in README):
//   swiftformat . && swiftlint lint --strict
//
// GitHub Actions (sketch) — put in CI config, not here:
//   - run: swiftformat --version && swiftformat .
//   - run: swiftlint lint --strict
//
// Tip: start lenient (warnings), then turn strict in CI once the repo is clean.
print("Automate: run format+lint locally and in CI")

قواعد بداية جيدة

إعدادات افتراضية مناسبة للمبتدئين:

  • line_length: 100
  • identifier_name.min_length: 3
  • السماح بـ فواصل لاحقة بسيطة
  • تعطيل بعض القواعد المزعجة في البداية (ثم تفعيلها لاحقًا)

المنسّق مقابل أداة الفحص

تحقق سريع: أي أداة تنسّق الشيفرة تلقائيًا؟

مراجعة

مراجعة: استخدم SwiftFormat لكتابة مصدر نظيف ومتسق، واستخدم SwiftLint لفرض قواعد الأسلوب. اجعل الإعدادات بسيطة، وشغّل الأدوات محليًا، واجعل CI يوقف التراجعات باستخدام --strict.

البدء مجانًا

تعلم Swift مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات
122
الدروس
409

الأسئلة الشائعة

هل درس «أساسيات SwiftFormat وSwiftLint» مجاني؟

نعم — نص درس «أساسيات SwiftFormat وSwiftLint» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Swift Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Swift Academy 3 دروس في المجموع.

ماذا ستتعلم في «أساسيات SwiftFormat وSwiftLint»؟

أعِد إعداد SwiftFormat لتنسيق الشيفرة تلقائيًا و SwiftLint لاكتشاف مشكلات الأسلوب. شغّلهما محليًا وفي CI باستخدام قواعد بسيطة ملائمة للمبتدئين. تتمرن على Swift Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Swift Academy؟

لا تُشترط خبرة سابقة. Swift Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 3.

كم من الوقت يستغرق درس «أساسيات SwiftFormat وSwiftLint»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Swift Academy هذا؟

نعم. كل درس في Swift Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. أساسيات SwiftFormat وSwiftLint
  2. دليل الأسلوب وإرشادات تصميم واجهات البرمجة
  3. توثيق الشيفرة (مقدمة إلى DocC)
← العودة إلى Swift Academy