# Bibliotecas de terceros y marcos de trabajo Además del motor, una instalación de Devkron 2.0 lleva tres grupos de componentes que se usan con `#include`: las **bibliotecas estándar** (vienen con la distribución), las **bibliotecas de terceros** (se instalan aparte) y los **marcos de trabajo** de `dkl-web` (CRUD-L, FSO, webauth…), que también vienen con la distribución. Esta página explica dónde van, cómo instalarlos o actualizarlos y cómo comprobar que quedaron bien. Qué hace cada uno está en [Bibliotecas](/es/devkron/2.0/bibliotecas/) y [Marcos de trabajo](/es/devkron/2.0/marcos/). ## Regla general: junto a `dkl` Todo va en la **carpeta de la instalación**, junto a `dkl`, sin subcarpetas salvo las de los marcos (`crudl/`, `fso/`, `_templates/`): - `#include "x.dkh"` se busca en la carpeta del programa, en las rutas de `#path` y en la carpeta de `dkl`; - `_import_library("Devkron.Ext.X.dll")` sin ruta busca **solo en la carpeta de `dkl`**: por eso las DLL deben quedar ahí aunque copie el `.dkh` a otro lado. Después de instalar o actualizar cualquier componente con DLL, **reinicie el servidor FastCGI** (las DLL se cargan una vez por proceso). Si solo cambiaron archivos `.dkh`, `.dk` o `.dkl`, no hace falta. ## Bibliotecas estándar `http.dkh`, `threads.dkh`, `url.dkh`, `zip.dkh`, `time.dkh`, `text.dkh`, `hash.dkh`, `oauth.dkh`, `fs.dkh` y `log.dkh`, con sus DLL `Devkron.Ext.*.dll`, **vienen con la distribución**: no hay que instalar nada. Solo usan código de Induxsoft y del runtime incluido. Vea [Bibliotecas estándar](/es/devkron/2.0/bibliotecas/estandar/). ## Bibliotecas de terceros (dkl2-thirdparty) Las bibliotecas que dependen de componentes de código abierto de otros autores (CsvHelper, ClosedXML, PdfPig, Open XML SDK, Magick.NET, HtmlAgilityPack, Markdig) se distribuyen como un zip por biblioteca, `dkl2--.zip`, en la carpeta `2.0-LTS/thirdparty/` del repositorio de versiones, con su propio ciclo de versiones (vea [Descargas](/es/devkron/2.0/instalacion/descargas.md)): | Biblioteca | Encabezados | Para qué | |---|---|---| | csv | `csv.dkh` | leer y escribir CSV | | office | `xlsx.dkh`, `doc.dkh` | crear y leer Excel; texto de PDF, DOCX y XLSX | | image | `image.dkh` | tamaño, miniaturas, compresión y formato de imágenes | | html | `html.dkh` | descargar y analizar páginas, XPath | | markdown | `markdown.dkh` | Markdown a HTML | Cada 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. ### Instalar en Linux ```bash cd /opt/devkron sudo unzip -o ~/dkl2-csv-1.0.0.zip sudo chown -R root:root /opt/devkron && sudo chmod -R go-w /opt/devkron sudo systemctl restart devkron ``` ### Instalar en Windows En PowerShell como administrador, detenga el servidor FastCGI (las DLL cargadas quedan bloqueadas), descomprima y vuelva a arrancarlo: ```powershell Stop-ScheduledTask -TaskName "Devkron FastCGI" Expand-Archive -Path $HOME\Downloads\dkl2-csv-1.0.0.zip -DestinationPath C:\devkron -Force Start-ScheduledTask -TaskName "Devkron FastCGI" ``` La biblioteca **image** trae el nativo de ImageMagick para Linux x64 (`Magick.Native-Q16-HDRI-x64.dll.so`) y para 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" ref filas = csv.from_text("clave,nombre\nP-01,Lápiz\nP-02,Goma", "") do print(to.json(filas)) } ``` ```text [{"clave":"P-01","nombre":"L\u00E1piz"},{"clave":"P-02","nombre":"Goma"}] ``` Si la biblioteca no está instalada: ```text {9999} Error de sintaxis [prueba-csv.dkl] [9999] - No se puede encontrar el archivo csv.dkh[Ln= 4] ``` Los detalles de cada biblioteca están en [Bibliotecas de terceros](/es/devkron/2.0/bibliotecas/terceros/). ## Marcos de trabajo (dkl-web) Los marcos forman el paquete **dkl-web** (repositorio `Induxsoft/dkl-web`). La distribución de Devkron 2.0 ya los trae en la raíz de la instalación: ```text /opt/devkron/ ├── website.dkl webauth.dkl cookies.dkl uielements.dkl uielements.dbtable.dkl websencia.dkl createsite.dkl ├── _templates/sites/blank/ plantilla de sitio vacío ├── crudl/ marco CRUD-L └── fso/ API FSO ``` - Los archivos sueltos son bibliotecas: se incluyen por nombre (`#include "webauth.dkl"`). - `crudl/` y `fso/` se incluyen con su carpeta (`#include "crudl/crudl.dk"`); los comparten todos los sitios de la instancia. ### Comprobar que están ```bash ls /opt/devkron/crudl/controller.dkl /opt/devkron/fso/fso.dk /opt/devkron/webauth.dkl ``` Si faltan (por ejemplo, porque la distribución se publicó desde el código fuente sin dkl-web), cópielos del repositorio `dkl-web`: ```bash git clone https://github.com/Induxsoft/dkl-web.git /tmp/dkl-web sudo cp -r /tmp/dkl-web/src/* /opt/devkron/ ``` Quien compila el motor puede incluirlos al publicar con la opción `--dkl-web`: ```bash build/publish.sh linux-x64 /opt/devkron --dkl-web /ruta/a/dkl-web/src ``` En 2.0 dkl-web ya **no trae** la biblioteca Markdown (`markdig.dkl` y `Markdig.dll`): instale la biblioteca de terceros `markdown`. ### Actualizar un marco Copie los archivos nuevos encima de los anteriores. No requiere reiniciar el servidor (son archivos DKL), salvo que la actualización traiga DLL. Si modificó algún archivo de un marco, guarde sus cambios antes: la copia los sobrescribe. ## Errores típicos | Síntoma | Causa | Solución | |---|---|---| | `No se puede encontrar el archivo csv.dkh` | la biblioteca no está instalada o el `.dkh` quedó en otra carpeta | descomprima el zip junto a `dkl` | | `Could not load file or assembly '…/Devkron.Ext.Csv.dll'` | se copió el `.dkh` pero no la DLL | copie el zip completo junto a `dkl` | | `Could not load file or assembly 'CsvHelper…'` | falta una DLL de terceros del zip | descomprima el zip completo, sin elegir archivos | | la versión nueva no se nota | el servidor FastCGI tiene cargada la DLL anterior | reinícielo | | `No se puede encontrar el archivo crudl/crudl.dk` | dkl-web no está en la instalación | cópielo del repositorio `dkl-web` | | error al procesar imágenes en Linux: no encuentra `Magick.Native…` | se borró el nativo de Linux | vuelva a descomprimir el zip de image |