Zig 创建 C 库

Question

已关闭- 请参阅条目末尾

我想使用 Zig 语言制作一个 C 可调用库。我决定从 Zig 文档中的两个示例开始。“导出 C 库”和“混合目标文件”。在每种情况下，我都复制了三个相关文件（来自 0.6.0 文档）。

• AC文件名为test.c，
• 分别名为 mathtest.zig（对于导出 C 库示例）和 base64.zig（对于混合对象文件示例）的 zig 文件，以及
• 一个 build.zig 文件。

这两个示例都无法构建。

导出 C 库示例无法编译 test.c，并显示消息无法找到 mathtest.h

混合对象文件示例无法编译 test.c，并且找不到 base64.h

以下是导出 C 库示例的三个文件：

数学测试.zig

export fn add(a: i32, b: i32) i32 {
    return a + b;
}

测试.c

// This header is generated by zig from mathtest.zig
#include "mathtest.h"
#include <stdio.h>

int main(int argc, char **argv) {
    int32_t result = add(42, 1337);
    printf("%d\n", result);
    return 0;
}

构建.zig

const Builder = @import("std").build.Builder;

pub fn build(b: *Builder) void {
    const lib = b.addSharedLibrary("mathtest", "mathtest.zig", b.version(1, 0, 0));

    const exe = b.addExecutable("test", null);
    exe.addCSourceFile("test.c", &[_][]const u8{"-std=c99"});
    exe.linkLibrary(lib);
    exe.linkSystemLibrary("c");

    b.default_step.dependOn(&exe.step);

    const run_cmd = exe.run();

    const test_step = b.step("test", "Test the program");
    test_step.dependOn(&run_cmd.step);
}

部分错误信息

~/Projects/zig/z-c-lib $ zig build test
/home/robert/Projects/zig/z-c-lib/test.c:2:10: fatal error: 'mathtest.h' file not found
#include "mathtest.h"
         ^~~~~~~~~~~~
1 error generated.

The following command failed:
/home/robert/zig/zig clang -c -nostdinc -fno-spell-checking -target x86_64-unknown-linux-gnu -isystem /home/robert/zig/lib/zig/include -isystem /home/robert/zig/lib/zig/libc/include/x86_64-linux-gnu -isystem /home/robert/zig/lib/zig/libc/include/generic-glibc -isystem /home/robert/zig/lib/zig/libc/include/x86_64-linux-any -isystem /home/robert/zig/lib/zig/libc/include/any-linux-any -Xclang -target-cpu -Xclang znver2 -Xclang -target-feature -Xclang -3dnow -Xclang -target-feature -Xclang -3dnowa -Xclang -target-feature -Xclang +64bit -Xclang -target-feature -Xclang +adx -Xclang -target-feature -Xclang +aes -Xclang -target-feature -Xclang +avx -Xclang -target-feature -Xclang +avx2 -Xclang -target-feature -Xclang -avx512bf16 -Xclang -target-feature -Xclang -avx512b

我找不到mathtest.h在我的系统上命名的文件，因此我认为它没有生成，这与 test.c 文件中的声明相反。

我缺少什么？帮助感激地接受了。

答案和更多问题

我发现了以下-femit-h选项：

zig build-lib mathtest.zig -femit-h

将创建一个mathtest.h文件，然后

zig build

将会成功。

build.zig我进一步发现文件中的这些行

const lib = b.addSharedLibrary('mathtest', 'mathtest.zig', b.version(1, 0, 0));
lib.femit_h = true;

将确保

zig build test

将成功并生成答案 1379，如文档中所示。

mathtest.h但是 - build.zig 文件的此 mod在运行后不会留下文件。

这似乎是从 Zig 代码生成可用 C 库的最后障碍。

拼图中的最后一块

如果我添加

lib.setOutputDir("build");

到build.zig文件。和mathtest.h（libmathtest.a或 .so）文件将保存到build目录中。

称此为结束

Answer 1

好吧，答案的一部分很简单，但可能很模糊，-femit-h 选项。命令

zig build-lib mathtest.zig -femit-h

将生成一个mathtest.h文件。但是我如何将该选项添加到

const lib = b.addSharedLibrary("mathtest", "mathtest.zig", b.version(1, 0, 0));

build.zig 文件中的行。