0Pricing
Zig Academy · Lezione

Aggiungere un modulo di terze parti

Recuperi e colleghi un pacchetto esterno.

Aggiungere un modulo di terze parti è una lezione Zig Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Zig Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Zig Academy include 4 lezioni in totale.

Dal manifest al codice

Una dipendenza elencata in build.zig.zon viene scaricata, ma non è ancora utilizzabile. Deve collegarla in build.zig per poterla usare nel codice. 🔌

Passaggio uno: zig fetch

Inizi aggiungendo il pacchetto. zig fetch con --save lo scarica e registra automaticamente url e hash nel manifest.

zig fetch --save https://example.com/mylib-1.0.0.tar.gz

Cercarla in build.zig

In build.zig, chiami b.dependency usando il nome indicato nel manifest. Restituisce un handle al pacchetto scaricato.

const dep = b.dependency("mylib", .{});

Ottenere il modulo

Da quell'handle, richieda un module denominato esposto dal pacchetto. L'autore documenta il nome del modulo da richiedere.

const mylib = dep.module("mylib");

Collegarlo alla build

Renda il modulo importabile aggiungendolo al Suo eseguibile con addImport, scegliendo il nome che utilizzerà nel codice.

exe.root_module.addImport("mylib", mylib);

Ora usare @import

Una volta collegato, il nome si comporta come std. Usi @import con quella stringa in qualsiasi punto del sorgente per importare la libreria.

const mylib = @import("mylib");

Chiamare la libreria

Con l'importazione associata a una const, acceda alle funzioni e ai tipi pub esattamente come farebbe con qualsiasi altro modulo scritto da Lei.

const result = mylib.doThing(42);

Passare le opzioni di build

Il secondo argomento di b.dependency inoltra options come target e optimize, così la dipendenza viene compilata con le stesse impostazioni.

const dep = b.dependency("mylib", .{
    .target = target,
});

Collegare anche una libreria C

Alcuni pacchetti forniscono una libreria statica, non solo un modulo. Può usare linkLibrary con il relativo artifact quando il pacchetto ne mette a disposizione uno.

exe.linkLibrary(dep.artifact("mylib"));

Compilare ed eseguire

Infine, esegua zig build. Zig recupera ciò che manca, compila la dipendenza e la collega al programma con un solo comando.

zig build run

Aggiornare recuperando di nuovo

Per passare a una versione più recente, esegua di nuovo zig fetch con il nuovo url. In questo modo aggiorna l'hash, così la compilazione successiva recupera il codice aggiornato.

zig fetch --save https://example.com/mylib-1.1.0.tar.gz

Verifica rapida

Ricordi la chiamata in build.zig che rende importabile il modulo di una dipendenza.

Riepilogo

Ha collegato una dipendenza dall'inizio alla fine: zig fetch, poi b.dependency, module e addImport in build.zig, e infine @import nel codice. 🎯

Domande Frequenti

La lezione «Aggiungere un modulo di terze parti» è gratuita?

Sì — il testo completo di «Aggiungere un modulo di terze parti» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Zig Academy, passa a CoddyKit PRO. Il corso Zig Academy include 4 lezioni in totale.

Cosa imparerò in «Aggiungere un modulo di terze parti»?

Recuperi e colleghi un pacchetto esterno. Eserciti Zig Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Zig Academy?

Non è richiesta alcuna esperienza precedente. Zig Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Aggiungere un modulo di terze parti»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Zig Academy?

Sì. Ogni lezione Zig Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Importare file con @import
  2. Strutturare un progetto multi-file
  3. build.zig.zon e il Package Manager
  4. Aggiungere un modulo di terze parti
← Torna a Zig Academy