# Bibliotecas de terceros Estas bibliotecas amplían Devkron 2.0 LTS con funciones que dependen de componentes de código abierto de otros autores: CsvHelper, ClosedXML, PdfPig, Open XML SDK, Magick.NET (ImageMagick), HtmlAgilityPack y Markdig. Cada una se publica en el repositorio `Induxsoft/dkl2-thirdparty` y se distribuye como un archivo zip independiente. Esta sección es para el programador que necesita leer o generar CSV y Excel, sacar texto de PDF, procesar imágenes, leer páginas web o mostrar Markdown. ## Por qué se instalan aparte - **El motor queda chico y sin dependencias externas.** La distribución de Devkron 2.0 no incluye componentes de otros autores; las [bibliotecas estándar](/es/devkron/2.0/bibliotecas/estandar/) tampoco. - **Cada servidor instala solo lo que usa.** ImageMagick, por ejemplo, ocupa decenas de MB e incluye bibliotecas nativas por plataforma. - **Se actualizan a su ritmo.** Una corrección en la biblioteca de Excel no obliga a publicar otro motor, y viceversa. - **Licencias claras.** Cada zip trae los avisos de licencia de los componentes que incluye. ## Contenido | Biblioteca | Encabezados | Para qué sirve | Componente de terceros | |---|---|---|---| | [csv](/es/devkron/2.0/bibliotecas/terceros/csv.md) | `csv.dkh` | Leer y escribir CSV con separador detectado | CsvHelper 33.1.0 | | [office](/es/devkron/2.0/bibliotecas/terceros/office.md) | `xlsx.dkh`, `doc.dkh` | Crear y leer Excel; texto de PDF, DOCX y XLSX | ClosedXML 0.105.1, PdfPig 0.1.16, Open XML SDK 3.5.1 | | [image](/es/devkron/2.0/bibliotecas/terceros/image.md) | `image.dkh` | Tamaño, miniaturas, compresión y formato de imágenes | Magick.NET 15.0.0 (ImageMagick 7.1) | | [html](/es/devkron/2.0/bibliotecas/terceros/html.md) | `html.dkh` | Descargar y analizar páginas, XPath | HtmlAgilityPack 1.13.1 | | [markdown](/es/devkron/2.0/bibliotecas/terceros/markdown.md) | `markdown.dkh` | Markdown a HTML | Markdig 1.5.0 | ## Cómo instalar una biblioteca Cada biblioteca se entrega como `dkl2--.zip` (por ejemplo `dkl2-csv-1.0.0.zip`). El zip trae la DLL de Induxsoft (`Devkron.Ext.*.dll`), las DLL de terceros que necesita, los encabezados `.dkh` y los avisos de licencia, todo en la raíz. 1. Localice la carpeta donde está el ejecutable `dkl` (y el servidor FastCGI, si es otra carpeta). 2. Descomprima el zip **en esa misma carpeta**, junto a `dkl`, sin subcarpetas. 3. Si el servidor FastCGI ya estaba corriendo, **reinícielo**: las DLL se cargan una sola vez por proceso. 4. Incluya el encabezado en su programa con `#include "csv.dkh"`. En Linux: ```bash cd /opt/devkron sudo unzip -o ~/dkl2-csv-1.0.0.zip sudo systemctl restart devkron ``` En Windows (PowerShell como administrador), descomprima y luego detenga y vuelva a lanzar `dkl -fastcgi` (por ejemplo, la tarea del Programador de tareas que lo inicia): ```powershell Expand-Archive -Path $HOME\Downloads\dkl2-csv-1.0.0.zip -DestinationPath C:\devkron -Force ``` La carpeta (`/opt/devkron`, `/usr/devkron`, `C:\devkron` u otra) y el nombre del servicio dependen de su instalación. ### Cómo se encuentran los archivos - `#include "csv.dkh"` se busca en la carpeta del programa, en las carpetas de `#path` y en la carpeta de `dkl`. - Cada `.dkh` carga su DLL con `_import_library("Devkron.Ext.Csv.dll")`, sin ruta, que se busca **en la carpeta de `dkl`**. Por eso las DLL deben quedar junto a `dkl`, aunque copie el `.dkh` a otro lado. - La biblioteca **image** trae además el nativo de ImageMagick para Linux x64 (`Magick.Native-Q16-HDRI-x64.dll.so`) y Windows x64 (`Magick.Native-Q16-HDRI-x64.dll`); puede borrar el que no corresponda a su servidor. ### Comprobar la instalación ```dkl #include "dkli.dkh" #! program "prueba csv" { #include "functions.dkh" #include "serialize.dkh" #include "csv.dkh" do print(to.json(csv.from_text("a,b\n1,2\n", "a"))) } ``` Salida: ``` [{"a":1,"b":"2"}] ``` Si falta la DLL verá un error de `_import_library` al incluir el encabezado; si falta una dependencia (por ejemplo `CsvHelper.dll`), el error aparece en la primera llamada. En los dos casos vuelva a descomprimir el zip completo junto a `dkl`. ### Actualizar una biblioteca Para pasar a una versión nueva, descomprima el zip nuevo sobre la misma carpeta (reemplaza la DLL, sus dependencias y el `.dkh`) y reinicie el servidor FastCGI: una DLL ya cargada no se reemplaza mientras el proceso sigue vivo. Los programas de consola toman la versión nueva en la siguiente ejecución. ## Licencias - El código de Induxsoft (las DLL `Devkron.Ext.*` y los `.dkh`) se distribuye bajo la **licencia Apache 2.0**. Cada zip la incluye como `dkl2-.LICENSE.txt`. - Los componentes de terceros se incluyen **sin modificar**, cada uno bajo su propia licencia, detallada en `dkl2-.LICENSE-THIRDPARTY.txt` dentro del zip. | Componente | Licencia | |---|---| | CsvHelper | MS-PL o Apache 2.0 (Induxsoft la redistribuye bajo Apache 2.0) | | ClosedXML, ClosedXML.Parser, Open XML SDK, ExcelNumberFormat, RBush, System.IO.Packaging | MIT | | PdfPig, SixLabors.Fonts | Apache 2.0 | | Magick.NET | Apache 2.0 | | ImageMagick (en los nativos) | ImageMagick License, derivada de Apache 2.0; los nativos incluyen además bibliotecas con licencias BSD, MIT, zlib, MPL y LGPL, detalladas en `dkl2-image.NOTICE-Magick.NET.txt` | | HtmlAgilityPack | MIT | | Markdig | BSD de 2 cláusulas | Todas permiten el uso comercial y la redistribución conservando los avisos de copyright: si entrega estas bibliotecas a un cliente, entregue el zip completo con sus archivos de licencia. ## Extensiones anteriores Las extensiones .NET que ya usaba con Devkron 1.x funcionan en 2.0 sin recompilar. Para código nuevo use las de esta sección. Si una extensión anterior define funciones con los mismos nombres que una de estas bibliotecas (por ejemplo `image.size` o `image.resize`), no incluya los dos encabezados en el mismo programa.