Använda Xcode 15 för att fixa felet "New Build System Required" i SwiftUI Preview

Felsökning av Xcode Build System för smidig SwiftUI-integration

Att stöta på fel när du arbetar i Xcode kan vara oerhört frustrerande, speciellt när du dyker in i SwiftUI i ett UIKit-projekt. Ett vanligt problem som många utvecklare möter, särskilt i Xcode 15, är felet "Nytt byggsystem krävs" vid förhandsgranskning av SwiftUI-filer. 😣

Det här problemet dyker ofta upp oväntat och att spåra orsaken kan vara förvirrande. I de flesta fall hänför det sig till bygginställningar för arbetsytan som inte är standard för det nya byggsystemet, vilket Xcode nu kräver för att använda förhandsvisningar effektivt.

I den här artikeln kommer jag att guida dig genom att förstå detta fel, tillsammans med praktiska steg för att åtgärda det. I slutet kommer du att kunna justera inställningarna och fortsätta använda SwiftUI-förhandsgranskningar utan att häcka.

Låt oss dyka in i en steg-för-steg-strategi för att möjliggöra det nya byggsystemet i Xcode, vilket säkerställer smidigt SwiftUI förhandsvisningar och en bättre utvecklingsupplevelse överlag. 🚀

Förstå och åtgärda SwiftUI-förhandsgranskningsfelet 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örsta skriptlösningen åtgärdar problemets kärna genom att manuellt aktivera det nya byggsystemet inom Xcodes arbetsytainställningar. För utvecklare som stöter på SwiftUI-förhandsgranskningsfelet är denna metod viktig, särskilt eftersom förhandsgranskningar kräver det nya byggsystemet. I det här tillvägagångssättet öppnar du projektet i Xcode och navigerar till Arbetsyteinställningar (Arkiv -> Arbetsyteinställningar). Här kan du uttryckligen välja alternativet "Nytt byggsystem (standard)", vilket säkerställer kompatibilitet med SwiftUI-förhandsvisningar. Denna lösning är enkel men effektiv, eftersom manuell inställning av byggsystemet löser konfigurationskonflikter som annars skulle kunna blockera förhandsvisningsrendering. Efter detta kan en snabb rensning av projektet med Product -> Clean Build Folder ta bort kvardröjande konfigurationsfiler som kan hålla fast vid föråldrade inställningar. Sådana mindre åtgärder löser ofta stora problem och kan spara mycket tid i komplexa projekt! 🚀

Det andra skriptet är en Swift-baserad lösning som använder filsystemkommandon för att automatisera kontrollen av den nya byggsysteminställningen. Skriptet använder FileManager för att komma åt arbetsytans konfigurationsfil, WorkspaceSettings.xcsettings, och se till att inställningarna överensstämmer med SwiftUIs krav för förhandsgranskning. Genom att kontrollera den här filen programmatiskt är det möjligt att bekräfta om "UseNewBuildSystem = YES" är närvarande. Detta tillvägagångssätt är användbart för utvecklare som ofta arbetar med flera projekt, eftersom det sparar tid genom att automatisera byggsystemvalidering. Dessutom läser skriptet innehållet i konfigurationsfilen med en data-till-sträng-konvertering, vilket möjliggör en exakt sökning i filen. Denna automatiserade kontroll effektiviserar processen, perfekt för större team eller CI-miljöer där konsekvens är nyckeln. Det är ett litet men kraftfullt steg mot effektiv projektledning. 🤖

I den tredje lösningen introducerade vi en enhetsteststrategi för att verifiera byggsysteminställningarna i olika konfigurationer. Med XCTest tillhandahåller detta skript ett strukturerat sätt att säkerställa att konfigurationen är korrekt innan förhandsgranskningen körs. Till exempel XCTAssertTrue och XCTAssertFalse kommandon validerar om inställningen överensstämmer med SwiftUIs krav. I praktiken kan dessa påståenden vara kritiska i större utvecklingsteam eller när man bygger in automation i CI/CD-pipelines, eftersom de ger en omedelbar röd flagga om förhandsvisningskonfigurationen inte är upp till standard. Det gör också introduktionen av nya utvecklare enklare, eftersom de kan använda dessa tester för att säkerställa att deras miljö uppfyller de nödvändiga kraven innan de arbetar med SwiftUI-förhandsvisningar.

Slutligen kör testsvitens defaultTestSuite.run()-kommando automatiskt alla tester i den här lösningen och simulerar olika byggmiljöer för att verifiera närvaron av rätt byggsystem. Detta ger utvecklare ett proaktivt tillvägagångssätt för att undvika förhandsgranskningsrelaterade avbrott i deras arbetsflöde. Var och en av dessa lösningar ger en unik vinkel för att hantera det nya byggsystemkravet i Xcode, vilket erbjuder flexibilitet för att lösa problemet baserat på projektbehov. Genom att implementera en eller flera av dessa lösningar kan du effektivisera din utveckling och undvika oväntade SwiftUI-förhandsgranskningsfel.

// 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()

Att komma till roten av Xcode-felet "New Build System Required".

En av de mindre diskuterade aspekterna av SwiftUI-förhandsgranskningsfelet, "Nytt byggsystem krävs", är förändringen av Xcode 15 för att uteslutande förlita sig på det nya byggsystemet. Även om det först introducerades i Xcode 10, har detta nya byggsystem nu blivit viktigt för SwiftUI-förhandsvisningar. När du försöker visa SwiftUI-filer i ett UIKit-baserat projekt kan äldre bygginställningar leda till det här felet och avbryta förhandsgranskningsfunktionen. Att byta till det nya byggsystemet är ett sätt att effektivisera prestanda och minska några vanliga byggfel, men för utvecklare som inte är medvetna om detta krav kan det leda till betydande frustration när förhandsvisningar inte fungerar. 🎯

Utöver att bara byta till det nya byggsystemet kan utvecklare också se till att deras projektinställningar är anpassade till Xcodes nyare ramverk. Detta involverar att kontrollera beroenden och konfigurationer i Arbetsyteinställningar, för att säkerställa att rätt SDK-versioner är inställda. Ibland kan inställningar för iOS-versioner så låga som 13 ytterligare komplicera förhandsgranskningskompatibiliteten, särskilt när de används i projekt som är inriktade på nyare SDK:er som iOS 17. Denna proaktiva inställningskontroll kan förhindra förhandsavbrott samtidigt som utvecklare kan njuta av de senaste funktionerna SwiftUI erbjuder.

Utvecklare bör också överväga att konfigurera automatiserade skript eller testsviter för att verifiera bygginställningar innan de startar förhandsvisningar. Genom att använda XCTest eller FileManager-baserade skript för att granska och justera projektinställningar kan team spara tid och undvika förhandsgranskningsrelaterade problem i olika miljöer. När Xcode fortsätter att utvecklas är det viktigt att hålla sig informerad om nya krav som denna byggsystemväxel för en smidig utvecklingsprocess. Detta säkerställer att både SwiftUI och UIKit-baserade element i projektet fungerar harmoniskt utan förhandsgranskningsfel.