Добавление стороннего модуля
Загрузите и подключите внешний пакет.
«Добавление стороннего модуля» — бесплатный урок Zig Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Zig Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Zig Academy содержит 4 уроков всего.
От манифеста к коду
Зависимость, указанная в build.zig.zon, скачана, но ещё недоступна для использования. Необходимо связать её с build.zig, чтобы обращаться к ней в коде. 🔌
Шаг первый: zig fetch
Начните с добавления пакета. Команда zig fetch с флагом --save скачивает его и автоматически записывает url и hash в манифест.
zig fetch --save https://example.com/mylib-1.0.0.tar.gzНайдите его в build.zig
В build.zig вызовите b.dependency, указав имя из манифеста. Он возвращает дескриптор скачанного пакета.
const dep = b.dependency("mylib", .{});Получите модуль
Используя этот дескриптор, запросите именованный модуль, который предоставляет пакет. Автор документирует имя модуля, которое нужно запросить.
const mylib = dep.module("mylib");Подключите его к сборке
Сделайте модуль доступным для импорта, добавив его к исполняемому файлу с помощью addImport и выбрав имя, которое будете использовать в коде.
exe.root_module.addImport("mylib", mylib);Теперь импортируйте его через @import
После подключения это имя ведёт себя как std. Используйте @import с этой строкой в любом месте исходного кода, чтобы подключить библиотеку.
const mylib = @import("mylib");Вызовите библиотеку
Связав импорт с const, обращайтесь к его функциям и типам pub точно так же, как к любому другому написанному Вами модулю.
const result = mylib.doThing(42);Передайте параметры сборки
Второй аргумент b.dependency передаёт параметры, такие как target и optimize, поэтому зависимость собирается с теми же настройками, что и Ваш код.
const dep = b.dependency("mylib", .{
.target = target,
});Свяжите также библиотеку C
Некоторые пакеты поставляются со статической библиотекой, а не только с модулем. Если пакет предоставляет такой артефакт, его можно связать с помощью linkLibrary.
exe.linkLibrary(dep.artifact("mylib"));Соберите и запустите
Наконец выполните zig build. Zig загрузит всё недостающее, скомпилирует зависимость и подключит её к вашей программе одной командой.
zig build runОбновление повторной загрузкой
Чтобы перейти на более новую версию, снова выполните zig fetch с новым URL. Команда обновит хеш, чтобы при следующей сборке загрузился обновлённый код.
zig fetch --save https://example.com/mylib-1.1.0.tar.gzБыстрая проверка
Вспомните вызов в build.zig, который делает модуль зависимости доступным для импорта.
Итоги
Вы подключили зависимость от начала до конца: zig fetch, затем b.dependency, module и addImport в build.zig и наконец @import в своём коде. 🎯
Часто задаваемые вопросы
Урок «Добавление стороннего модуля» бесплатный?
Да — полный текст урока «Добавление стороннего модуля» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Zig Academy, подпишись на CoddyKit PRO. Курс Zig Academy содержит 4 уроков всего.
Чему я научусь в уроке «Добавление стороннего модуля»?
Загрузите и подключите внешний пакет. Ты практикуешь Zig Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Zig Academy?
Предыдущий опыт не требуется. Zig Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.
Сколько времени занимает урок «Добавление стороннего модуля»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Zig Academy?
Да. Каждый урок Zig Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Импорт файлов с помощью @import
- Структура проекта из нескольких файлов
- build.zig.zon и менеджер пакетов
- Добавление стороннего модуля