서드 파티 모듈 추가하기
외부 패키지를 가져와 연결합니다.
서드 파티 모듈 추가하기은(는) CoddyKit의 무료 Zig Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Zig Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Zig Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
매니페스트에서 코드로
build.zig.zon에 나열한 의존 항목은 다운로드되지만 아직 사용할 수는 없습니다. 코드에서 접근하려면 build.zig에 연결해야 합니다. 🔌
1단계: zig fetch
패키지를 추가하는 것부터 시작합니다. --save와 함께 zig fetch를 실행하면 패키지를 다운로드하고 매니페스트에 url과 hash를 자동으로 기록합니다.
zig fetch --save https://example.com/mylib-1.0.0.tar.gzbuild.zig에서 조회하기
build.zig에서 매니페스트의 이름을 사용해 b.dependency를 호출하세요. 그러면 가져온 패키지를 가리키는 핸들이 반환됩니다.
const dep = b.dependency("mylib", .{});모듈 가져오기
그 핸들을 통해 패키지가 공개하는 이름 있는 module을 요청하세요. 어떤 모듈 이름을 요청해야 하는지는 패키지 작성자가 문서로 안내합니다.
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 같은 options를 전달하므로, 의존 항목도 사용자와 동일한 설정으로 빌드됩니다.
const dep = b.dependency("mylib", .{
.target = target,
});C 라이브러리도 연결하기
일부 패키지는 모듈뿐 아니라 정적 라이브러리도 제공합니다. 패키지가 산출물을 제공한다면 linkLibrary로 해당 산출물에 연결할 수 있습니다.
exe.linkLibrary(dep.artifact("mylib"));빌드하고 실행하기
마지막으로 zig build를 실행합니다. Zig가 누락된 항목을 모두 가져오고, 의존성을 컴파일한 다음, 한 번의 명령으로 프로그램에 연결합니다.
zig build run다시 가져와 업데이트하기
더 최신 버전으로 변경하려면 새 URL을 사용해 zig fetch를 다시 실행합니다. 해시를 갱신하므로 다음 빌드에서 업데이트된 코드를 가져옵니다.
zig fetch --save https://example.com/mylib-1.1.0.tar.gz빠른 확인
의존성의 모듈을 가져올 수 있게 만드는 build.zig 호출을 떠올려 보세요.
복습
의존성을 처음부터 끝까지 연결했습니다. zig fetch를 실행한 다음 build.zig에서 b.dependency, module, addImport를 사용하고, 마지막으로 코드에서 @import를 사용했습니다. 🎯
자주 묻는 질문
“서드 파티 모듈 추가하기” 강의는 무료인가요?
네 — “서드 파티 모듈 추가하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Zig Academy 강의 전체를 잠금 해제할 수 있습니다. Zig Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“서드 파티 모듈 추가하기”에서 뭘 배우나요?
외부 패키지를 가져와 연결합니다. 브라우저에서 직접 실행하는 실습 코드로 Zig Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Zig Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Zig Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“서드 파티 모듈 추가하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Zig Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Zig Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.