Korištenje Xcode 15 za ispravljanje pogreške "Potreban je novi sustav izgradnje" u pregledu SwiftUI

Rješavanje problema Xcode Build sustava za glatku integraciju SwiftUI

Susret s pogreškama tijekom rada u Xcodeu može biti nevjerojatno frustrirajuće, osobito kada se uranja u SwiftUI u UIKit projektu. Jedan čest problem s kojim se suočavaju mnogi programeri, posebno u Xcode 15, je pogreška "Potreban je novi sustav izrade" prilikom pregleda SwiftUI datoteka. 😣

Ovaj se problem često pojavljuje neočekivano, a pronalaženje uzroka može biti zbunjujuće. U većini slučajeva odnosi se na postavke izgradnje radnog prostora koje nisu zadane za novi sustav izrade, što Xcode sada zahtijeva za učinkovito korištenje pregleda.

U ovom članku ću vas voditi kroz razumijevanje ove pogreške, zajedno s praktičnim koracima za njezino popravljanje. Na kraju ćete moći prilagoditi postavke i nastaviti koristiti SwiftUI preglede bez zastoja.

Uronimo u pristup korak po korak za omogućavanje novog sustava izrade u Xcodeu, osiguravajući glatko SwiftUI preglede i općenito bolje razvojno iskustvo. 🚀

Razumijevanje i popravljanje pogreške SwiftUI pregleda u Xcodeu

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 ->Prvo rješenje skripte rješava srž problema ručnim omogućavanjem novog sustava izrade unutar postavki radnog prostora Xcode-a. Za programere koji se susreću s pogreškom pregleda SwiftUI, ova metoda je bitna, posebno jer pregledi zahtijevaju novi sustav izrade. U ovom pristupu, otvorit ćete projekt u Xcodeu i ići na Postavke radnog prostora (Datoteka -> Postavke radnog prostora). Ovdje možete eksplicitno odabrati opciju "Novi sustav izrade (zadano)", čime se osigurava kompatibilnost s pregledima SwiftUI. Ovo rješenje je jednostavno, ali učinkovito, jer ručno postavljanje sustava za izgradnju rješava konflikte konfiguracije koji bi inače mogli blokirati renderiranje pregleda. Nakon toga, brzo čišćenje projekta s Product -> Clean Build Folder može ukloniti dugotrajne konfiguracijske datoteke koje mogu zadržati zastarjele postavke. Takve manje akcije često rješavaju velike probleme i mogu uštedjeti mnogo vremena u složenim projektima! 🚀

Druga skripta je rješenje temeljeno na Swiftu koje koristi naredbe datotečnog sustava za automatizaciju provjere postavki novog sustava za izgradnju. Skripta koristi FileManager za pristup konfiguracijskoj datoteci radnog prostora, Postavke radnog prostora.xcsettings, osiguravajući usklađenost postavki sa zahtjevima za pregled SwiftUI. Programskom provjerom ove datoteke moguće je potvrditi postoji li "UseNewBuildSystem = YES". Ovaj pristup je koristan za programere koji često rade na više projekata, jer štedi vrijeme automatiziranjem provjere valjanosti sustava izgradnje. Dodatno, skripta čita sadržaj konfiguracijske datoteke uz konverziju podataka u niz, omogućujući precizno pretraživanje unutar datoteke. Ova automatizirana provjera pojednostavljuje proces, idealno za veće timove ili CI okruženja gdje je dosljednost ključna. To je mali, ali snažan korak prema učinkovitom upravljanju projektima. 🤖

U trećem smo rješenju uveli strategiju testiranja jedinica za provjeru postavki sustava za izgradnju u različitim konfiguracijama. Koristeći XCTest, ova skripta pruža strukturirani način da se osigura da je konfiguracija ispravna prije pokretanja pregleda. Na primjer, XCTAssertTrue i XCTAssertFalse naredbe potvrđuju je li postavka usklađena sa zahtjevima SwiftUI-ja. U praksi, ove tvrdnje mogu biti kritične u većim razvojnim timovima ili pri ugradnji automatizacije u CI/CD cjevovode, jer nude trenutnu crvenu zastavu ako konfiguracija pregleda nije u skladu sa standardima. Također čini jednostavnijim uključivanje novih razvojnih programera, jer oni mogu koristiti ove testove kako bi osigurali da njihovo okruženje ispunjava potrebne zahtjeve prije rada s pregledima SwiftUI.

Konačno, naredba defaultTestSuite.run() paketa za testiranje automatski izvršava sve testove u ovom rješenju, simulirajući različita okruženja za izradu kako bi se potvrdila prisutnost ispravnog sustava za izgradnju. Ovo razvojnim programerima pruža proaktivan pristup kako bi izbjegli prekide u tijeku rada vezane uz pregled. Svako od ovih rješenja donosi jedinstveni kut rukovanja novim zahtjevima sustava izgradnje u Xcodeu, nudeći fleksibilnost u rješavanju problema na temelju potreba projekta. Implementacijom jednog ili više ovih rješenja možete pojednostaviti svoj razvoj i izbjeći neočekivane pogreške pregleda SwiftUI.

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

Doći do korijena Xcode pogreške "Potreban je novi sustav izgradnje".

Jedan od manje raspravljanih aspekata pogreške pregleda SwiftUI, "Potreban je novi sustav izrade", promjena je u Xcode 15 da se oslanja isključivo na novi sustav izrade. Iako je u početku predstavljen u Xcode 10, ovaj novi sustav izrade sada je postao neophodan za preglede SwiftUI. Prilikom pokušaja pregledavanja SwiftUI datoteka u projektu temeljenom na UIKit-u, starije postavke izrade mogu dovesti do ove pogreške, prekidajući funkciju pregleda. Prebacivanje na novi sustav izrade je način da se pojednostavi izvedba i smanje neke uobičajene pogreške u izradi, ali za programere koji nisu svjesni ovog zahtjeva, to može dovesti do značajne frustracije kada pregledi ne rade. 🎯

Osim jednostavnog prebacivanja na novi sustav izrade, programeri također mogu osigurati da su njihove postavke projekta usklađene s novijim okvirima Xcode-a. To uključuje provjeru ovisnosti i konfiguracija u Postavke radnog prostora, osiguravajući da su postavljene ispravne verzije SDK-a. Ponekad postavke za verzije iOS-a od čak 13 mogu dodatno zakomplicirati kompatibilnost pregleda, posebno kada se koriste u projektima koji ciljaju novije SDK-ove kao što je iOS 17. Ova proaktivna provjera postavki može spriječiti prekide pregleda dok razvojnim programerima omogućuje da uživaju u najnovijim značajkama koje nudi SwiftUI.

Programeri bi također trebali razmotriti konfiguriranje automatiziranih skripti ili testnih paketa za provjeru postavki izrade prije pokretanja pregleda. Upotrebom skripti temeljenih na XCTest ili FileManager za pregled i prilagođavanje postavki projekta, timovi mogu uštedjeti vrijeme i izbjeći probleme povezane s pregledom u različitim okruženjima. Kako se Xcode nastavlja razvijati, biti informiran o novim zahtjevima kao što je ovaj prekidač za izgradnju sustava ključan je za nesmetan proces razvoja. Ovo osigurava da i SwiftUI i UIKit elementi u projektu rade skladno bez grešaka u pregledu.