SwiftLint Swift: طرق، أمثلة، تثبيت

1. ما هو SwiftLint ولماذا تحتاجه؟

SwiftLint هو أداة تحليل ثابت للكود (linter) للغة البرمجة Swift. يقوم تلقائيًا بفحص الكود الخاص بك للتأكد من توافقه مع مجموعة من القواعد المستندة إلى دليل أسلوب Swift (توصيات أسلوب الكود من شركة Apple) وأفضل الممارسات المجتمعية. تخيل أن لديك "مراجعًا ذكيًا" يعمل في الوقت الفعلي مباشرة داخل محرر الكود الخاص بك، ويقوم بتسليط الضوء على المشكلات المحتملة، ومخالفات التنسيق، والأخطاء المنطقية.

لماذا تحتاجه؟ في المشاريع الكبيرة، حيث يعمل عشرات المطورين على قاعدة كود واحدة، يصبح الحفاظ على أسلوب كود موحد مهمة بالغة الأهمية. يحل SwiftLint هذه المشكلة تلقائيًا. فهو لا يساعد فقط في كتابة كود أنظف وأكثر قابلية للقراءة، بل يمنع أيضًا ظهور العديد من الأخطاء الشائعة في المراحل المبكرة. على سبيل المثال، يمكنه تحذيرك من استخدام واجهات برمجة تطبيقات قديمة (deprecated)، أو من الدوال المعقدة جدًا التي يصعب اختبارها، أو من تنسيق المسافات البادئة غير الصحيح.

دمج SwiftLint في عملية التطوير (CI/CD) يسمح برفض طلبات السحب (Pull Requests) التي لا تتوافق مع معايير الجودة تلقائيًا، مما يوفر الوقت في مراجعة الكود ويزيد من استقرار المشروع بشكل عام. إنها أداة أساسية لأي فريق محترف من مطوري iOS/macOS.

2. التثبيت

يمكن تثبيت SwiftLint بعدة طرق. الطريقة الأكثر شيوعًا والموصى بها هي عبر Homebrew (مدير الحزم لنظام macOS).

الطريقة 1: Homebrew (موصى بها)

افتح الطرفية (Terminal) ونفذ الأمر التالي:

brew install swiftlint

الطريقة 2: CocoaPods

إذا كنت تستخدم CocoaPods، أضف السطر التالي إلى ملف Podfile الخاص بك:

pod 'SwiftLint'

ثم نفذ:

pod install

الطريقة 3: Swift Package Manager (SPM)

أضف الحزمة إلى ملف Package.swift الخاص بك:

dependencies: [
    .package(url: "https://github.com/realm/SwiftLint.git", from: "0.54.0")
]

الطريقة 4: Mint

إذا كنت تستخدم Mint:

mint install realm/SwiftLint

3. البداية السريعة: مثال عملي بسيط

بعد التثبيت، أبسط طريقة لاختبار عمل SwiftLint هي تشغيله من الطرفية في المجلد الجذر لمشروعك.

أنشئ ملف Swift جديدًا باسم example.swift يحتوي على كود "سيء":

// example.swift
import Foundation

let x = 10
let y = 20
func sum(a:Int, b:Int)->Int {
return a + b
}
print(sum(a: x, b: y))

قم بتشغيل الأداة:

swiftlint lint --path example.swift

سترى في الطرفية شيئًا كهذا:

example.swift:3:1: warning: Colon Violation (colon) - Colons should be next to the identifier when specifying a type and next to the key in dictionary literals.
example.swift:5:1: warning: Vertical Whitespace Violation (vertical_whitespace) - Limit vertical whitespace to a single empty line.
example.swift:5:16: warning: Colon Violation (colon) - Colons should be next to the identifier when specifying a type.
example.swift:6:1: warning: Return Arrow Whitespace Violation (return_arrow_whitespace) - File should have a single trailing newline.
...

لقد وجد SwiftLint مخالفات في الأسلوب. الآن قم بتصحيح الكود باتباع التلميحات:

// example.swift (مصحح)
import Foundation

let x = 10
let y = 20

func sum(a: Int, b: Int) -> Int {
    return a + b
}

print(sum(a: x, b: y))

قم بتشغيل الأداة مرة أخرى - لن تظهر أي تحذيرات.

SwiftLint لـ Swift: دليل شامل مع أمثلة عملية