Añadir un módulo de terceros
Descargue y vincule un paquete externo.
Añadir un módulo de terceros es una lección gratuita de Zig Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Zig Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Zig Academy incluye 4 lecciones en total.
Del manifiesto al código
Una dependencia enumerada en build.zig.zon se descarga, pero todavía no se puede utilizar. Debe conectarla en build.zig para acceder a ella desde el código. 🔌
Paso uno: zig fetch
Comience añadiendo el paquete. zig fetch con --save lo descarga y registra automáticamente su url y hash en el manifiesto.
zig fetch --save https://example.com/mylib-1.0.0.tar.gzBuscarla en build.zig
En build.zig, llame a b.dependency con el nombre del manifiesto. Esto devuelve un identificador del paquete descargado.
const dep = b.dependency("mylib", .{});Obtener el módulo
A partir de ese identificador, solicite un módulo con nombre que el paquete exponga. El autor documenta qué nombre de módulo debe solicitar.
const mylib = dep.module("mylib");Vincularlo a su compilación
Haga que el módulo pueda importarse añadiéndolo a su ejecutable con addImport y eligiendo el nombre que utilizará en el código.
exe.root_module.addImport("mylib", mylib);Ahora use @import
Una vez vinculado, el nombre se comporta como std. Use @import con esa cadena en cualquier parte del código fuente para incorporar la biblioteca.
const mylib = @import("mylib");Llamar a la biblioteca
Con la importación vinculada a una constante, acceda a sus funciones y tipos pub exactamente igual que a los de cualquier otro módulo que haya escrito.
const result = mylib.doThing(42);Pasar opciones de compilación
El segundo argumento de b.dependency reenvía options como target y optimize, para que la dependencia se compile con la misma configuración que su proyecto.
const dep = b.dependency("mylib", .{
.target = target,
});Vincular también una biblioteca de C
Algunos paquetes incluyen una biblioteca estática, no solo un módulo. Puede usar linkLibrary con su artefacto cuando el paquete proporcione uno.
exe.linkLibrary(dep.artifact("mylib"));Compilar y ejecutar
Por último, ejecute zig build. Zig descarga lo que falte, compila la dependencia y la vincula al programa con un solo comando.
zig build runActualizar volviendo a descargar
Para cambiar a una versión más reciente, vuelva a ejecutar zig fetch con la nueva url. Esto actualiza el hash para que la siguiente compilación descargue el código actualizado.
zig fetch --save https://example.com/mylib-1.1.0.tar.gzComprobación rápida
Recuerde qué llamada de build.zig hace que el módulo de una dependencia pueda importarse.
Repaso
Conectó una dependencia de principio a fin: zig fetch, después b.dependency, module y addImport en build.zig, y finalmente @import en el código. 🎯
Preguntas frecuentes
¿La lección «Añadir un módulo de terceros» es gratis?
Sí — el texto completo de «Añadir un módulo de terceros» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Zig Academy, actualiza a CoddyKit PRO. El curso de Zig Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Añadir un módulo de terceros»?
Descargue y vincule un paquete externo. Practicas Zig Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Zig Academy?
No se requiere experiencia previa. Zig Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Añadir un módulo de terceros»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Zig Academy?
Sí. Cada lección de Zig Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Importar archivos con @import
- Estructuración de un proyecto con varios archivos
- build.zig.zon y el gestor de paquetes
- Añadir un módulo de terceros