Empezar

Si tienes experiencia creando aplicaciones para plataformas Apple, como iOS, añadir código a Tuist no debería ser muy diferente. Hay dos diferencias en comparación con el desarrollo de aplicaciones que vale la pena mencionar:

• Las interacciones con las CLI se producen a través del terminal. El usuario ejecuta Tuist, que realiza la tarea deseada, y luego vuelve con éxito o con un código de estado. Durante la ejecución, el usuario puede ser notificado enviando información de salida a la salida estándar y al error estándar. No hay gestos, ni interacciones gráficas, sólo la intención del usuario.

• No hay runloop que mantenga el proceso vivo a la espera de entrada, como ocurre en una aplicación iOS cuando la aplicación recibe eventos del sistema o del usuario. CLI se ejecuta en su proceso y termina cuando el trabajo está hecho. El trabajo asíncrono se puede realizar utilizando APIs del sistema como DispatchQueue o structured concurrency, pero hay que asegurarse de que el proceso se está ejecutando mientras se ejecuta el trabajo asíncrono. De lo contrario, el proceso terminará el trabajo asíncrono.

Si no tienes experiencia con Swift, te recomendamos el libro oficial de Apple para familiarizarte con el lenguaje y los elementos más utilizados de la API de la Fundación.

Requisitos mínimos

Para cotizar a Tuist, los requisitos mínimos son:

• macOS 14.0+
• Xcode 16.3+

Configurar el proyecto localmente

Para empezar a trabajar en el proyecto, podemos seguir los pasos que se indican a continuación:

• Clone el repositorio ejecutando: git clone [email protected]:tuist/tuist.git
• Instalar Mise para aprovisionar el entorno de desarrollo.
• Ejecuta mise install para instalar las dependencias del sistema necesarias para Tuist
• Ejecuta tuist install para instalar las dependencias externas que necesita Tuist
• (Opcional) Ejecute tuist auth login para obtener acceso a laCaché de Tuist
• Ejecuta tuist generate para generar el proyecto Tuist Xcode usando el propio Tuist

El proyecto generado se abre automáticamente. Si necesita abrirlo de nuevo sin generarlo, ejecute abra Tuist.xcworkspace (o utilice Finder).

XED .

Si intentas abrir el proyecto usando xed ., abrirá el paquete, y no el proyecto generado por Tuist. Te recomendamos que utilices el proyecto generado por Tuist para probar la herramienta.

Editar el proyecto

Si necesitas editar el proyecto, por ejemplo para añadir dependencias o ajustar objetivos, puedes usar el comando

`tuist edit` . Esto apenas se utiliza, pero es bueno saber que existe.

Corre Tuist

Desde Xcode

Para ejecutar tuist desde el proyecto Xcode generado, edite el esquema tuist, y establezca los argumentos que desea pasar al comando. Por ejemplo, para ejecutar el comando tuist generate, puede establecer los argumentos a generate --no-open para evitar que el proyecto se abra después de la generación.

También tendrá que establecer el directorio de trabajo en la raíz del proyecto que se está generando. Puede hacerlo utilizando el argumento --path, que todos los comandos aceptan, o configurando el directorio de trabajo en el esquema como se muestra a continuación:

PROJECTDESCRIPTION COMPILATION

El CLI tuist depende de la presencia del framework ProjectDescription en el directorio de productos construidos. Si tuist no se ejecuta porque no encuentra el framework ProjectDescription, construya primero el esquema Tuist-Workspace.

Desde el terminal

Puedes ejecutar tuist utilizando el propio Tuist a través de su comando run:

tuist run tuist generate --path /path/to/project --no-open

También puede ejecutarlo directamente a través del gestor de paquetes Swift:

swift build --product ProjectDescription
swift run tuist generate --path /path/to/project --no-open