Transbank POS - SDK en C

Desarrollo

Descarga e instala la dependencia libserialport (instrucciones) git clone git://sigrok.org/libserialport

Controladores (Dependiendo del adaptador/puerto serial que tengas)

• USB Serial Chipset CH340 para Windows: http://www.wch.cn/download/CH341SER_EXE.html
• USB Serial Chipset CH340 para macOS: https://blog.sengotta.net/signed-mac-os-driver-for-winchiphead-ch340-serial-bridge/
• USB Serial Chipset Prolific para macOS: http://www.prolific.com.tw/US/ShowProduct.aspx?p_id=229&pcid=41

Windows 10

• Visual Studio 2017.

• msys2 - mingw-w64 sigue las instrucciones en la web:

  • Instala mingw
    • 32bits: pacman -S mingw-w64-i686-toolchain
    • 64bits: pacman -S mingw-w64-x86_64-toolchain
    • pacman -S base-devel
  • Install mingw cmocka
    • 32bits: pacman -S mingw32/mingw-w64-i686-cmocka
    • 64bits: pacman -S mingw64/mingw-w64-x86_64-cmocka

• Swig (puedes usar Chocolatey)

macOS

Estas instrucciones asumen que tienes instalado homebrew.

• brew install automake
• brew install autoconf
• brew install libtool
• brew install swig
• brew install cmocka

Unix

• build-essential
• automake
• autoconf
• libtool
• swig
• cmocka

Construir el Proyecto

Build

file = No es necesaio especificar la extensión

make build example=file

Ejecutar ejemplos

make run example=file

Debug

make debug example=file

Construir la libreria dylib MAC

Antes que nada es necesario asegurarse que la versión de java es la 8, para ello ejecute en la consola (Este cambio no es permanente, solo perdura mientras este activa la ventana de la consola):

export PATH="/Library/Java/JavaVirtualMachines/jdk1.8.0_251.jdk/Contents/Home/bin:$PATH"

adicionalmente asegurese de tener la variable JAVA_HOME creada (La variable es consultada durante la ejecución por lo que fallará si no existe)

export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.8.0_251.jdk/Contents/Home"

Crear la dylib

make dylibjava

Instalación

cp build/transbank.dll /ruta/en/tu/path

Test

Estamos usando cmocka para ejecutar los test unitarios. Una vez tengas cmocka instalado en tu maquina, debes ejecutar:

make cmocka-test

Generar una nueva versión

Para generar una nueva versión se debe crear un nuevo pull request que contenga:

1. Incrementar el número de versión en el archivo version.rc siguiendo la guía de SemVer.
2. Actualizar Changelog.md con los nuevos cambios/modificaciones incluidas en esta nueva versión.
3. Generar la DLL y el Wrapper (make dll).

Luego de mezclar el Pull Request:

1. Crear inmediatamente un release en GitHub.
2. Incluir en el Release de GitHub la DLL creada.
3. Incluir también libserialport-0.dll.