Ajouter un module tiers
Récupérez et liez un paquet externe.
Ajouter un module tiers est une leçon Zig Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Zig Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Zig Academy comprend 4 leçons au total.
Du manifeste au code
Une dépendance répertoriée dans build.zig.zon est téléchargée, mais pas encore utilisable. Vous devez la relier dans build.zig pour y accéder dans le code. 🔌
Première étape : zig fetch
Commencez par ajouter le paquet. zig fetch avec --save le télécharge et enregistre automatiquement son url et son hash dans votre manifeste.
zig fetch --save https://example.com/mylib-1.0.0.tar.gzLa rechercher dans build.zig
Dans build.zig, appelez b.dependency avec le nom indiqué dans votre manifeste. Cette fonction renvoie une référence vers le paquet téléchargé.
const dep = b.dependency("mylib", .{});Récupérer le module
À partir de cette référence, demandez un module nommé exposé par le paquet. Son auteur indique quel nom de module demander.
const mylib = dep.module("mylib");L'attacher à votre compilation
Rendez le module importable en l'ajoutant à votre exécutable avec addImport, en choisissant le nom que vous utiliserez dans le code.
exe.root_module.addImport("mylib", mylib);L'importer maintenant avec @import
Une fois attaché, le nom se comporte comme std. Utilisez @import avec cette chaîne n'importe où dans votre code source pour intégrer la bibliothèque.
const mylib = @import("mylib");Appeler la bibliothèque
Une fois l'importation liée à une constante, accédez à ses fonctions et types pub exactement comme dans n'importe quel autre module que vous avez écrit.
const result = mylib.doThing(42);Transmettre les options de compilation
Le deuxième argument de b.dependency transmet des options comme la cible et l'optimisation, afin que la dépendance soit compilée avec les mêmes paramètres que votre projet.
const dep = b.dependency("mylib", .{
.target = target,
});Lier également une bibliothèque C
Certains paquets fournissent une bibliothèque statique, et pas seulement un module. Vous pouvez utiliser linkLibrary avec son artefact lorsque le paquet en fournit un.
exe.linkLibrary(dep.artifact("mylib"));Compiler et exécuter
Enfin, exécutez zig build. Zig télécharge les éléments manquants, compile la dépendance et la lie à votre programme en une seule commande.
zig build runMettre à jour en retéléchargeant
Pour passer à une version plus récente, exécutez de nouveau zig fetch avec la nouvelle url. Le hachage est actualisé afin que la prochaine compilation récupère le code mis à jour.
zig fetch --save https://example.com/mylib-1.1.0.tar.gzVérification rapide
Rappelez-vous l'appel dans build.zig qui rend le module d'une dépendance importable.
Récapitulatif
Vous avez relié une dépendance de bout en bout : zig fetch, puis b.dependency, module et addImport dans build.zig, et enfin @import dans votre code. 🎯
Questions Fréquemment Posées
La leçon « Ajouter un module tiers » est-elle gratuite ?
Oui — le texte complet de « Ajouter un module tiers » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Zig Academy, passe à CoddyKit PRO. Le cours Zig Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Ajouter un module tiers » ?
Récupérez et liez un paquet externe. Tu pratiques Zig Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Zig Academy ?
Aucune expérience préalable n'est requise. Zig Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Ajouter un module tiers » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Zig Academy ?
Oui. Chaque leçon Zig Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Importer des fichiers avec @import
- Structurer un projet multi-fichiers
- build.zig.zon et le gestionnaire de paquets
- Ajouter un module tiers