Listado completo de las directivas admitidas en archivos de configuración .hbc para hbmk2 (Harbour Build Tool):
Code: Select all
1. Archivos de Entrada y Fuentes
sources=: Lista de archivos fuente a incluir (archivos .prg, .c, .cpp, .rc, etc.).
headers=: Lista de cabeceras .ch que se incluirán de forma estándar.
libs=: Librerías adicionales a enlazar (equivalente a la opción -l).
syslibs=: Librerías de sistema que se enlazan antes de las librerías comunes.
frameworks=: Frameworks de macOS a vincular (solo para plataforma Darwin/macOS).
hbcs=: Incluye o anida otros archivos .hbc por nombre.
requests=: Lista de funciones o símbolos para forzar su inclusión en el ejecutable (fuerza el enlazado/linkeo).
2. Rutas de Búsqueda
incpaths=: Directorios donde buscar archivos de cabecera (.h, .ch).
libpaths=: Directorios adicionales donde buscar archivos de librería (.lib, .a).
instpaths=: Rutas de destino para copiar o instalar los archivos generados.
instfiles=: Archivos adicionales que se deben copiar a las rutas de instpaths=.
3. Modos de Compilación y Opciones Booleanas (yes / no)
gui=: Define el tipo de aplicación (yes = GUI / subsistema Windows, no = consola/STD).
mt=: Habilita el soporte multihilo de Harbour (yes = -mt, no = monohilo).
debug=: Agrega información de depuración (yes / no).
inc=: Activa la compilación incremental (yes / no).
shared=: Genera/vincula librerías dinámicas (yes) o estáticas (no).
fullstatic=: Enlaza todas las librerías de forma totalmente estática (yes / no).
cpp=: Fuerza o selecciona el modo C++ (yes, no o def).
winuni=: Selecciona el modo Unicode/WIDE en Windows (yes / no).
strip=: Elimina los símbolos de depuración del binario final (yes / no).
run=: Ejecuta el binario automáticamente al finalizar la compilación (yes / no).
map=: Genera un archivo .map del enlazador (yes / no).
optim=: Activa las optimizaciones del compilador C (yes / no).
4. Banderas Específicas para Herramientas (Flags)
prgflags=: Banderas que se pasan directamente al compilador de Harbour (harbour.exe).
cflags=: Banderas que se pasan al compilador C (gcc, msvc, etc.).
ldflags= / ldflags+=: Banderas que se pasan al enlazador (linker).
resflags=: Banderas para el compilador de recursos (windres / rc).
warn=: Nivel de advertencias del compilador C (max, yes, low, no, def).
compr=: Compresión del ejecutable con UPX (yes, no, min, max).
5. Configuración de Terminal / GT (Graphic Terminal)
gt=: Selecciona el controlador GT a enlazar (ej. gtwin, gtwvt, gtgui).
gtdef=: Define cuál controlador GT de la lista será el predeterminado en tiempo de ejecución.
nodefgt=: Evita vincular los controladores GT predeterminados (yes / no).
6. Metadatos del Paquete y Control
name=: Nombre del paquete o biblioteca.
description=: Descripción breve del paquete.
version=: Versión del paquete (ej. 1.0.0).
licences=: Lista de licencias aplicables al proyecto.
echo=: Muestra un texto en la consola de compilación.
skip=: Salta el procesamiento del resto del archivo .hbc si se cumple una condición.
stop=: Detiene el proceso de compilación enviando un mensaje opcional.
Code: Select all
1. Input and source files
sources=: List of source files to include (.prg, .c, .cpp, .rc files, etc.).
headers=: List of .ch headers to be included by default.
libs=: Additional libraries to load (equivalent to the -l option).
syslibs=: System libraries linked before common libraries.
frameworks=: macOS frameworks to link (Darwin/macOS platform only).
hbcs=: Include or add other .hbc files by name.
requests=: List of functions or symbols to force their inclusion in the executable.
2. Search paths
incpaths=: Directories to search for header files (.h, .ch).
libpaths=: Additional directories to search for library files (.lib, .a).
instpaths=: Destination paths for copying or installing generated files.
instfiles=: Additional files to be copied to the paths specified in instpaths=.
3. Compilation modes and boolean options (yes / no)
gui=: Defines the application type (yes = GUI / Windows subsystem, no = console/STD).
mt=: Enables Harbour multithreading support (yes = -mt, no = single-threaded).
debug=: Adds debugging information (yes / no).
inc=: Enables incremental compilation (yes / no).
shared=: Generates/links dynamic libraries (yes) or static ones (no).
fullstatic=: Links all libraries fully statically (yes / no).
cpp=: Selects C++ mode (yes; no is the default).
winuni=: Selects Unicode/WIDE mode on Windows (yes / no).
strip=: Removes debug symbols from the final binary (yes / no).
run=: Automatically executes the binary after compilation finishes (yes / no).
map=: Generates a .map file (yes / no).
optim=: Enables C compiler optimizations (yes / no).
4. Specific Tool Flags
prgflags=: Flags passed directly to the Harbour compiler (harbour.exe).
cflags=: Flags passed to the C compiler (gcc, msvc, etc.).
ldflags= / ldflags+=: Flags passed to the linker.
resflags=: Flags for the resource compiler (windres / rc).
warn=: C compiler warning level (max, yes, low, no, def).
compr=: Executable compression using UPX (yes, no, min, max).
5. Terminal / GT (Graphic Terminal) Configuration
gt=: Selects the GT driver to link (e.g., gtwin, gtwvt, gtgui).
gtdef=: Defines which GT driver from the list will be the default at runtime.
nodefgt=: Prevents linking default GT drivers (yes / no).
6. Package Metadata and Control
name=: Name of the package or library.
description=: Brief description of the package.
version=: Package version (e.g., 1.0.0).
licences=: List of licenses applicable to the project.
echo=: Displays text in the build console.
skip=: Skips processing the remainder of the .hbc file if a condition is met.
stop=: Stops the build process, optionally displaying a message.
