Ошибка "No such module" в Xcode: фреймворк есть, но не импортируется

Причина ошибки и базовое решение

Ошибка "No such module" в Swift почти всегда связана с тем, что Xcode не видит модульные карты (module.modulemap) вашего фреймворка. Swift работает не с заголовочными файлами, как Objective-C, а с модулями. Даже если фреймворк физически присутствует в проекте, Swift не сможет его импортировать, если модуль не объявлен корректно.

Вот пошаговый план, который решает 90% таких проблем:

Шаг 1. Проверьте, что фреймворк поддерживает Swift

Некоторые старые или самописные фреймворки написаны только на Objective-C и не имеют модульной карты. Чтобы использовать их в Swift, нужно либо создать bridging header, либо вручную добавить файл module.modulemap.

Шаг 2. Настройка Build Settings

Убедитесь, что в настройках вашего таргета:

• Defines Module — YES (для вашего основного модуля)
• Module Map File — путь к файлу module.modulemap, если он нестандартный
• Framework Search Paths — содержит путь к папке, где лежит .framework
• Allow Non-Modular Includes In Framework Modules — YES (иногда помогает, если фреймворк не совсем "чистый")

Шаг 3. Для CocoaPods: переустановка и workspace

Если вы используете CocoaPods:

pod deintegrate
pod install --clean-install

Всегда открывайте .xcworkspace, а не .xcodeproj. Убедитесь, что модуль добавлен в ваш Podfile:

target 'YourApp' do
  pod 'Alamofire'
end

Шаг 4. Для Swift Package Manager (SPM)

Если фреймворк добавлен через SPM:

• File → Add Packages → убедитесь, что пакет добавлен для вашего таргета
• Проверьте в General → Frameworks, Libraries, and Embedded Content — библиотека должна быть там
• Иногда помогает: File → Packages → Reset Package Caches

Шаг 5. Для ручного добавления .framework

Создайте файл module.modulemap внутри папки фреймворка:

framework module MyFramework {
  umbrella header "MyFramework.h"
  export *
  module * { export * }
}

Затем укажите путь к нему в Build Settings → Module Map File.

Шаг 6. Чистка и пересборка

После всех изменений обязательно выполните:

Product → Clean Build Folder (Option + Shift + Cmd + K)
Delete DerivedData (File → Workspace Settings → DerivedData → Open, удалите папку)

Шаг 7. Проверка архитектуры

Убедитесь, что фреймворк собран для архитектуры вашего симулятора/устройства. Для отладки на симуляторе нужна x86_64 или arm64 (для Apple Silicon). Используйте команду в терминале:

lipo -info /path/to/MyFramework.framework/MyFramework

Пример рабочей конфигурации (Alamofire через SPM)

Вот как должен выглядеть рабочий проект:

// Package Dependencies в Xcode:
// https://github.com/Alamofire/Alamofire.git, версия 5.8.0

// Ваш файл:
import UIKit
import Alamofire // ✅ теперь работает

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        print("Alamofire version: \(AF.version)")
    }
}

Если после всех шагов ошибка остаётся — проверьте, не конфликтует ли ваш проект с другими таргетами (например, тестами). Иногда нужно добавить фреймворк отдельно для тестового таргета в Build Phases.

#import "MyFramework/MyFramework.h"