Migrar un proyecto de XcodeGen

XcodeGen es una herramienta de generación de proyectos que utiliza YAML como formato de configuración para definir proyectos de Xcode. Muchas organizaciones lo adoptaron intentando evitar los frecuentes conflictos de Git que surgen al trabajar con proyectos de Xcode. Sin embargo, los frecuentes conflictos de Git son solo uno de los muchos problemas que experimentan las organizaciones. Xcode expone a los desarrolladores a muchas complejidades y configuraciones implícitas que dificultan el mantenimiento y la optimización de proyectos a gran escala. XcodeGen se queda corto en ese aspecto por diseño, ya que es una herramienta que genera proyectos de Xcode, no un gestor de proyectos. Si necesitas una herramienta que te ayude más allá de generar proyectos de Xcode, deberías considerar Tuist.

Swift frente a YAML

Muchas organizaciones también prefieren Tuist como herramienta de generación de proyectos porque utiliza Swift como formato de configuración. Swift es un lenguaje de programación familiar para los desarrolladores, que les ofrece la comodidad de usar las funciones de autocompletado, comprobación de tipos y validación de Xcode.

A continuación se presentan algunas consideraciones y directrices para ayudarte a migrar tus proyectos de XcodeGen a Tuist.

Generación de proyectos#

Tanto Tuist como XcodeGen ofrecen un comando generate que convierte la declaración de tu proyecto en proyectos y espacios de trabajo de Xcode.

bash

xcodegen generate

bash

tuist generate

La diferencia radica en la experiencia de edición. Con Tuist, puedes ejecutar el comando tuist edit, que genera un proyecto de Xcode al vuelo que puedes abrir y empezar a modificar. Esto es especialmente útil cuando quieres realizar cambios rápidos en tu proyecto.

`project.yaml`#

El archivo de descripción project.yaml de XcodeGen se convierte en Project.swift. Además, puedes tener Workspace.swift para personalizar cómo se agrupan los proyectos en espacios de trabajo. También puedes tener un Project.swift con destinos que hacen referencia a destinos de otros proyectos. En esos casos, Tuist generará un espacio de trabajo de Xcode que incluye todos los proyectos.

bash

/
  project.yaml

bash

/
  Tuist.swift
  Project.swift
  Workspace.swift

Lenguaje de Xcode

Tanto XcodeGen como Tuist adoptan el lenguaje y los conceptos de Xcode. Sin embargo, la configuración basada en Swift de Tuist te ofrece la comodidad de usar las funciones de autocompletado, comprobación de tipos y validación de Xcode.

Plantillas de especificaciones#

Una de las desventajas de YAML como lenguaje para la configuración de proyectos es que no admite la reutilización entre archivos YAML de forma nativa. Esta es una necesidad común al describir proyectos, que XcodeGen tuvo que resolver con su propia solución propietaria llamada "plantillas". Con Tuist, la reutilización está integrada en el propio lenguaje, Swift, y a través de un módulo de Swift llamado ayudantes de descripción de proyecto, que permiten reutilizar código en todos tus archivos de manifiesto.

::: code-group

swift

import ProjectDescription

extension Target {
  /**
    This function is a factory of targets that together represent a feature.
  */
  static func featureTargets(name: String) -> [Target] {
    // ...
  }
}

swift

import ProjectDescription
import ProjectDescriptionHelpers // [!code highlight]

let project = Project(name: "MyProject",
                      targets: Target.featureTargets(name: "MyFeature")) // [!code highlight]

Migrar un proyecto de XcodeGen

Generación de proyectos#

project.yaml#

Plantillas de especificaciones#

`project.yaml`#