...
Eroare Swift · Module, @main și mediu

error: no such module 'UIKit'

Pe scurt

Modulul importat nu există pentru platforma sau proiectul în care compilezi: UIKit doar pe iOS, un pachet (Alamofire, Firebase) neadăugat în proiect sau un nume scris greșit. Adaugă pachetul, alege platforma potrivită sau scoate importul. Editorul nostru are doar biblioteca standard Swift.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

import Nume aduce un modul: biblioteca standard e mereu disponibilă, dar celelalte trebuie să existe pentru platforma și proiectul curent. Compilatorul se oprește cu no such module când nu găsește modulul.

Cauzele tipice:

  • framework de platformă: UIKit există pe iOS, AppKit pe macOS; SwiftUI și Foundation lipsesc pe unele platforme sau în medii minimale;
  • pachet neadăugat: import Alamofire fără să fi adăugat pachetul în Xcode (File > Add Package Dependencies) sau în Package.swift;
  • target greșit: pachetul e adăugat doar la alt target, de exemplu la cel de teste;
  • nume greșit: import Uikit, import foundation.

În Xcode, eroarea poate apărea temporar și după schimbarea ramurii git; un Clean Build Folder (Shift+Cmd+K) sau ștergerea DerivedData o rezolvă. Editorul din pagină compilează doar cu biblioteca standard, deci aici orice import în afară de Swift dă această eroare.

De ce apare: cauzele frecvente

1Framework de iOS într-un program de consolă

Greșit
SWIFT
import UIKit
print("Salut")
Corect
SWIFT
print("Salut")

Codul folosește doar biblioteca standard, deci importul nu e necesar. UIKit există doar în proiectele iOS.

2Pachet care nu e adăugat în proiect

Greșit
SWIFT
import Alamofire
Corect
SWIFT
// Package.swift
dependencies: [
    .package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.9.0")
]
// și "Alamofire" în dependencies-ul target-ului

Un pachet extern trebuie declarat ca dependență și legat de target-ul care îl importă.

3Nume scris greșit

Greșit
SWIFT
import foundation
Corect
SWIFT
import Foundation

Numele modulelor țin cont de litere mari și mici.

Repară tu

Repară eroarea, direct în pagină

Programul calculează latura unui pătrat cu aria 16 și trebuie să afișeze Latura: 4.0. A fost copiat dintr-un proiect iOS și începe cu import UIKit, iar editorul din pagină, care are doar biblioteca standard, se oprește cu no such module 'UIKit'. Fă programul să ruleze fără import.

Codul care dă eroarea
SWIFT
import UIKit

let arie = 16.0
print("Latura: \(arie.squareRoot())")
După reparație, programul afișează
Latura: 4.0
Indiciu

squareRoot() face parte din biblioteca standard; importul nu e necesar.

Alte forme ale mesajului

  • error: no such module 'Foundation'
  • error: no such module 'Alamofire'
  • error: no such module 'SwiftUI'
  • error: no such module 'XCTest'

Cum o eviți pe viitor

  • Importă doar modulele de care ai nevoie; multe funcții de bază (squareRoot(), sorted(), split) sunt în biblioteca standard.
  • La pachete externe, verifică în Xcode, la target > General > Frameworks, Libraries, and Embedded Content, că pachetul e legat de target-ul corect.
  • Când eroarea apare brusc într-un proiect care mergea, fă Clean Build Folder și resolve package versions.

Întrebări frecvente

De ce primesc no such module doar în target-ul de teste?

Pentru că pachetul e legat doar de target-ul aplicației. Adaugă-l și la target-ul de teste sau importă modulul aplicației cu @testable import NumeApp.

Am nevoie de Foundation pentru sqrt?

Nu neapărat. 16.0.squareRoot() e în biblioteca standard. Foundation aduce în plus Date, URL, JSONDecoder, String(format:) și altele.

Erori înrudite

← Toate erorile Swift

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Swift de la zero, cu exerciții la fiecare lecție

Curs Swift (iOS): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.