Bruk av Xcode 15 for å fikse "New Build System Required"-feilen i SwiftUI Preview

Feilsøking av Xcode Build System for jevn SwiftUI-integrasjon

Å støte på feil mens du jobber i Xcode kan være utrolig frustrerende, spesielt når du dykker inn i SwiftUI i et UIKit-prosjekt. Et vanlig problem mange utviklere møter, spesielt i Xcode 15, er feilen "Nytt byggesystem kreves" når du forhåndsviser SwiftUI-filer. 😣

Dette problemet dukker ofte opp uventet, og det kan være forvirrende å finne årsaken. I de fleste tilfeller er det relatert til byggeinnstillinger for arbeidsområde som ikke er standard til det nye byggesystemet, som Xcode nå krever for å bruke forhåndsvisninger effektivt.

I denne artikkelen vil jeg veilede deg gjennom å forstå denne feilen, sammen med praktiske trinn for å fikse den. Mot slutten vil du kunne justere innstillingene og fortsette å bruke SwiftUI-forhåndsvisninger uten problemer.

La oss dykke ned i en trinn-for-trinn-tilnærming for å aktivere det nye byggesystemet i Xcode, for å sikre jevn SwiftUI forhåndsvisninger og en bedre utviklingsopplevelse totalt sett. 🚀

Forstå og fikse SwiftUI-forhåndsvisningsfeilen i Xcode

The first script solution addresses the core of the issue by manually enabling the new build system within Xcode’s workspace settings. For developers encountering the SwiftUI preview error, this method is essential, especially since previews require the new build system. In this approach, you’ll open the project in Xcode and navigate to Workspace Settings (File -> Workspace Settings). Here, you can explicitly select the “New Build System (Default)” option, ensuring compatibility with SwiftUI previews. This solution is simple yet effective, as manually setting the build system resolves configuration conflicts that might otherwise block preview rendering. Following this, a quick clean-up of the project with Product ->Den første skriptløsningen løser kjernen av problemet ved å manuelt aktivere det nye byggesystemet i Xcodes arbeidsområdeinnstillinger. For utviklere som støter på SwiftUI-forhåndsvisningsfeilen, er denne metoden viktig, spesielt siden forhåndsvisninger krever det nye byggesystemet. I denne tilnærmingen åpner du prosjektet i Xcode og navigerer til Arbeidsområdeinnstillinger (Fil -> Arbeidsområdeinnstillinger). Her kan du eksplisitt velge alternativet "New Build System (Standard)", for å sikre kompatibilitet med SwiftUI-forhåndsvisninger. Denne løsningen er enkel, men effektiv, ettersom manuell innstilling av byggesystemet løser konfigurasjonskonflikter som ellers kan blokkere forhåndsvisningsgjengivelse. Etter dette kan en rask opprydding av prosjektet med Product -> Clean Build Folder fjerne dvelende konfigurasjonsfiler som kan holde på utdaterte innstillinger. Slike mindre handlinger løser ofte store problemer og kan spare mye tid i komplekse prosjekter! 🚀

Det andre skriptet er en Swift-basert løsning som bruker filsystemkommandoer for å automatisere sjekken for den nye byggesysteminnstillingen. Skriptet bruker FileManager for å få tilgang til konfigurasjonsfilen for arbeidsområdet, WorkspaceSettings.xcsettings, og sikrer at innstillingene stemmer overens med SwiftUI-forhåndsvisningskravene. Ved å sjekke denne filen programmatisk, er det mulig å bekrefte om "UseNewBuildSystem = YES" er til stede. Denne tilnærmingen er nyttig for utviklere som ofte jobber på tvers av flere prosjekter, siden den sparer tid ved å automatisere byggesystemvalidering. I tillegg leser skriptet innholdet i konfigurasjonsfilen med en data-til-streng konvertering, noe som muliggjør et presist søk i filen. Denne automatiserte sjekken effektiviserer prosessen, ideell for større team eller CI-miljøer der konsistens er nøkkelen. Det er et lite, men kraftig skritt mot effektiv prosjektledelse. 🤖

I den tredje løsningen introduserte vi en enhetsteststrategi for å verifisere byggesysteminnstillingen på tvers av forskjellige konfigurasjoner. Ved å bruke XCTest gir dette skriptet en strukturert måte å sikre at konfigurasjonen er riktig før forhåndsvisningen kjøres. For eksempel XCTAssertTrue og XCTAssertFalse kommandoer validerer om innstillingen stemmer overens med SwiftUIs krav. I praksis kan disse påstandene være kritiske i større utviklingsteam eller når man bygger automatisering inn i CI/CD-rørledninger, da de gir et umiddelbar rødt flagg hvis forhåndsvisningskonfigurasjonen ikke er opp til standarden. Det gjør også introduksjonen av nye utviklere enklere, siden de kan bruke disse testene for å sikre at miljøet oppfyller de nødvendige kravene før de jobber med SwiftUI-forhåndsvisninger.

Til slutt utfører testpakkens defaultTestSuite.run()-kommando automatisk alle testene i denne løsningen, og simulerer ulike byggemiljøer for å verifisere tilstedeværelsen av riktig byggesystem. Dette gir utviklere en proaktiv tilnærming for å unngå forhåndsvisningsrelaterte avbrudd i arbeidsflyten deres. Hver av disse løsningene gir en unik innfallsvinkel til å håndtere det nye byggesystemkravet i Xcode, og tilbyr fleksibilitet i å løse problemet basert på prosjektbehov. Ved å implementere en eller flere av disse løsningene kan du strømlinjeforme utviklingen og unngå uventede SwiftUI-forhåndsvisningsfeil.

// Step 1: Open Xcode and go to your project workspace settings.
// In Xcode, navigate to File -> Workspace Settings.
// Step 2: Set the Build System to "New Build System (Default)".
// This ensures that the workspace uses the new build system required by SwiftUI previews.
// Step 3: Clean the project build folder to remove old configurations.
Product -> Clean Build Folder
// Step 4: Run the SwiftUI preview to confirm the error is resolved.
// If the error persists, restart Xcode and check the settings again.

import Foundation
// Function to check if the build system is set to the new build system
func checkBuildSystem() -> Bool {
   // Path to the workspace settings file
   let workspaceSettingsPath = "path/to/WorkspaceSettings.xcsettings"
   let fileManager = FileManager.default
   if let data = fileManager.contents(atPath: workspaceSettingsPath),
      let content = String(data: data, encoding: .utf8) {
         // Check for the new build system setting
         return content.contains("UseNewBuildSystem = YES")
   }
   return false
}
// Run the function and print status
if checkBuildSystem() {
   print("New build system is enabled.")
} else {
   print("New build system is not enabled. Please update settings.")
}

import XCTest
class BuildSystemTests: XCTestCase {
   func testNewBuildSystemEnabled() {
      // Sample settings content for testing
      let settingsContent = "UseNewBuildSystem = YES"
      XCTAssertTrue(settingsContent.contains("UseNewBuildSystem = YES"),
                    "New Build System should be enabled for SwiftUI Previews.")
   }
   func testOldBuildSystemDisabled() {
      // Sample outdated settings content
      let settingsContent = "UseNewBuildSystem = NO"
      XCTAssertFalse(settingsContent.contains("UseNewBuildSystem = YES"),
                    "Old Build System detected. Update required.")
   }
}
// Execute tests for different configurations
BuildSystemTests.defaultTestSuite.run()

Å komme til roten av Xcode "New Build System Required"-feil

Et av de mindre diskuterte aspektene ved forhåndsvisningsfeilen SwiftUI, "Nytt byggesystem kreves," er skiftet i Xcode 15 til å stole utelukkende på det nye byggesystemet. Mens det opprinnelig ble introdusert i Xcode 10, har dette nye byggesystemet nå blitt essensielt for SwiftUI-forhåndsvisninger. Når du prøver å vise SwiftUI-filer i et UIKit-basert prosjekt, kan eldre byggeinnstillinger føre til denne feilen, og avbryte forhåndsvisningsfunksjonaliteten. Bytte til det nye byggesystemet er en måte å effektivisere ytelsen og redusere noen vanlige byggefeil, men for utviklere som ikke er klar over dette kravet, kan det føre til betydelig frustrasjon når forhåndsvisninger ikke fungerer. 🎯

Utover å bare bytte til det nye byggesystemet, kan utviklere også sørge for at prosjektinnstillingene deres er på linje med Xcodes nyere rammeverk. Dette innebærer å sjekke avhengigheter og konfigurasjoner i Workspace Settings, for å sikre at de riktige SDK-versjonene er satt. Noen ganger kan innstillinger for iOS-versjoner så lave som 13 komplisere forhåndsvisningskompatibiliteten ytterligere, spesielt når de brukes i prosjekter som er rettet mot nyere SDK-er som iOS 17. Denne proaktive innstillingskontrollen kan forhindre avbrudd i forhåndsvisningen samtidig som utviklere kan nyte de nyeste funksjonene SwiftUI tilbyr.

Utviklere bør også vurdere å konfigurere automatiserte skript eller testsuiter for å verifisere byggeinnstillinger før de starter forhåndsvisninger. Ved å bruke XCTest eller FileManager-baserte skript for å gjennomgå og justere prosjektinnstillinger, kan team spare tid og unngå forhåndsvisningsrelaterte problemer på tvers av ulike miljøer. Ettersom Xcode fortsetter å utvikle seg, er det viktig å holde seg informert om nye krav som denne byggesystembryteren for en jevn utviklingsprosess. Dette sikrer at både SwiftUI og UIKit-baserte elementer i prosjektet fungerer harmonisk uten forhåndsvisningsfeil.