mcl

A terrible minecraft launcher
Log | Files | Refs | README

build.zig (3209B)


      1 const std = @import("std");
      2 
      3 // Although this function looks imperative, note that its job is to
      4 // declaratively construct a build graph that will be executed by an external
      5 // runner.
      6 pub fn build(b: *std.Build) void {
      7     // Standard target options allows the person running `zig build` to choose
      8     // what target to build for. Here we do not override the defaults, which
      9     // means any target is allowed, and the default is native. Other options
     10     // for restricting supported target set are available.
     11     const target = b.standardTargetOptions(.{});
     12 
     13     // Standard optimization options allow the person running `zig build` to select
     14     // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. Here we do not
     15     // set a preferred release mode, allowing the user to decide how to optimize.
     16     const optimize = b.standardOptimizeOption(.{});
     17 
     18     const exe = b.addExecutable(.{
     19         .name = "mcl",
     20         // In this case the main source file is merely a path, however, in more
     21         // complicated build scripts, this could be a generated file.
     22         .root_source_file = .{ .path = "src/main.zig" },
     23         .target = target,
     24         .optimize = optimize,
     25     });
     26     exe.linkLibC();
     27     exe.linkSystemLibrary("curl");
     28 
     29     // This declares intent for the executable to be installed into the
     30     // standard location when the user invokes the "install" step (the default
     31     // step when running `zig build`).
     32     b.installArtifact(exe);
     33 
     34     // This *creates* a Run step in the build graph, to be executed when another
     35     // step is evaluated that depends on it. The next line below will establish
     36     // such a dependency.
     37     const run_cmd = b.addRunArtifact(exe);
     38 
     39     // By making the run step depend on the install step, it will be run from the
     40     // installation directory rather than directly from within the cache directory.
     41     // This is not necessary, however, if the application depends on other installed
     42     // files, this ensures they will be present and in the expected location.
     43     run_cmd.step.dependOn(b.getInstallStep());
     44 
     45     // This allows the user to pass arguments to the application in the build
     46     // command itself, like this: `zig build run -- arg1 arg2 etc`
     47     if (b.args) |args| {
     48         run_cmd.addArgs(args);
     49     }
     50 
     51     // This creates a build step. It will be visible in the `zig build --help` menu,
     52     // and can be selected like this: `zig build run`
     53     // This will evaluate the `run` step rather than the default, which is "install".
     54     const run_step = b.step("run", "Run the app");
     55     run_step.dependOn(&run_cmd.step);
     56 
     57     // Creates a step for unit testing. This only builds the test executable
     58     // but does not run it.
     59     const unit_tests = b.addTest(.{
     60         .root_source_file = .{ .path = "src/main.zig" },
     61         .target = target,
     62         .optimize = optimize,
     63     });
     64 
     65     const run_unit_tests = b.addRunArtifact(unit_tests);
     66 
     67     // Similar to creating the run step earlier, this exposes a `test` step to
     68     // the `zig build --help` menu, providing a way for the user to request
     69     // running the unit tests.
     70     const test_step = b.step("test", "Run unit tests");
     71     test_step.dependOn(&run_unit_tests.step);
     72 }