Dependency Managers

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 flags
Importarlos 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

usuarios.
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

usuarios.
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

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

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

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

usuarios.
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 Podfi l e.l ock 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 confl i ctos con l as dependenci as al
manej ar di ferentes versi ones.”

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
Podfi l e.l ock, 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 ej ecuta pod i nstal l l a
versi on que se i nstal a no es l a
1.4.0, si no l a 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

Recommandé

Recommandé

Contenu connexe

Similaire à Dependency Managers

Similaire à Dependency Managers (20)

Plus de NSCoder Mexico

Plus de NSCoder Mexico (20)

Dernier

Dernier (20)

Dependency Managers