Dependency Managers iOS

Dependency Managers
S u b m ó d u l o s G I T
C o c o a p o d s
C a r t h a g e

Soy Angel Morales
iOS Developer @ Deloitte Digital
¡ Hola !
http://medium.com/@angelmoralesk
https://github.com/ctime95

Agenda
¿Qué son los dependency managers?
Submódulos Git
Carthage
Dependencias
Ventajas
¿Por qué no conviene gestionar dependencias manualmente?
Cocoapods
Conceptos
Ejemplo : Agregar framework como submódulo Git
Conceptos
Ejemplo: Integrar Lottie con Carthage
Conclusiones
Conceptos
Ejemplo: Integrar Cocoapods en una librería Cocoa Touch
Gestionando cambios
Comandos adicionales
Semantic Versioning
Un vistazo a Lockfiles

Frameworks proporcionan soluciones a problemas recurrentes.
Comunicación HTTP
Descarga asincrona de imágenes
Nuevas soluciones en base de datos
Animaciones
Nuevas formas de programación… etc
Frameworks de terceros cuentan con gran participación de la comunidad
Constante mantenimiento
Nuevas funcionalidades o libres de bugs

Gestores de dependencia (Dependency Managers)
Dependencia
“Módulo externo e independiente que puede ser tan pequeño como un simple archivo o
tan grande como una colección de directorios y/o archivos organizados en paquetes
para cumplir con una tarea especifica”
Facilitan la integración de librerías de terceros en nuestra aplicación (al igual que su
eliminación y actualización con nuevas versiones)
Provee mecanismos para agregar código adicional y por tanto nuevas funcionalidades
Coordinan la integración con librerías externas o paquetes a la aplicación

Dependency Managers no
es exclusivo en iOS

Código
reutilizable
Agilizamos
desarrollo
Manejo de
versiones
Ventajas

¿Por qué Dependency
Managers si podemos…?

Asociarlos con
los targets
(link to binary)
Agregar linker
flagsImportarlos en
nuestro proyecto
Descargar
frameworks,
bundles…
…incorporar el framework manualmente?
….Si hay frameworks dependientes,
repetir el proceso
Es un proceso complejo, propenso a
errores …

No se cuenta una referencia original del código ( ¿ de dónde salió ? )
Actualizaciones no son fáciles de integrar
No se cuenta con información de las versiones
• Estamos usando versión 1.2.3? o 1.4.0?
• ¿Contamos con el fix de la versión XYZ?
Además…

Es una forma de administrar dependencias utilizando git
Crear dependencias
podemos hacer que nuestro proyecto Principal A dependa de proyecto B
(framework)
Submódulos Git
Requisito
Tanto el proyecto principal como el framework cuentan con control de versiones Git.
Al agregar un submódulo…
Se genera archivo de configuración oculto: .gitmodules
Se clona el proyecto del framework dentro de un directorio del proyecto principal
El proyecto principal guarda una referencia del commit que apunta el submódulo.

Ejemplo: Agregar framework Circle-Menu como submódulo Git

1.Dentro del directorio del proyecto principal, creamos un directorio para almacenar los frameworks
(submódulos).

2. Agregamos un submodulo con el siguiente comando:
<<URL>> : del repositorio remoto Circle-Menu
<<DIR_LOCAL>> : es el directorio local dentro de nuestro proyecto,
$git submodule add <<URL>> <<DIR_LOCAL>>

3. Dentro del directorio principal, se crea .gitmodules que almacena un mapeo entre la URL del
proyecto y el directorio local al que se descargó el submodulo.
Al igual que el archivo .gitignore, el archivo .gitmodules debe monitorearse en Git (subirse o
descargarse con el resto del proyecto).
[submodule "MainProject/Frameworks/Internal"]
path = MainProject/Frameworks/Internal
url = https://github.com/Ramotion/circle-menu.git
4. Para obtener un resumen de los submodulos (e.j. commits modificados) usamos:
$git config --global status.submoduleSummary true

5. Preparamos un commit agregando los cambios.

6. Con el Finder, dentro de Frameworks/Internal… ubicamos el proyecto de CircleMenu.xcodeproj y lo
arrastramos al Xcode con nuestro proyecto principal abierto.

7. Seleccionamos el proyecto principal > target MainProject
8. En la pestaña General en Linked Frameworks
agregamos el CircleMenu.framework.

9. Preparamos el commit e integramos la librería en nuestro ViewController

Repositorio
MainProject
Repositorio
Circle - menu
MainProject
Circle - menu
Último commit
36abcz
ViewController.swift
Modelo.swift
Commit submodulo 36abcz
GESTIONANDO CAMBIOS DEL SUBMÓDULO

Proyecto
Submódulos
Terminal

1. Dentro del proyecto del submódulo, hacemos checkout a otro commit o rama

3. En el proyecto principal cambia la referencia del submódulo.

Comandos adicionales
Comando Descripción
$git submodule sync Actualiza la metadata de los submódulos cuando la URL cambió
$git submodule update Actualiza los contenidos de los submódulos. Equivalente a correr ”git
fetch” y “git checkout” en cada submódulo
$git rm PATH_SUBMOD. Se remueve del repositorio local y filesystem

Dependency manager hecho en Ruby
Instalación de la herramienta
Además de proponer la distribución de librerias de terceros permite su integración
automática
Facilmente instalable con el Ruby disponible en el OS X
$sudo gem install cocoapods
Surgió en Agosto – Septiembre del 2011
Cuenta con alrededor de 47 000 librerias y es usado en 3 millones de apps

Ejemplo: Crear una librería (Cocoa Touch framework) que se comunique al API de GitHub para realizar
una búsqueda de usuarios.
Pods GitHubServices
Podfile Podfile.lock

1.Creamos un Cocoa Touch framework llamado GitHubServices
2. En terminal, dentro del proyecto, ingresamos el comando para generar un archivo de configuración
Podfile
$pod init

3. Llenamos el Podfile con las dependencias que deseamos (indicando la versión , branches o
commits)

Semantic Versioning
1.4.7
Patch ó fixes^
Minor release
Nuevo feature^
Mayor
release*
• * - Rompe backwards compatibility
• ^ - Sin romper backward compatibility
= >= < <= ~>
Operadores Soportados

Semantic Versioning
~> 1.4.7Ejemplos:
Ok, actualizar este
númeroActualizar el último
número de versión
1.4.8
1.4.9
1.4.10
~> 3.3 3.3.5
3.4.0
3.7.0

4. Para instalar las librerías ingresamos el siguiente comando:
$pod install

5. Cocoapods genera un xcworkspace (una colección de proyectos)

6. Justo como cualquier otro framework, lo importamos en nuestra clase solicitada.

7. Probando el framework con clase XCTestCase

Más conceptos sobre Cocoapods…
Podfile.lock Guarda ”snapshot” de las versiones de las dependencias.
Es decir, mantiene/rastrea la versión de cada
dependencia.
Podspec Archivo creado por el autor de la librería, indica
prerequisitos como librerías, assets, URLs de
repositorios..etc
$pod update Comando para instalar nuevas versiones de librerias o
dependencias

Un vistazo a Podfile.lock
Podfile
‘Libreria’ : 1.3.3
pod ‘Libreria’ ~> 1.3
Si n un Podfile.lock puede
exi sti r una desi ncroni zaci ón
de l as versi ones de
dependenci as.

Podfile
Instalado : 1.3.3
pod install

Podfile
Instalado : 1.3.3

Podfile
Podfile
Instalado : 1.3.3

Podfile
Podfile
Instalado : 1.3.3
pod install
Instalado : 1.4.0

Podfile
Podfile
Instalado : 1.3.3 Instalado : 1.4.0
“Pueden exi sti r conflictos con las dependenci as al
manej ar di ferentes versiones.”

Podfile.lock Podfile.lock
Podfile
Podfile
Instalado : 1.3.3
Librería: 1.3.3 Librería: 1.3.3
Al exi sti r un archi vo
Podfile.lock, se da un
segui mi ento a l as versi ones

Podfile
Podfile
Instalado : 1.3.3
pod install
Instalado : 1.3.3

Podfile
Podfile
Instalado : 1.3.3
pod install
Instalado : 1.3.3
Aunque ejecuta pod install
la version que se instala
no es la 1.4.0, sino la 1.3.3

Podfile
Podfile
Instalado : 1.3.3
pod update
Instalado : 1.4.0
Pero al usar
”pod update…”

Carthage genera binarios de los frameworks y el desarrollador los integra
a su proyecto
2 formas de instalación :
Para consultar la versión de Carthage
A diferencia de Cocoapods, Carthage no ”altera” la estructura del proyecto
No requiere de Podspecs o repositorio centralizado para el desarrollo de
dependencias.
Instalador .pkg
Homebrew package manager (Homebrew ayuda a instalar herramientas para Mac OS)
$carthage version

Archivo de configuración donde indicamos qué dependencias / librerias deseamos
instalar
* Otros elementos opcionales: nombre de rama/ nombre del tag / commit
Consiste de:
github "Alamofire/Alamofire" == 45
Cartfile
Ejemplo:
Origen Nombre Versión (opcional)
Origen de la dependencia puede ser:
Github
Git (la palabra git seguido de git://, http://, ssh:// o path local)

Ejemplo: Integrar Lottie, una librería que parsea animaciones con Adobe After Effects en formato json
para renderizarlos en pantalla.

Ejemplo: Integrando Lottie con Carthage
1. Definimos nuestro Cartfile de la siguiente manera:
2. En terminal ingresamos el siguiente comando para la descarga y generación de frameworks por cada
dependencia:
$carthage update

3. A diferencia de Cocoapods, Carthage NO genera un xcworkspace para que podamos trabajar, sino que crea:
Archivo que indica las versiones
de nuestras dependencias.
Ideal subirlo a control de
versiones
Contiene los frameworks
construidos por Carthage que
se integrarán manualmente al
proyecto.Directorio para verificar el
código fuente de cada
dependencia. Su contenido
puede sobreescribirse.

4. Del directorio Carthage>Build>iOS arrastramos el Lottie.framework a la sección de Linked Frameworks and
Libraries.

5. Ahora bien, necesitamos asegurarnos que los frameworks se copien con un Run Script.
• Se selecciona el target y la pestaña
Build Phases
• En la esquina superor izquierda se
presiona “+” para agregar new Run
Script
• Se ingresa el siguiente script
• Para input files
$(SRCROOT)/Carthage/Build/iOS
/Lottie.framework
/usr/local/bin/carthage
copy-frameworks

6. Como paso final, queda incorporar nuestra librería dentro del View Controller adecuado.

Carthage
El control de versiones debe
dar seguimiento (track) al
archivo como .gitmodules
El proyecto principal guarda
una referencia al commit del
submódulo.
Asegurarse que esa referencia
se suba al repositorio del
proyecto para el resto del
equipo.
Submódulos Git
Se cuentan con 2 opciones:
- Recrear el ambiente
* Subir al repositorio
remoto Podfile.lock y Podfile
* Ejecutar pod install y
bajar las dependencias
correspondientes.
- Subir al control de
versiones nuestros pods
Cocoapods
Buenas prácticas
Se cuentan con 2 opciones:
- Recrear el ambiente
* Subir al repositorio
remoto Cartfile.resolved y
Cartfile
* Ejecutar carthage
bootstrap y bajar las
dependencias
correspondientes.

Submódulos Cocoapods Carthage
Requisitos de instalación -
$sudo gem install cocoapods
Homebrew
Instalador .pkg
Proceso de configuración
Clonar repositorio
Incorporar manualmente el framework
Generar archivo de configuración (pod
init)
Instalar las dependencias (pod install)
Trabajar en nueva estructura de
proyecto
Generar archivo de configuración
Instalar dependencias (carthage
update)
Incorporar manualmente los
frameworks
Modifica la estructura del proyecto No Sí No
Archivo de especificación - Podspecs -
Archivo de configuración .gitmodules Podfile Cartfile
Archivo con versiones - Podfile.lock Cartfile.resolved
Modo de actualizar frameworks a
últimas versiones
mediante Git (checkout, pull)
Actualizando Podfile
Ingresar en linea de comando - pod
update
Actualizando Cartfile
Ingresar en linea de comando -
carthage update --platform iOS
Ventajas
Fácil de instalar si contamos con
buenas bases en GIT
Fácil de instalar
Se tiene la opción de recrear el
ambiente ó trabajar con los mismos
pods
Fácil de instalar
Flexible, indicamos diferentes origenes
de las dependencias
Se tiene la opción de recrear el
ambiente ó trabajar con los mismos
binarios
Desventajas
Complejo de gestionar
No contamos con un archivo con las
versiones (Podfile.lock y
Cartfile.resolved)
Mantenimiento del Podspec
Falta mayor flexibilidad al indicar los
origenes de dependencias.
Asegurarse de incorporar los
frameworks manualmente tras instalar
o actualizar

¡Gracias!
http://medium.com/@angelmoralesk
https://github.com/ctime95

Más información
• What are Dependency Managers?
https://medium.com/prodsters/what-are-dependency-managers-26d7d907deb8
• An Introduction to CocoaPods (Route 85)
https://www.youtube.com/watch?v=iEAjvNRdZa0
• CocoaPods and Lockfiles (Route 85)
https://www.youtube.com/watch?v=H-
zK1mEwTe0&index=12&t=0s&list=PLOU2XLYxmsIKGQekfmV0Qk52qLG5LU2jO
• Carthage
https://github.com/Carthage/Carthage#license
• Cómo crear, instalar y utilizar un CocoaPod con storyboards y VCs.
https://medium.com/@angelmoralesk/c%C3%B3mo-crear-instalar-y-utilizar-un-
cocoapod-con-sus-storyboards-y-vcs-e0b791a6e087

Más información
• Dependency Management Using Git Submodules
https://www.raywenderlich.com/155150/dependency-management-using-git-
submodules
• Circle Menu
https://github.com/Ramotion/circle-
menu?utm_source=mybridge&utm_medium=blog&utm_campaign=read_more
• Lottie
https://github.com/airbnb/lottie-ios

Dependency Managers iOS

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (20)

Similaire à Dependency Managers iOS

Similaire à Dependency Managers iOS (20)

Dependency Managers iOS