ES
RU
EN
ZH
FR
DE
PT
AR
HI
Monorepositorio con Swift: organización de código para proyectos iOS y macOS
En el desarrollo moderno para iOS y macOS, la elección de la estrategia de gestión de código afecta directamente la velocidad de desarrollo, la calidad de la refactorización y la comodidad del trabajo en equipo. El enfoque tradicional con múltiples repositorios separados (polirepositorio) a menudo conduce a la duplicación de dependencias, dificultades con la sincronización de versiones y fragmentación de la base de código. Una alternativa es el monorepositorio (monorepo): un almacén único para todos los módulos, bibliotecas y aplicaciones del proyecto. En este artículo, usando Swift y el ecosistema Apple como ejemplo, analizaremos cómo organizar un monorepositorio, qué herramientas usar y qué obstáculos considerar.
¿Qué es un monorepositorio y por qué es necesario en proyectos Swift?
Un monorepositorio es una estrategia de gestión de versiones en la que todo el código del proyecto (varias aplicaciones, bibliotecas, configuraciones) se almacena en un único repositorio Git. En el contexto de Swift, esto significa que puedes tener en un solo repositorio:
- Aplicación iOS (por ejemplo,
MyApp) - Aplicación macOS (
MyMacApp) - Biblioteca compartida de modelos (
CoreModels) - Capa de red (
Networking) - Componentes de UI (
UIComponents) - Pruebas y scripts de CI
Ventajas del monorepositorio para proyectos Swift:
- Versión única de dependencias — todos los módulos usan la misma versión de la biblioteca (por ejemplo,
AlamofireoSwiftUI), lo que elimina conflictos. - Commits atómicos — los cambios en la API de una biblioteca y su uso en la aplicación se registran en un solo commit, lo que simplifica la revisión de código y la reversión.
- Simplificación de la refactorización — puedes renombrar un método público en un módulo y corregir inmediatamente todos los lugares de llamada en el mismo repositorio.
- CI/CD compartido — un solo pipeline para compilar y probar todos los componentes.
Herramientas para trabajar con monorepositorio en Swift
En el ecosistema Apple hay dos herramientas principales para organizar un monorepositorio: Swift Package Manager (SPM) y Tuist. Analicemos sus características.
Swift Package Manager (SPM)
SPM es un gestor de paquetes integrado que es perfecto para monorepositorios. Defines los módulos a través de Package.swift, y Xcode resuelve las dependencias automáticamente. Ejemplo de estructura:
MyMonorepo/├── Package.swift├── Sources/│ ├── CoreModels/│ │ └── Models.swift│ ├── Networking/│ │ └── APIClient.swift│ └── UIComponents/│ └── ButtonView.swift├── Apps/│ ├── MyApp/│ │ └── (proyecto iOS)│ └── MyMacApp/│ └── (proyecto macOS)└── Tests/ ├── CoreModelsTests/ └── NetworkingTests/Ejemplo de Package.swift para dicho monorepositorio:
// swift-tools-version:5.9import PackageDescription
let package = Package( name: "MyMonorepo", platforms: [ .iOS(.v16), .macOS(.v13) ], products: [ .library(name: "CoreModels", targets: ["CoreModels"]), .library(name: "Networking", targets: ["Networking"]), .library(name: "UIComponents", targets: ["UIComponents"]), ], dependencies: [ .package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.8.0") ], targets: [ .target(name: "CoreModels"), .target( name: "Networking", dependencies: ["CoreModels", "Alamofire"] ), .target( name: "UIComponents", dependencies: ["CoreModels"] ), .testTarget(name: "CoreModelsTests", dependencies: ["CoreModels"]), .testTarget(name: "NetworkingTests", dependencies: ["Networking"]), ])
