mirrors/zig
1
0
Fork 0
mirror of https://codeberg.org/ziglang/zig.git synced 2025-12-06 05:44:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

std.Build: add addLibrary function (#22554)

Browse source 
Acts as a replacement for `addSharedLibrary` and `addStaticLibrary`, but
linking mode can be changed more easily in build.zig, for example:

In library:
```zig
const linkage = b.option(std.builtin.LinkMode, "linkage", "Link mode for a foo_bar library") orelse .static; // or other default

const lib = b.addLibrary(.{
    .linkage = linkage,
    .name = "foo_bar",
    .root_module = mod,
});
```

In consumer:
```zig
const dep_foo_bar = b.dependency("foo_bar", .{
    .target = target,
    .optimize = optimize,
    .linkage = .static // or dynamic
});

mod.linkLibrary(dep_foor_bar.artifact("foo_bar"));
```

It also matches nicely with `linkLibrary` name.

Signed-off-by: Eric Joldasov <bratishkaerik@landless-city.net>
This commit is contained in:
BratishkaErik 2025-01-22 07:29:21 +05:00 • committed by GitHub
parent 28a259d4a3
commit 941677e083
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
19 changed files with 86 additions and 26 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
lib/init/build.zig
View file

@ -47,7 +47,8 @@ pub fn build(b: *std.Build) void {
// Now, we will create a static library based on the module we created above.
// This creates a `std.Build.Step.Compile`, which is the build step responsible
// for actually invoking the compiler.
const lib = b.addStaticLibrary(.{
const lib = b.addLibrary(.{
.linkage = .static,
.name = "$",
.root_module = lib_mod,
});

34
lib/std/Build.zig
View file

@ -873,6 +873,7 @@ pub const SharedLibraryOptions = struct {
error_tracing: ?bool = null,
};
/// Deprecated: use `b.addLibrary(.{ ..., .linkage = .dynamic })` instead.
pub fn addSharedLibrary(b: *Build, options: SharedLibraryOptions) *Step.Compile {
if (options.root_module != null and options.target != null) {
@panic("`root_module` and `target` cannot both be populated");
@ -943,6 +944,7 @@ pub const StaticLibraryOptions = struct {
error_tracing: ?bool = null,
};
/// Deprecated: use `b.addLibrary(.{ ..., .linkage = .static })` instead.
pub fn addStaticLibrary(b: *Build, options: StaticLibraryOptions) *Step.Compile {
if (options.root_module != null and options.target != null) {
@panic("`root_module` and `target` cannot both be populated");
@ -973,6 +975,38 @@ pub fn addStaticLibrary(b: *Build, options: StaticLibraryOptions) *Step.Compile
});
}
pub const LibraryOptions = struct {
linkage: std.builtin.LinkMode = .static,
name: []const u8,
root_module: *Module,
version: ?std.SemanticVersion = null,
max_rss: usize = 0,
use_llvm: ?bool = null,
use_lld: ?bool = null,
zig_lib_dir: ?LazyPath = null,
/// Embed a `.manifest` file in the compilation if the object format supports it.
/// https://learn.microsoft.com/en-us/windows/win32/sbscs/manifest-files-reference
/// Manifest files must have the extension `.manifest`.
/// Can be set regardless of target. The `.manifest` file will be ignored
/// if the target object format does not support embedded manifests.
win32_manifest: ?LazyPath = null,
};
pub fn addLibrary(b: *Build, options: LibraryOptions) *Step.Compile {
return .create(b, .{
.name = options.name,
.root_module = options.root_module,
.kind = .lib,
.linkage = options.linkage,
.version = options.version,
.max_rss = options.max_rss,
.use_llvm = options.use_llvm,
.use_lld = options.use_lld,
.zig_lib_dir = options.zig_lib_dir,
.win32_manifest = options.win32_manifest,
});
}
pub const TestOptions = struct {
name: []const u8 = "test",
max_rss: usize = 0,

3
test/behavior/x86_64/build.zig
View file

@ -6,7 +6,8 @@ pub fn build(b: *std.Build) void {
"Skip tests that do not match any filter",
) orelse &[0][]const u8{};
const compiler_rt_lib = b.addStaticLibrary(.{
const compiler_rt_lib = b.addLibrary(.{
.linkage = .static,
.name = "compiler_rt",
.use_llvm = false,
.use_lld = false,

3
test/link/common_symbols/build.zig
View file

@ -11,7 +11,8 @@ pub fn build(b: *std.Build) void {
}
fn add(b: *std.Build, test_step: *std.Build.Step, optimize: std.builtin.OptimizeMode) void {
const lib_a = b.addStaticLibrary(.{
const lib_a = b.addLibrary(.{
.linkage = .static,
.name = "a",
.root_module = b.createModule(.{
.root_source_file = null,

3
test/link/common_symbols_alignment/build.zig
View file

@ -11,7 +11,8 @@ pub fn build(b: *std.Build) void {
}
fn add(b: *std.Build, test_step: *std.Build.Step, optimize: std.builtin.OptimizeMode) void {
const lib_a = b.addStaticLibrary(.{
const lib_a = b.addLibrary(.{
.linkage = .static,
.name = "a",
.root_module = b.createModule(.{
.root_source_file = null,

6
test/link/interdependent_static_c_libs/build.zig
View file

@ -11,7 +11,8 @@ pub fn build(b: *std.Build) void {
}
fn add(b: *std.Build, test_step: *std.Build.Step, optimize: std.builtin.OptimizeMode) void {
const lib_a = b.addStaticLibrary(.{
const lib_a = b.addLibrary(.{
.linkage = .static,
.name = "a",
.root_module = b.createModule(.{
.root_source_file = null,
@ -22,7 +23,8 @@ fn add(b: *std.Build, test_step: *std.Build.Step, optimize: std.builtin.Optimize
lib_a.root_module.addCSourceFile(.{ .file = b.path("a.c"), .flags = &[_][]const u8{} });
lib_a.root_module.addIncludePath(b.path("."));
const lib_b = b.addStaticLibrary(.{
const lib_b = b.addLibrary(.{
.linkage = .static,
.name = "b",
.root_module = b.createModule(.{
.root_source_file = null,

6
test/link/link.zig
View file

@ -65,7 +65,8 @@ pub fn addObject(b: *Build, base: Options, overlay: OverlayOptions) *Compile {
}
pub fn addStaticLibrary(b: *Build, base: Options, overlay: OverlayOptions) *Compile {
return b.addStaticLibrary(.{
return b.addLibrary(.{
.linkage = .static,
.name = overlay.name,
.root_module = createModule(b, base, overlay),
.use_llvm = base.use_llvm,
@ -74,7 +75,8 @@ pub fn addStaticLibrary(b: *Build, base: Options, overlay: OverlayOptions) *Comp
}
pub fn addSharedLibrary(b: *Build, base: Options, overlay: OverlayOptions) *Compile {
return b.addSharedLibrary(.{
return b.addLibrary(.{
.linkage = .dynamic,
.name = overlay.name,
.root_module = createModule(b, base, overlay),
.use_llvm = base.use_llvm,

12
test/link/static_libs_from_object_files/build.zig
View file

@ -85,11 +85,13 @@ fn add(b: *Build, test_step: *Step, files: []const LazyPath, optimize: std.built
mod.addCSourceFile(.{ .file = file, .flags = &flags });
}
const lib_a = b.addStaticLibrary(.{
const lib_a = b.addLibrary(.{
.linkage = .static,
.name = "test2_a",
.root_module = mod_a,
});
const lib_b = b.addStaticLibrary(.{
const lib_b = b.addLibrary(.{
.linkage = .static,
.name = "test2_b",
.root_module = mod_b,
});
@ -130,11 +132,13 @@ fn add(b: *Build, test_step: *Step, files: []const LazyPath, optimize: std.built
lib_mod.addObject(obj);
}
const lib_a = b.addStaticLibrary(.{
const lib_a = b.addLibrary(.{
.linkage = .static,
.name = "test3_a",
.root_module = mod_a,
});
const lib_b = b.addStaticLibrary(.{
const lib_b = b.addLibrary(.{
.linkage = .static,
.name = "test3_b",
.root_module = mod_b,
});

3
test/src/Cases.zig
View file

@ -684,7 +684,8 @@ pub fn lowerToBuildSteps(
.name = case.name,
.root_module = mod,
}),
.Lib => b.addStaticLibrary(.{
.Lib => b.addLibrary(.{
.linkage = .static,
.name = case.name,
.root_module = mod,
}),

3
test/standalone/coff_dwarf/build.zig
View file

@ -21,7 +21,8 @@ pub fn build(b: *std.Build) void {
}),
});
const lib = b.addSharedLibrary(.{
const lib = b.addLibrary(.{
.linkage = .dynamic,
.name = "shared_lib",
.root_module = b.createModule(.{
.root_source_file = null,

3
test/standalone/dep_duplicate_module/build.zig
View file

@ -23,7 +23,8 @@ pub fn build(b: *std.Build) void {
lib_mod.addImport("mod", shared_mod);
exe_mod.addImport("mod", shared_mod);
const lib = b.addStaticLibrary(.{
const lib = b.addLibrary(.{
.linkage = .static,
.name = "lib",
.root_module = lib_mod,
});

3
test/standalone/extern/build.zig vendored
View file

@ -14,7 +14,8 @@ pub fn build(b: *std.Build) void {
.optimize = optimize,
}),
});
const shared = b.addSharedLibrary(.{
const shared = b.addLibrary(.{
.linkage = .dynamic,
.name = "shared",
.root_module = b.createModule(.{
.root_source_file = null,

6
test/standalone/global_linkage/build.zig
View file

@ -7,7 +7,8 @@ pub fn build(b: *std.Build) void {
const optimize: std.builtin.OptimizeMode = .Debug;
const target = b.graph.host;
const obj1 = b.addStaticLibrary(.{
const obj1 = b.addLibrary(.{
.linkage = .static,
.name = "obj1",
.root_module = b.createModule(.{
.root_source_file = b.path("obj1.zig"),
@ -16,7 +17,8 @@ pub fn build(b: *std.Build) void {
}),
});
const obj2 = b.addStaticLibrary(.{
const obj2 = b.addLibrary(.{
.linkage = .static,
.name = "obj2",
.root_module = b.createModule(.{
.root_source_file = b.path("obj2.zig"),

6
test/standalone/install_headers/build.zig
View file

@ -6,7 +6,8 @@ pub fn build(b: *std.Build) void {
const empty_c = b.addWriteFiles().add("empty.c", "");
const libfoo = b.addStaticLibrary(.{
const libfoo = b.addLibrary(.{
.linkage = .static,
.name = "foo",
.root_module = b.createModule(.{
.root_source_file = null,
@ -61,7 +62,8 @@ pub fn build(b: *std.Build) void {
.FOO_CONFIG_2 = "2",
}));
const libbar = b.addStaticLibrary(.{
const libbar = b.addLibrary(.{
.linkage = .static,
.name = "bar",
.root_module = b.createModule(.{
.root_source_file = null,

3
test/standalone/load_dynamic_library/build.zig
View file

@ -10,7 +10,8 @@ pub fn build(b: *std.Build) void {
if (builtin.os.tag == .wasi) return;
const lib = b.addSharedLibrary(.{
const lib = b.addLibrary(.{
.linkage = .dynamic,
.name = "add",
.version = .{ .major = 1, .minor = 0, .patch = 0 },
.root_module = b.createModule(.{

3
test/standalone/shared_library/build.zig
View file

@ -6,7 +6,8 @@ pub fn build(b: *std.Build) void {
const optimize: std.builtin.OptimizeMode = .Debug;
const target = b.graph.host;
const lib = b.addSharedLibrary(.{
const lib = b.addLibrary(.{
.linkage = .dynamic,
.name = "mathtest",
.version = .{ .major = 1, .minor = 0, .patch = 0 },
.root_module = b.createModule(.{

3
test/standalone/stack_iterator/build.zig
View file

@ -68,7 +68,8 @@ pub fn build(b: *std.Build) void {
// - x86_64: STACK_IMMD, STACK_IND
// - aarch64: FRAMELESS, DWARF
{
const c_shared_lib = b.addSharedLibrary(.{
const c_shared_lib = b.addLibrary(.{
.linkage = .dynamic,
.name = "c_shared_lib",
.root_module = b.createModule(.{
.root_source_file = null,

3
test/standalone/static_c_lib/build.zig
View file

@ -6,7 +6,8 @@ pub fn build(b: *std.Build) void {
const optimize: std.builtin.OptimizeMode = .Debug;
const foo = b.addStaticLibrary(.{
const foo = b.addLibrary(.{
.linkage = .static,
.name = "foo",
.root_module = b.createModule(.{
.root_source_file = null,

6
test/standalone/windows_argv/build.zig
View file

@ -9,7 +9,8 @@ pub fn build(b: *std.Build) !void {
const optimize: std.builtin.OptimizeMode = .Debug;
const lib_gnu = b.addStaticLibrary(.{
const lib_gnu = b.addLibrary(.{
.linkage = .static,
.name = "toargv-gnu",
.root_module = b.createModule(.{
.root_source_file = b.path("lib.zig"),
@ -74,7 +75,8 @@ pub fn build(b: *std.Build) !void {
break :has_msvc true;
};
if (has_msvc) {
const lib_msvc = b.addStaticLibrary(.{
const lib_msvc = b.addLibrary(.{
.linkage = .static,
.name = "toargv-msvc",
.root_module = b.createModule(.{
.root_source_file = b.path("lib.zig"),