Použitie Xcode 15 na opravu chyby „Vyžaduje sa nový systém“ v náhľade SwiftUI

Riešenie problémov Xcode Build System pre hladkú integráciu SwiftUI

Stretnutie s chybami pri práci v Xcode môže byť neuveriteľne frustrujúce, najmä keď sa ponoríte do SwiftUI v projekte UIKit. Jeden spoločný problém, ktorému čelí mnoho vývojárov, najmä v Xcode 15, je chyba „Vyžaduje sa nový systém zostavenia“ pri prezeraní súborov SwiftUI. 😣

Tento problém sa často objavuje neočakávane a hľadanie príčiny môže byť mätúce. Vo väčšine prípadov sa to týka nastavení vytvárania pracovného priestoru, ktoré nie sú predvolené pre nový systém zostavovania, ktorý teraz Xcode vyžaduje na efektívne používanie ukážok.

V tomto článku vás prevediem porozumením tejto chyby spolu s praktickými krokmi na jej odstránenie. Na konci budete môcť upraviť nastavenia a pokračovať v používaní ukážok SwiftUI bez problémov.

Poďme sa ponoriť do podrobného prístupu k aktivácii nového systému zostavovania v Xcode, ktorý zabezpečí hladký priebeh SwiftUI ukážky a celkovo lepší vývojový zážitok. 🚀

Pochopenie a oprava chyby náhľadu SwiftUI v 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 ->Prvé riešenie skriptu rieši jadro problému manuálnym povolením nového zostavovacieho systému v nastaveniach pracovného priestoru Xcode. Pre vývojárov, ktorí sa stretávajú s chybou náhľadu SwiftUI, je táto metóda nevyhnutná, najmä preto, že náhľady vyžadujú nový systém zostavovania. V tomto prístupe otvoríte projekt v Xcode a prejdete na Nastavenia pracovného priestoru (Súbor -> Nastavenia pracovného priestoru). Tu môžete explicitne vybrať možnosť „New Build System (Default)“, čím sa zabezpečí kompatibilita s náhľadmi SwiftUI. Toto riešenie je jednoduché, ale efektívne, pretože manuálne nastavenie systému zostavenia rieši konflikty konfigurácie, ktoré by inak mohli blokovať vykresľovanie ukážky. Potom môže rýchle vyčistenie projektu pomocou Product -> Clean Build Folder odstrániť pretrvávajúce konfiguračné súbory, ktoré môžu obsahovať zastarané nastavenia. Takéto menšie akcie často vyriešia veľké problémy a môžu ušetriť veľa času v zložitých projektoch! 🚀

Druhý skript je riešenie založené na Swift, ktoré používa príkazy systému súborov na automatizáciu kontroly nastavenia nového systému zostavy. Skript využíva FileManager na prístup ku konfiguračnému súboru pracovného priestoru, WorkspaceSettings.xcsettings, čím sa zabezpečí, že nastavenia budú v súlade s požiadavkami na ukážku SwiftUI. Programovou kontrolou tohto súboru je možné potvrdiť, či je prítomný "UseNewBuildSystem = YES". Tento prístup je užitočný pre vývojárov, ktorí často pracujú na viacerých projektoch, pretože šetrí čas automatizáciou overovania zostavovacieho systému. Okrem toho skript načíta obsah konfiguračného súboru s konverziou dát na reťazec, čo umožňuje presné vyhľadávanie v súbore. Táto automatizovaná kontrola zefektívňuje proces, čo je ideálne pre väčšie tímy alebo prostredia CI, kde je kľúčom konzistentnosť. Je to malý, ale účinný krok k efektívnemu riadeniu projektov. 🤖

V treťom riešení sme zaviedli stratégiu testovania jednotiek na overenie nastavenia systému zostavenia v rôznych konfiguráciách. Pomocou XCTest tento skript poskytuje štruktúrovaný spôsob, ako zabezpečiť, aby bola konfigurácia správna pred spustením ukážky. Napríklad, XCTAssertTrue a XCTAssertFalse príkazy overia, či je nastavenie v súlade s požiadavkami SwiftUI. V praxi môžu byť tieto tvrdenia kritické vo väčších vývojových tímoch alebo pri budovaní automatizácie do kanálov CI/CD, pretože ponúkajú okamžitú varovnú vlajku, ak konfigurácia ukážky nie je v súlade so štandardom. Zjednodušuje tiež prijímanie nových vývojárov, pretože tieto testy môžu použiť na zabezpečenie toho, aby ich prostredie spĺňalo potrebné požiadavky pred prácou s ukážkami SwiftUI.

Nakoniec príkaz defaultTestSuite.run() testovacej sady automaticky vykoná všetky testy v tomto riešení, pričom simuluje rôzne prostredia zostavy na overenie prítomnosti správneho zostavovacieho systému. To poskytuje vývojárom proaktívny prístup, aby sa vyhli prerušeniam pracovného toku súvisiacim s ukážkou. Každé z týchto riešení prináša jedinečný uhol spracovania požiadaviek na nový systém zostavenia v Xcode a ponúka flexibilitu pri riešení problému na základe potrieb projektu. Implementáciou jedného alebo viacerých z týchto riešení môžete zefektívniť svoj vývoj a vyhnúť sa neočakávaným chybám náhľadu 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()

Dostať sa ku koreňu chyby Xcode „Vyžaduje sa nový systém“.

Jedným z menej diskutovaných aspektov chyby ukážky SwiftUI, „Vyžaduje sa nový systém zostavenia“, je posun v Xcode 15, aby sa spoliehal výlučne na nový systém zostavovania. Tento nový systém zostavovania, ktorý bol pôvodne predstavený v Xcode 10, sa teraz stal nevyhnutným pre ukážky SwiftUI. Pri pokuse o zobrazenie súborov SwiftUI v projekte založenom na UIKit môžu staršie nastavenia zostavy viesť k tejto chybe a prerušiť funkciu ukážky. Prechod na nový systém zostavovania je spôsob, ako zefektívniť výkon a znížiť niektoré bežné chyby zostavovania, ale pre vývojárov, ktorí si nie sú vedomí tejto požiadavky, to môže viesť k značnej frustrácii, keď ukážky nefungujú. 🎯

Okrem jednoduchého prechodu na nový systém zostavovania sa vývojári môžu uistiť, že ich nastavenia projektu sú v súlade s novšími rámcami Xcode. Zahŕňa to kontrolu závislostí a konfigurácií v Nastaveniach pracovného priestoru a uistenie sa, že sú nastavené správne verzie súpravy SDK. Niekedy môžu nastavenia pre verzie iOS až 13 ešte viac skomplikovať kompatibilitu ukážok, najmä ak sa používajú v projektoch zameraných na novšie súpravy SDK, ako je iOS 17. Táto proaktívna kontrola nastavení môže zabrániť prerušeniam ukážky a zároveň umožňuje vývojárom využívať najnovšie funkcie, ktoré SwiftUI ponúka.

Vývojári by tiež mali zvážiť konfiguráciu automatických skriptov alebo testovacích balíkov na overenie nastavení zostavy pred spustením ukážok. Využitím skriptov založených na XCTest alebo FileManager na kontrolu a úpravu nastavení projektu môžu tímy ušetriť čas a vyhnúť sa problémom súvisiacim s ukážkou v rôznych prostrediach. Ako sa Xcode neustále vyvíja, pre hladký vývojový proces je nevyhnutné byť informovaný o nových požiadavkách, ako je tento prepínač zostavovacieho systému. To zaisťuje, že SwiftUI aj prvky založené na UIKit v projekte fungujú harmonicky bez chýb náhľadu.