rack 0.2.0

A modern Rust library for hosting audio plugins
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

fn main() {
    // Only build C++ wrapper on macOS
    #[cfg(target_os = "macos")]
    {
        use std::env;

        // Build rack-sys with CMake using explicit configuration
        let target = env::var("TARGET").unwrap();

        // Check if ASAN should be enabled
        let enable_asan = env::var("CARGO_FEATURE_ASAN").is_ok() || env::var("ENABLE_ASAN").is_ok();

        let mut config = cmake::Config::new("rack-sys");
        config
            .define("CMAKE_BUILD_TYPE", "Release")
            .define("BUILD_TESTS", "OFF"); // Don't build C++ tests in Rust build

        if enable_asan {
            config.define("ENABLE_ASAN", "ON");
            eprintln!("Building with AddressSanitizer enabled");
        }

        let dst = config.build();

        // Library name comes from CMake configuration (librack_sys.a)
        let lib_name = "rack_sys";

        // Tell cargo where to find the library
        println!("cargo:rustc-link-search=native={}/lib", dst.display());
        println!("cargo:rustc-link-lib=static={}", lib_name);

        // Link C++ standard library (required for C++ code)
        // Use libc++ on macOS (default for clang)
        println!("cargo:rustc-link-lib=c++");

        // Link ASAN runtime if enabled
        if enable_asan {
            println!("cargo:rustc-link-arg=-fsanitize=address");
            println!("cargo:rustc-link-arg=-fno-optimize-sibling-calls");
            println!("cargo:rustc-link-arg=-fsanitize-address-use-after-scope");
            println!("cargo:rustc-link-arg=-fno-omit-frame-pointer");
        }

        // Link required macOS frameworks for AudioUnit API
        println!("cargo:rustc-link-lib=framework=AudioToolbox");
        println!("cargo:rustc-link-lib=framework=CoreAudio");
        println!("cargo:rustc-link-lib=framework=CoreFoundation");
        println!("cargo:rustc-link-lib=framework=CoreAudioKit");
        println!("cargo:rustc-link-lib=framework=AppKit");

        // Rerun build script if C++ sources, headers, or build config changes
        println!("cargo:rerun-if-changed=rack-sys/src");
        println!("cargo:rerun-if-changed=rack-sys/include");
        println!("cargo:rerun-if-changed=rack-sys/CMakeLists.txt");

        // Print target for debugging
        eprintln!("Building rack-sys for target: {}", target);
    }
}