跳转到内容

std.Build.Step.InstallArtifact

标准库Zig 0.17.1官方原文
源码std/Build/Step/InstallArtifact.zig

第 1 行

字段

step: Step
dest_dir: ?InstallDir
dest_sub_path: ?[]const u8
emitted_bin: ?LazyPath
implib_dir: ?InstallDir
emitted_implib: ?LazyPath
pdb_dir: ?InstallDir
emitted_pdb: ?LazyPath
h_dir: ?InstallDir
emitted_h: ?LazyPath
dylib_symlinks: bool
artifact: *Step.Compile

std.Build.Step.InstallArtifact.base_tag

常量

第 32 行

Step.Tag

std.Build.Step.InstallArtifact.create

函数

第 55 行

pub fn create(owner: *std.Build, artifact: *Step.Compile, options: Options) *InstallArtifact

参数

owner: *std.Build
artifact: *Step.Compile
options: Options

std.Build.Step.InstallArtifact.DylibSymlinkInfo

容器

第 27 行

字段

major_only_filename: []const u8
name_only_filename: []const u8

std.Build.Step.InstallArtifact.InstallArtifact

别名

第 1 行

别名目标 std.Build.Step.InstallArtifact

std.Build.Step.InstallArtifact.InstallDir

别名

第 5 行

别名目标 std.Build.InstallDir

std.Build.Step.InstallArtifact.LazyPath

别名

第 6 行

别名目标 std.Build.LazyPath

std.Build.Step.InstallArtifact.Options

容器

第 34 行

字段

dest_dir: Dir = .default

主输出文件应放入哪个安装目录。

pdb_dir: Dir = .default
compiler_rt_dyn_lib_dir: Dir = .default
h_dir: Dir = .default
implib_dir: Dir = .default
dylib_symlinks: ?bool = null

是否随动态库一同安装符号链接。

dest_sub_path: ?[]const u8 = null

非 null 时,添加相对于 bin 目录的额外路径部分, 并覆盖 Compile 步骤的基名以供安装使用。

std.Build.Step.InstallArtifact.Options.Dir

容器

第 48 行

字段

disabled
default
override: InstallDir

std.Build.Step.InstallArtifact.std

别名

第 3 行

别名目标 std

std.Build.Step.InstallArtifact.Step

别名

第 4 行

别名目标 std.Build.Step

源码

std/Build/Step/InstallArtifact.zig

const InstallArtifact = @This();

const std = @import("std");
const Step = std.Build.Step;
const InstallDir = std.Build.InstallDir;
const LazyPath = std.Build.LazyPath;

step: Step,

dest_dir: ?InstallDir,
dest_sub_path: ?[]const u8,
emitted_bin: ?LazyPath,

implib_dir: ?InstallDir,
emitted_implib: ?LazyPath,

pdb_dir: ?InstallDir,
emitted_pdb: ?LazyPath,

h_dir: ?InstallDir,
emitted_h: ?LazyPath,

dylib_symlinks: bool,

artifact: *Step.Compile,

const DylibSymlinkInfo = struct {
    major_only_filename: []const u8,
    name_only_filename: []const u8,
};

pub const base_tag: Step.Tag = .install_artifact;

pub const Options = struct {
    /// 主输出文件应放入哪个安装目录。
    dest_dir: Dir = .default,
    pdb_dir: Dir = .default,
    compiler_rt_dyn_lib_dir: Dir = .default,
    h_dir: Dir = .default,
    implib_dir: Dir = .default,

    /// 是否随动态库一同安装符号链接。
    dylib_symlinks: ?bool = null,
    /// 非 null 时,添加相对于 bin 目录的额外路径部分,
    /// 并覆盖 Compile 步骤的基名以供安装使用。
    dest_sub_path: ?[]const u8 = null,

    pub const Dir = union(enum) {
        disabled,
        default,
        override: InstallDir,
    };
};

pub fn create(owner: *std.Build, artifact: *Step.Compile, options: Options) *InstallArtifact {
    const install_artifact = owner.allocator.create(InstallArtifact) catch @panic("OOM");
    const dest_dir: ?InstallDir = switch (options.dest_dir) {
        .disabled => null,
        .default => switch (artifact.kind) {
            .obj, .test_obj => @panic("object files have no standard installation procedure"),
            .exe, .@"test" => .bin,
            .lib => if (artifact.isDll()) .bin else .lib,
        },
        .override => |o| o,
    };
    const pdb_dir: ?InstallDir = switch (options.pdb_dir) {
        .disabled => null,
        .default => if (artifact.producesPdbFile()) dest_dir else null,
        .override => |o| o,
    };
    const implib_dir: ?InstallDir = switch (options.implib_dir) {
        .disabled => null,
        .default => if (artifact.producesImplib()) .lib else null,
        .override => |o| o,
    };
    install_artifact.* = .{
        .step = Step.init(.{
            .tag = base_tag,
            .name = owner.fmt("install {s}", .{artifact.name}),
            .owner = owner,
        }),
        .dest_dir = dest_dir,
        .pdb_dir = pdb_dir,
        .h_dir = switch (options.h_dir) {
            .disabled => null,
            .default => if (artifact.kind == .lib) .header else null,
            .override => |o| o,
        },
        .implib_dir = implib_dir,

        .dylib_symlinks = options.dylib_symlinks orelse (dest_dir != null and
            artifact.isDynamicLibrary() and artifact.version != null and
            std.Build.wantSharedLibSymLinks(artifact.rootModuleTarget())),

        .dest_sub_path = options.dest_sub_path,

        .emitted_bin = if (dest_dir != null) artifact.getEmittedBin() else null,
        .emitted_pdb = if (pdb_dir != null) artifact.getEmittedPdb() else null,
        // https://github.com/ziglang/zig/issues/9698
        .emitted_h = null,
        .emitted_implib = if (implib_dir != null) artifact.getEmittedImplib() else null,

        .artifact = artifact,
    };

    install_artifact.step.dependOn(&artifact.step);

    return install_artifact;
}