Налаштування SwiftLint для перевірки стилю iOS-коду

iOS-проєкт без статичного аналізатора коду — це хаос. Force unwrap, trailing whitespace, функції на 200 рядків стають нормою. Команди, що впровадили SwiftLint, економлять до 70% часу на code review і скорочують кількість багів на 30%. Економія на підтримці коду може сягати 40% за рахунок раннього виявлення проблем — це знижує витрати на $2 000 на місяць для команди з 5 розробників. SwiftLint від Realm — промисловий стандарт, який автоматично перевіряє стиль та виявляє помилки. Ми налаштуємо його під ключ: конфігурація, CI, pre-commit hooks. Отримайте стабільний quality gate за один день. Зв'яжіться з нами для оцінки вашого проєкту.

Навіщо команді SwiftLint?

SwiftLint перевіряє дотримання Swift API Design Guidelines та кастомних правил. Без статичного аналізатора через 3 місяці codebase проєкту з 5+ розробниками стає неоднорідним: частина коду з trailing whitespace, інша — з force_cast, третя — з функціями по 200 рядків. SwiftLint ловить це на етапі коміту або PR, економлячи години код-рев'ю. Наприклад, правило force_unwrapping запобігає крашам через nil, а function_body_length не дає функціям розростатися за 50 рядків. На одному з проєктів з 8 розробниками відсутність SwiftLint призвела до того, що код-рев'ю займало 4 години на день, а після впровадження — 30 хвилин. Зниження кількості багів на 30% економить бюджет QA приблизно на $1 500 щомісяця. Ми у сфері iOS-розробки понад 7 років і налаштували SwiftLint для 15+ проєктів.

Першочергові правила SwiftLint

Ось таблиця найбільш корисних вбудованих та opt-in правил, які ми рекомендуємо для будь-якого iOS-проєкту.

Зв'яжіться з нами для підбору оптимального набору правил під ваш проєкт.

Процес налаштування SwiftLint

Ми використовуємо перевірені конфіги під iOS-проєкти. Встановлення через Swift Package Manager (фіксуємо версію 0.57.0):

.package(url: "https://github.com/realm/SwiftLint.git", from: "0.57.0") 

Базова конфігурація

Файл .swiftlint.yml у корені проєкту:

---
included:
  - Sources
  - Tests
excluded:
  - Sources/Generated
  - Pods
  - .build
disabled_rules:
  - trailing_whitespace # якщо редактор не чистить автоматично
opt_in_rules:
  - array_init
  - closure_spacing
  - conditional_returns_on_newline
  - contains_over_filter_count
  - empty_count
  - explicit_init
  - fatal_error_message
  - first_where
  - force_unwrapping
  - implicitly_unwrapped_optional
  - overridden_super_call
  - private_outlet
  - prohibited_super_call
  - sorted_imports
  - unneeded_parentheses_in_closure_argument
line_length:
  warning: 120
  error: 200
function_body_length:
  warning: 50
  error: 100
file_length:
  warning: 400
  error: 600
type_body_length:
  warning: 200
  error: 400
cyclomatic_complexity:
  warning: 10
  error: 20
custom_rules:
  no_print:
    name: "No print statements"
    regex: "\\bprint\\("
    message: "Use Logger instead of print()"
    severity: warning

Інтеграція в Build Phase

Додаємо скрипт у Build Phases:

if which swiftlint > /dev/null; then swiftlint else echo "warning: SwiftLint not installed" fi 

Покрокове налаштування SwiftLint

1. Встановіть SwiftLint через Swift Package Manager, додавши залежність у Package.swift.
2. Створіть файл .swiftlint.yml у корені проєкту з базовими правилами.
3. Додайте запуск SwiftLint у Build Phases Xcode для перевірки при кожній збірці.
4. Налаштуйте CI-пайплайн з прапорцем --strict для автоматичної перевірки в PR.
5. Увімкніть pre-commit hook для перевірки перед кожним комітом.

Як автоматизувати перевірку коду в CI?

SwiftLint вміє автоматично виправляти частину порушень:

swiftlint --fix --format 

У CI використовуємо --strict та github-actions-logging для анотацій прямо в PR. Приклад кроку GitHub Actions:

- name: Run SwiftLint run: | swiftlint lint \ --reporter github-actions-logging \ --strict 

Порівняння: SwiftLint vs ручне рев'ю

SwiftLint перевіряє 100% коду за секунди, ручне рев'ю — лише 20% з втомою. Автоматична перевірка в 10 разів швидше знаходить порушення стилю. Крім того, SwiftLint не пропускає жодного force unwrap або зайвого пробілу. Результат — консистентний код і щасливі рев'ювери. Детальніше про SwiftLint можна дізнатися на GitHub.

Склад послуги «під ключ»

Терміни та вартість налаштування

Термін налаштування: від 1 дня. Вартість розраховується індивідуально залежно від розміру проєкту та необхідної кастомізації. Зв'яжіться з нами — ми оцінимо ваш проєкт за 24 години.

Типові помилки при налаштуванні

• Ігнорування generated files — потрібно виключити Sources/Generated.
• Занадто суворий конфіг — вмикаємо opt_in_rules поступово.
• Забувають про --strict у CI — тоді warnings не фейлять збірку.
• Не використовують autocorrect — він економить 70% часу на правки.

Ми гарантуємо чистий код і happy code review. Замовте налаштування SwiftLint — отримайте консультацію протягом дня.