Utilitzant Xcode 15 per solucionar l'error "Es requereix un sistema de nova creació" a la vista prèvia de SwiftUI

Resolució de problemes del sistema Xcode Build per a una integració fluida de SwiftUI

Trobar errors mentre es treballa a Xcode pot ser increïblement frustrant, especialment quan es submergeix a SwiftUI en un projecte UIKit. Un problema comú que tenen molts desenvolupadors, especialment Xcode 15, és l'error "Es requereix un nou sistema de compilació" en previsualitzar els fitxers SwiftUI. 😣

Aquest problema sovint apareix de manera inesperada i trobar la causa pot ser confús. En la majoria dels casos, es refereix a la configuració de l'espai de treball que no és predeterminada al nou sistema de compilació, que ara requereix Xcode per utilitzar les visualitzacions prèvies de manera eficaç.

En aquest article, us guiaré per entendre aquest error, juntament amb passos pràctics per solucionar-lo. Al final, podreu ajustar la configuració i continuar utilitzant les visualitzacions prèvies de SwiftUI sense cap problema.

Anem a capgirar-nos en un enfocament pas a pas per habilitar el nou sistema de compilació a Xcode, garantint SwiftUI visualitzacions prèvies i una millor experiència de desenvolupament en general. 🚀

Comprendre i solucionar l'error de vista prèvia de SwiftUI a 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 ->La primera solució d'script aborda el nucli del problema activant manualment el nou sistema de compilació dins de la configuració de l'espai de treball de Xcode. Per als desenvolupadors que troben l'error de vista prèvia de SwiftUI, aquest mètode és essencial, sobretot perquè les previsualitzacions requereixen el nou sistema de compilació. En aquest enfocament, obrireu el projecte a Xcode i navegareu a Configuració de l'espai de treball (Fitxer -> Configuració de l'espai de treball). Aquí, podeu seleccionar explícitament l'opció "Nou sistema de compilació (predeterminat)", assegurant la compatibilitat amb les visualitzacions prèvies de SwiftUI. Aquesta solució és senzilla però efectiva, ja que la configuració manual del sistema de compilació resol els conflictes de configuració que, d'altra manera, podrien bloquejar la visualització prèvia. Després d'això, una neteja ràpida del projecte amb Producte -> Carpeta de compilació neta pot eliminar els fitxers de configuració persistents que poden mantenir la configuració obsoleta. Aquestes accions menors sovint resolen grans problemes i poden estalviar molt de temps en projectes complexos! 🚀

El segon script és una solució basada en Swift que utilitza ordres del sistema de fitxers per automatitzar la comprovació de la nova configuració del sistema de compilació. L'script aprofita FileManager per accedir al fitxer de configuració de l'espai de treball, WorkspaceSettings.xcsettings, assegurant que la configuració s'alinea amb els requisits de vista prèvia de SwiftUI. En comprovar aquest fitxer amb programació, és possible confirmar si "UseNewBuildSystem = YES" està present. Aquest enfocament és útil per als desenvolupadors que treballen sovint en diversos projectes, ja que estalvia temps en automatitzar la validació del sistema de compilació. A més, l'script llegeix el contingut del fitxer de configuració amb una conversió de dades a cadena, la qual cosa permet una cerca precisa dins del fitxer. Aquesta comprovació automatitzada agilitza el procés, ideal per a equips més grans o entorns de CI on la coherència és clau. És un petit però potent pas cap a una gestió eficient del projecte. 🤖

A la tercera solució, vam introduir una estratègia de prova d'unitat per verificar la configuració del sistema de compilació en diferents configuracions. Amb XCTest, aquest script proporciona una manera estructurada d'assegurar-se que la configuració és correcta abans d'executar la vista prèvia. Per exemple, el XCTAssertTrue i XCTAssertFalse Les ordres validen si la configuració s'alinea amb els requisits de SwiftUI. A la pràctica, aquestes afirmacions poden ser crítiques en equips de desenvolupament més grans o a l'hora d'integrar l'automatització en canalitzacions CI/CD, ja que ofereixen una bandera vermella immediata si la configuració de la vista prèvia no s'ajusta a l'estàndard. També facilita la incorporació de nous desenvolupadors, ja que poden utilitzar aquestes proves per assegurar-se que el seu entorn compleix els requisits necessaris abans de treballar amb visualitzacions prèvies de SwiftUI.

Finalment, l'ordre defaultTestSuite.run() de la suite de proves executa automàticament totes les proves d'aquesta solució, simulant diversos entorns de compilació per verificar la presència del sistema de compilació correcte. Això proporciona als desenvolupadors un enfocament proactiu per evitar interrupcions relacionades amb la vista prèvia en el seu flux de treball. Cadascuna d'aquestes solucions aporta un angle únic per gestionar el nou requisit del sistema de compilació a Xcode, oferint flexibilitat per resoldre el problema en funció de les necessitats del projecte. Si implementeu una o més d'aquestes solucions, podeu racionalitzar el vostre desenvolupament i evitar errors inesperats de vista prèvia de 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()

Arribar a l'arrel de l'error Xcode "Es requereix un sistema de nova compilació".

Un dels aspectes menys comentats de l'error de previsualització SwiftUI, "Es requereix un nou sistema de compilació", és el canvi a Xcode 15 per confiar exclusivament en el nou sistema de compilació. Tot i que es va introduir inicialment a Xcode 10, aquest nou sistema de creació ara s'ha convertit en essencial per a les visualitzacions prèvies de SwiftUI. Quan s'intenta visualitzar fitxers SwiftUI en un projecte basat en UIKit, la configuració de compilació més antiga pot provocar aquest error, interrompent la funcionalitat de previsualització. Canviar al nou sistema de compilació és una manera d'agilitzar el rendiment i reduir alguns errors de compilació habituals, però per als desenvolupadors que no són conscients d'aquest requisit, pot provocar una frustració important quan les previsualitzacions no funcionen. 🎯

Més enllà de canviar simplement al nou sistema de creació, els desenvolupadors també poden assegurar-se que la configuració del projecte estigui alineada amb els marcs més nous d'Xcode. Això implica comprovar les dependències i les configuracions a Configuració de l'espai de treball, assegurant-vos que s'estableixin les versions correctes de l'SDK. De vegades, la configuració de les versions d'iOS tan baixes com la 13 pot complicar encara més la compatibilitat de la vista prèvia, especialment quan s'utilitza en projectes orientats a SDK més recents com iOS 17. Aquesta comprovació proactiva de la configuració pot evitar interrupcions de la vista prèvia alhora que permet als desenvolupadors gaudir de les últimes funcions que ofereix SwiftUI.

Els desenvolupadors també haurien de plantejar-se configurar scripts automatitzats o suites de proves per verificar la configuració de la compilació abans de llançar previsualitzacions. Si utilitzen scripts basats en XCTest o FileManager per revisar i ajustar la configuració del projecte, els equips poden estalviar temps i evitar problemes relacionats amb la vista prèvia en diversos entorns. A mesura que Xcode continua evolucionant, mantenir-se informat sobre nous requisits com aquest canvi de sistema de compilació és essencial per a un procés de desenvolupament fluid. Això garanteix que tant els elements basats en SwiftUI com UIKit del projecte funcionin harmònicament sense errors de vista prèvia.