Dodawanie modułu zewnętrznego
Pobierz i dołącz pakiet zewnętrzny.
Dodawanie modułu zewnętrznego to bezpłatna lekcja Zig Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Zig Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Zig Academy zawiera 4 lekcji w sumie.
Od manifestu do kodu
Zależność wymieniona w build.zig.zon zostaje pobrana, ale nie jest jeszcze gotowa do użycia. Aby uzyskać do niej dostęp w kodzie, trzeba połączyć ją w build.zig. 🔌
Krok pierwszy: zig fetch
Najpierw dodaj pakiet. zig fetch z opcją --save pobiera go i automatycznie zapisuje jego url oraz hash w manifeście.
zig fetch --save https://example.com/mylib-1.0.0.tar.gzWyszukaj go w build.zig
W build.zig wywołaj b.dependency, podając nazwę z manifestu. Zwraca ono uchwyt do pobranego pakietu.
const dep = b.dependency("mylib", .{});Pobierz moduł
Za pomocą tego uchwytu poproś o nazwany moduł udostępniany przez pakiet. Autor dokumentuje nazwę modułu, o którą należy poprosić.
const mylib = dep.module("mylib");Dołącz go do procesu budowania
Uczyń moduł dostępnym dla importów, dodając go do pliku wykonywalnego za pomocą addImport i wybierając nazwę używaną w kodzie.
exe.root_module.addImport("mylib", mylib);Teraz zaimportuj go za pomocą @import
Po dołączeniu nazwa zachowuje się jak std. Użyj @import z tym ciągiem znaków w dowolnym miejscu kodu źródłowego, aby dołączyć bibliotekę.
const mylib = @import("mylib");Wywołaj bibliotekę
Po przypisaniu importu do stałej uzyskaj dostęp do jej funkcji i typów pub dokładnie tak samo jak do elementów dowolnego innego napisanego przez siebie modułu.
const result = mylib.doThing(42);Przekaż opcje budowania
Drugi argument b.dependency przekazuje opcje, takie jak target i optimize, dzięki czemu zależność jest budowana z tymi samymi ustawieniami co projekt.
const dep = b.dependency("mylib", .{
.target = target,
});Połącz także bibliotekę C
Niektóre pakiety zawierają bibliotekę statyczną, a nie tylko moduł. Jeśli pakiet ją udostępnia, można połączyć z jej artefaktem za pomocą linkLibrary.
exe.linkLibrary(dep.artifact("mylib"));Kompiluj i uruchamiaj
Na koniec uruchom zig build. Zig pobierze wszystkie brakujące elementy, skompiluje zależność i połączy ją z programem za pomocą jednego polecenia.
zig build runAktualizacja przez ponowne pobranie
Aby przejść na nowszą wersję, ponownie uruchom zig fetch z nowym adresem URL. Spowoduje to odświeżenie skrótu, dzięki czemu podczas następnego kompilowania zostanie pobrany zaktualizowany kod.
zig fetch --save https://example.com/mylib-1.1.0.tar.gzSzybkie sprawdzenie
Przypomnij sobie wywołanie w build.zig, które sprawia, że moduł zależności można importować.
Podsumowanie
Podłączyłeś zależność od początku do końca: zig fetch, następnie b.dependency, module i addImport w build.zig, a na końcu @import w kodzie. 🎯
Często zadawane pytania
Czy lekcja „Dodawanie modułu zewnętrznego” jest bezpłatna?
Tak — pełny tekst „Dodawanie modułu zewnętrznego” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Zig Academy, przejdź na CoddyKit PRO. Kurs Zig Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Dodawanie modułu zewnętrznego”?
Pobierz i dołącz pakiet zewnętrzny. Ćwiczysz Zig Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Zig Academy?
Nie wymagamy żadnego doświadczenia. Zig Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Dodawanie modułu zewnętrznego”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Zig Academy?
Tak. Każda lekcja Zig Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Importowanie plików za pomocą @import
- Strukturyzowanie projektu wieloplikowego
- build.zig.zon i menedżer pakietów
- Dodawanie modułu zewnętrznego