sysdir-rs

枚举各种标准系统目录的文件系统路径，其中应用程序、资源等被安装。

此 crate 揭示了由 macOS、iOS、tvOS 和 watchOS 上 sysdir(3) 库函数提供的 Rust 绑定。

sysdir API 首次出现在 OS X 10.12、iOS 10、watchOS 3 和 tvOS 10 中，取代了已废弃的 NSSystemDirectories(3) API。

用法

将此添加到您的 Cargo.toml

[dependencies]
sysdir = "1.2.2"

然后以这种方式解析已知目录

use core::ffi::{c_char, CStr};

use sysdir::*;

let mut path = [0; PATH_MAX as usize];

let dir = sysdir_search_path_directory_t::SYSDIR_DIRECTORY_USER;
let domain_mask = SYSDIR_DOMAIN_MASK_LOCAL;

unsafe {
    let mut state = sysdir_start_search_path_enumeration(dir, domain_mask);
    loop {
        let path = path.as_mut_ptr().cast::<c_char>();
        state = sysdir_get_next_search_path_enumeration(state, path);
        if state == 0 {
            break;
        }
        let path = CStr::from_ptr(path);
        let s = path.to_str().unwrap();
        assert_eq!(s, "/Users");
    }
}

您可以通过运行示例来测试此 crate 是否在您的平台上工作

cargo run --example enumerate_system_dirs

实现

sysdir-rs 直接绑定到 libSystem，并通过 bindgen 生成的 vendored 绑定。此 crate 除了 libSystem 外没有其他依赖项。

请注意，此 crate 在非 Apple 平台上完全为空。

no_std

sysdir-rs 是 no_std 且仅需要 core。

最低支持的 Rust 版本

此 crate 需要 Rust 1.64.0 或更高版本。此版本可以在次要版本中提升。

许可证

sysdir-rs 根据 MIT 许可证 或 Apache 许可证（版本 2.0） 分发。