Configuración ARM de Kushki iOS

Este artículo te guía en la configuración de la librería de Kushki para un procesador ARM (Apple Silicon M1/M2/M3). Así podrás hacer pruebas en dispositivos físicos o simuladores.

Prerrequisitos

Debes tener instalado CocoaPods.

Importante

Sigue estos pasos en el orden exacto para que el build sea exitoso.

1. Crea un proyecto nuevo en Xcode

A. Selecciona App.
B. Ponle un nombre y el identificador de la organización. En este caso, usaremos el nombre TestKushkiLib.
C. Selecciona el lugar donde vamos a guardar el proyecto nuevo (esto creará un repositorio git local).

2. Crea un Podfile

A. Abre una terminal en la raíz de tu proyecto y crea un Podfile con el comando:

B. Abre el Podfile recién creado y agrega la librería kushki-ios-arm como dependencia. Además, debes definir la variable platform como ios, '14.3'.

Este es el ejemplo completo:

C. Ejecuta el comando de instalación en la terminal, dentro de la carpeta donde está nuestro Podfile:

Cierra Xcode y abre el archivo TestKushkiLib.xcworkspace (icono blanco) que se creó. Contiene tanto tu proyecto como el enlace a los pods.

3. Agrega las librerías de Visa y Mastercard

A. Copia las librerías MastercardSonic.xcframework y VisaSensoryBranding.xcframework en tu carpeta principal TestKushkiLib (con Finder).

B. En Xcode, ve al proyecto TestKushkiLib (barra izquierda) -> TARGETS → TestKushkiLib -> Build Phases. En la sección Link Binary With Libraries, arrastra y suelta las librerías de Visa y Mastercard que acabas de copiar.

C. Ahora, ve al proyecto Pods (barra izquierda) -> TARGETS → kushki-ios-arm -> Build Phases. En la sección Link Binary With Libraries, haz clic en el signo + y agrega ahí también las librerías de Visa y Mastercard.

4. Configura el proyecto

A. Ve al proyecto TestKushkiLib -> TARGETS → TestKushkiLib -> Build Settings.
B. Busca el término sandboxing.
C. Define la propiedad User Script Sandboxing en No.

D. Ve al proyecto TestKushkiLib -> TARGETS → TestKushkiLib -> General.
E. En la sección Framework, Libraries and Embedded Content, verifica que la librería MastercardSonic.xcframework esté en Embed & Sign.

5. Cambia el framework de Cardinal

Paso crítico

Debes reemplazar el framework de Cardinal manualmente dentro de la carpeta Pods para que el proyecto compile correctamente en simuladores ARM.

A. Navega a esta ruta en la carpeta de tu proyecto:
TestKushkiLib/Pods/kushki-ios-arm/Frameworks
B. Elimina la carpeta CardinalMobile.framework existente.
C. Extrae el contenido del zip adjunto CardinalMobileiOSXC.zip.
D. Ve a la ruta CardinalMobile.xcframework/ios-arm64 del zip extraído.
E. Copia la carpeta CardinalMobile.framework que está ahí.
F. Pégala de vuelta en la ruta de tu proyecto: TestKushkiLib/Pods/kushki-ios-arm/Frameworks.

6. Crea un botón de prueba

En el archivo ContentView.swift de tu proyecto, agrega un botón con el código de solicitud del token para probar la integración.

7. Ejecuta la simulación 📲

Selecciona el simulador de destino (por ejemplo, iPhone 15) y presiona Run (Cmd + R). Haz clic en el botón "Charge" y revisa la consola para ver el resultado de la transacción.

1. Crea un proyecto nuevo en Xcode#

2. Crea un Podfile#

3. Agrega las librerías de Visa y Mastercard#

4. Configura el proyecto#

#

5. Cambia el framework de Cardinal#

6. Crea un botón de prueba#

7. Ejecuta la simulación 📲#

1. Crea un proyecto nuevo en Xcode

2. Crea un Podfile

3. Agrega las librerías de Visa y Mastercard

4. Configura el proyecto

5. Cambia el framework de Cardinal

6. Crea un botón de prueba

7. Ejecuta la simulación 📲