https://www.knightli.com/es/tags/c/ Recent content in C on KnightLi Blog Hugo -- gohugo.io es Thu, 30 Apr 2026 19:53:08 +0800 https://www.knightli.com/es/2026/04/30/compile-uefi-program-beginner-guide/ Thu, 30 Apr 2026 19:53:08 +0800 https://www.knightli.com/es/2026/04/30/compile-uefi-program-beginner-guide/ <p>Compilar su primer programa UEFI no es precisamente sencillo. La configuración del entorno puede llevar tiempo, los errores del vinculador son comunes y un programa <code>.EFI</code> no tiene la misma experiencia directa de edición y ejecución que una aplicación de escritorio normal.</p> <p>Este artículo organiza el tema desde la perspectiva de un principiante: si sólo desea compilar su primer programa UEFI, ¿por dónde debería empezar, qué conceptos importan primero y qué errores es más probable que aparezcan?</p> <h2 id="qué-es-un-programa-uefi">¿Qué es un programa UEFI? </h2><p>Un programa UEFI suele ser un archivo <code>.EFI</code>.</p> <p>No es un <code>.exe</code> ordinario en el que se hace doble clic en Windows. Es un ejecutable PE/COFF que se ejecuta dentro del entorno de firmware UEFI. Los casos de uso comunes incluyen:</p> <ul> <li>Gestores de arranque</li> <li>Herramientas de inicialización de hardware.</li> <li>Herramientas de actualización de firmware</li> <li>Herramientas de diagnóstico previas al arranque</li> <li>Flujos de arranque personalizados</li> </ul> <p>Muchas funciones que ve al principio del proceso de inicio del sistema pueden estar relacionadas con aplicaciones, controladores o servicios de firmware UEFI.</p> <p>Para los principiantes, no es necesario comprender inmediatamente el desarrollo completo del firmware. El primer objetivo es simple: compilar un archivo <code>.EFI</code> que pueda cargarse mediante un UEFI Shell o un emulador.</p> <h2 id="por-qué-no-empezar-con-edk-ii">¿Por qué no empezar con EDK II? </h2><p>El desarrollo real de UEFI a menudo implica EDK II.</p> <p>EDK II es completo y más cercano a la ingeniería de firmware real, pero no es muy amigable para principiantes:</p> <ul> <li>La estructura del proyecto es compleja.</li> <li>El sistema de construcción tiene una curva de aprendizaje.</li> <li>Las variables de entorno y la configuración de la cadena de herramientas implican muchos detalles.</li> <li>Los errores del compilador no siempre son fáciles de entender.</li> <li>Es fácil quedarse atascado en el entorno antes de escribir cualquier código.</li> </ul> <p>Si el objetivo es simplemente ejecutar un programa UEFI mínimo, un ejemplo ligero es un mejor punto de partida.</p> <p><a class="link" href="https://github.com/pbatard/uefi-simple" target="_blank" rel="noopener" >pbatard/uefi-simple</a> es uno de esos proyectos. Su objetivo es sencillo: proporcionar un ejemplo UEFI Hello World sencillo para que puedas compilar un archivo <code>.EFI</code> primero.</p> <h2 id="para-qué-sirve-uefi-simple">¿Para qué sirve <code>uefi-simple</code>? </h2><p><code>uefi-simple</code> es un buen primer paso para los principiantes en UEFI.</p> <p>Resuelve tres problemas prácticos:</p> <ul> <li>Le brinda una estructura de aplicación UEFI mínima y compilable.</li> <li>Evita la complejidad de grandes proyectos de firmware al principio</li> <li>Le permite verificar que compilar, vincular y ejecutar todo funciona.</li> </ul> <p>El proyecto admite múltiples métodos de compilación, incluidos Visual Studio 2022 y MinGW/gcc. También se puede probar con QEMU y OVMF.</p> <p>En otras palabras, no es necesario reiniciar repetidamente una máquina real para los primeros experimentos. Ejecutar primero el programa en un emulador es mucho más seguro.</p> <h2 id="qué-preparar-antes-de-comenzar">Qué preparar antes de comenzar </h2><p>Necesita al menos algunas categorías de herramientas.</p> <p>La primera categoría es la cadena de herramientas del compilador.</p> <p>En Windows, puedes comenzar con:</p> <ul> <li>Estudio Visual 2022</li> <li>O MinGW/gcc</li> </ul> <p>La segunda categoría es un entorno de ejecución UEFI.</p> <p>Hay dos opciones comunes:</p> <ul> <li>Ejecute el archivo <code>.EFI</code> en UEFI Shell de una máquina real</li> <li>Pruébalo en un entorno virtual con QEMU + OVMF</li> </ul> <p>La tercera categoría es un proyecto de ejemplo.</p> <p>Los principiantes no deberían empezar escribiendo scripts de compilación desde un directorio vacío. Usar un ejemplo mínimo como <code>uefi-simple</code> ayuda a evitar muchos problemas del sistema de compilación.</p> <h2 id="flujo-de-trabajo-básico">Flujo de trabajo básico </h2><p>Un flujo de trabajo mínimo de un programa UEFI se puede entender así.</p> <p>Primero, obtenga el proyecto de ejemplo.</p> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt">1 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="n">clone</span> <span class="n">https</span><span class="err">:</span><span class="p">//</span><span class="n">github</span><span class="p">.</span><span class="n">com</span><span class="p">/</span><span class="n">pbatard</span><span class="p">/</span><span class="nb">uefi-simple</span><span class="p">.</span><span class="py">git</span> </span></span></code></pre></td></tr></table> </div> </div><p>En segundo lugar, elija una cadena de herramientas de compilación. Si usa Visual Studio, cree con la solución Visual Studio en el proyecto.<br> Si usa MinGW/gcc, siga el Makefile o las instrucciones proporcionadas por el proyecto.</p> <p>En tercer lugar, genere el archivo <code>.EFI</code>.</p> <p>El punto clave aquí es confirmar la arquitectura de destino. Una PC común suele ser <code>x86_64</code>, es decir, un entorno UEFI de 64 bits.</p> <p>Cuarto, coloque el archivo <code>.EFI</code> en algún lugar al que pueda acceder UEFI Shell.</p> <p>En una máquina real, esto normalmente significa preparar una partición FAT32 o una unidad USB.<br> Con QEMU, puede montar un directorio o una imagen de disco.</p> <p>Quinto, ejecútelo en UEFI Shell.</p> <p>El resultado suele ser un resultado mínimo, como un mensaje estilo Hola mundo.</p> <h2 id="donde-los-principiantes-suelen-quedarse-estancados">Donde los principiantes suelen quedarse estancados </h2><p>La parte más difícil de compilar un programa UEFI no suele ser el lenguaje C en sí, sino el entorno y el proceso de vinculación.</p> <p>Los problemas comunes incluyen:</p> <ul> <li>Arquitectura de compilador incorrecta</li> <li>Formato de destino incorrecto</li> <li>Parámetros del enlazador incompletos</li> <li>Falta el punto de entrada UEFI</li> <li>Generar un ejecutable ordinario en lugar de un <code>.EFI</code> cargable por UEFI</li> <li>QEMU u OVMF no configurados correctamente</li> <li>Arranque seguro en una máquina real que bloquea un programa no firmado</li> </ul> <p>Los errores del vinculador son especialmente fáciles de malinterpretar como problemas de código.<br> En muchos casos, el verdadero problema es la función de entrada, el subsistema, la arquitectura de destino o el script del vinculador.</p> <p>Entonces, en la primera etapa, no se apresure a entrar en una lógica compleja. Asegúrese de que el ejemplo original se pueda compilar y ejecutar, luego cambie la salida poco a poco.</p> <h2 id="por-qué-utilizar-qemu--ovmf-para-realizar-pruebas">¿Por qué utilizar QEMU + OVMF para realizar pruebas? </h2><p>Es posible probar programas UEFI en una máquina real, pero no es conveniente en la etapa principiante.</p> <p>Es posible que tengas que repetir este ciclo:</p> <ul> <li>compilar</li> <li>Copiar a una unidad USB</li> <li>Reiniciar</li> <li>Ingrese al UEFI Shell</li> <li>Ejecutar el programa</li> <li>Registra el error</li> <li>Regresar al sistema y modificar el código.</li> </ul> <p>Ese bucle es lento.</p> <p>QEMU + OVMF le permite simular un entorno UEFI directamente dentro del sistema operativo. Puede verificar si un archivo <code>.EFI</code> se carga más rápidamente y es menos probable que afecte sus entradas de arranque reales.</p> <p>Una vez que el programa funciona básicamente, probarlo en una máquina real es mucho más manejable.</p> <h2 id="qué-deberían-modificar-primero-los-principiantes">¿Qué deberían modificar primero los principiantes? </h2><p>Si ya ha compilado su primer <code>.EFI</code> con el proyecto de ejemplo, no salte a funciones complejas de inmediato.</p> <p>Un mejor orden es:</p> <ol> <li>Cambie primero el texto de salida para confirmar que la recompilación realmente surte efecto.</li> <li>Intente leer información sencilla proporcionada por UEFI.</li> <li>Comprender la función de entrada, protocolo de salida y servicios básicos.</li> <li>Luego considere funciones más complejas, como sistemas de archivos, salida gráfica o administración de entradas de arranque.</li> </ol> <p>Este enfoque hace que cada paso sea verificable.<br> Si cambia demasiado a la vez, resulta difícil saber si el problema está en el código, el proceso de compilación o el entorno de ejecución.</p> <h2 id="en-qué-se-diferencia-de-un-programa-c-normal">¿En qué se diferencia de un programa C normal? </h2><p>Aunque los programas UEFI se pueden escribir en C, su entorno de ejecución es completamente diferente al de los programas C normales.</p> <p>Un programa C normal normalmente se ejecuta dentro de un sistema operativo y puede depender de la biblioteca, el sistema de archivos, el modelo de proceso y las llamadas al sistema estándar.</p> <p>Un programa UEFI se ejecuta antes de que se inicie el sistema operativo. Se basa en los servicios proporcionados por el firmware UEFI. Muchas cosas a las que está acostumbrado en los programas normales no están disponibles aquí automáticamente. Al escribir programas UEFI, es necesario adaptarse a varias diferencias:</p> <ul> <li>La función de entrada es diferente.</li> <li>La salida funciona de manera diferente</li> <li>Las bibliotecas disponibles son diferentes.</li> <li>El acceso a la memoria y a los archivos funciona de forma diferente</li> <li>La depuración funciona de manera diferente</li> </ul> <p>Es por esto que partir de un ejemplo mínimo es mejor que escribir código como si fuera un programa C normal.</p> <h2 id="un-camino-de-aprendizaje-práctico">Un camino de aprendizaje práctico </h2><p>Para principiantes, un camino realista es el siguiente:</p> <ul> <li>Paso 1: compilar <code>uefi-simple</code></li> <li>Paso 2: Ejecútelo con QEMU + OVMF</li> <li>Paso 3: Modificar la salida de Hola Mundo</li> <li>Paso 4: Comprenda cómo UEFI Shell carga <code>.EFI</code></li> <li>Paso 5: aprenda la función de entrada UEFI y el protocolo de salida básico</li> <li>Paso 6: Luego lea EDK II o material de desarrollo UEFI más completo</li> </ul> <p>El objetivo de este camino es construir primero un circuito de retroalimentación que funcione.</p> <p>Una vez que pueda generar un <code>.EFI</code> desde la fuente y ver el resultado en un entorno UEFI, ya habrá cruzado el primer umbral más difícil.</p> <h2 id="referencias">Referencias </h2><p>-<a class="link" href="https://github.com/pbatard/uefi-simple" target="_blank" rel="noopener" >pbatard/uefi-simple</a></p> <ul> <li>[Zhihu: material de compilación del programa UEFI] (<a class="link" href="https://zhuanlan.zhihu.com/p/643704056" target="_blank" rel="noopener" >https://zhuanlan.zhihu.com/p/643704056</a>)</li> </ul> <h2 id="pensamiento-final">Pensamiento final </h2><p>La parte difícil de compilar su primer programa UEFI generalmente no es escribir un poco de código C, sino conectar la cadena de herramientas, el formato de enlace y el entorno de ejecución.</p> <p>No se apresure a utilizar funciones complejas.<br> Comience con un ejemplo mínimo como &ldquo;uefi-simple&rdquo;, obtenga primero un &ldquo;.EFI&rdquo; ejecutable y luego comprenda gradualmente los puntos de entrada, protocolos y métodos de compilación de UEFI.</p>