0Pricing
Zig Academy · Aula

Adicionando um módulo de terceiros

Baixe e vincule um pacote externo.

Adicionando um módulo de terceiros é uma aula grátis de Zig Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Zig Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Zig Academy inclui 4 aulas no total.

Do manifesto ao código

Uma dependência listada em build.zig.zon é baixada, mas ainda não pode ser usada. Você precisa conectá-la a build.zig para acessá-la no código. 🔌

Etapa um: zig fetch

Comece adicionando o pacote. zig fetch com --save faz o download e registra automaticamente a url e o hash no seu manifesto.

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

Procure-a em build.zig

Em build.zig, chame b.dependency com o nome do seu manifesto. Ele retorna uma referência ao pacote baixado.

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

Obtenha o módulo

A partir dessa referência, solicite um módulo nomeado que o pacote disponibiliza. O autor documenta qual nome de módulo deve ser solicitado.

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

Anexe-o à sua compilação

Faça com que o módulo possa ser importado adicionando-o ao seu executável com addImport e escolhendo o nome que você usará no código.

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

Agora faça @import dele

Depois de anexado, o nome se comporta como std. Use @import com essa string em qualquer parte do código-fonte para incluir a biblioteca.

const mylib = @import("mylib");

Chame a biblioteca

Com a importação vinculada a uma const, acesse suas funções e seus tipos pub exatamente como faria com qualquer outro módulo escrito por você.

const result = mylib.doThing(42);

Passe opções de compilação

O segundo argumento de b.dependency encaminha opções como target e optimize, para que a dependência seja compilada com as mesmas configurações que você usa.

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

Vincule também uma biblioteca C

Alguns pacotes fornecem uma biblioteca estática, não apenas um módulo. Você pode usar linkLibrary com o artefato quando o pacote disponibilizar um.

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

Compile e execute

Por fim, execute zig build. O Zig busca o que estiver faltando, compila a dependência e a vincula ao seu programa com um único comando.

zig build run

Atualizar buscando novamente

Para mudar para uma versão mais recente, execute zig fetch novamente com a nova URL. O comando atualiza o hash para que a próxima compilação busque o código atualizado.

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

Verificação rápida

Recupere a chamada em build.zig que torna o módulo de uma dependência importável.

Recapitulação

Você conectou uma dependência de ponta a ponta: zig fetch, depois b.dependency, module e addImport em build.zig e, por fim, @import no seu código. 🎯

Perguntas Frequentes

A aula “Adicionando um módulo de terceiros” é grátis?

Sim — o texto completo de “Adicionando um módulo de terceiros” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Zig Academy, atualize para CoddyKit PRO. O curso de Zig Academy inclui 4 aulas no total.

O que vou aprender em “Adicionando um módulo de terceiros”?

Baixe e vincule um pacote externo. Você pratica Zig Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Zig Academy?

Nenhuma experiência prévia é necessária. Zig Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Adicionando um módulo de terceiros”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Zig Academy?

Sim. Cada aula de Zig Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Importando arquivos com @import
  2. Estruturando um projeto com vários arquivos
  3. build.zig.zon e o gerenciador de pacotes
  4. Adicionando um módulo de terceiros
← Voltar para Zig Academy