包 xdirs

基于 dirs-next 的附加应用路径功能。

此包扩展了应用程序用于存储数据和配置的路径集。它通过添加后缀 _for 来补充如 cache_dir、config_dir 和 data_dir 等函数的版本，这些版本接受一个应用程序名称。并非所有此类路径都可以安全地将应用程序名称附加到通用路径上，因此这些附加函数将确保正确构建特定于应用程序的路径。

这是 directories-next 的替代品，并保持了与 dirs-next 更接近的接口。

“dirs”列表示通用形式是否存在于 dirs 或 dirs-next 包中。

示例

use xdirs::{application_dir, config_dir_for, log_dir_for};

const APP_NAME: &str = env!("CARGO_PKG_NAME");

let where_is_my_app_installed = application_dir();
let where_do_i_read_my_config = config_dir_for(APP_NAME);
let where_do_i_write_log_files = log_dir_for(APP_NAME);

附加功能

以下可用于确定已安装应用程序的位置。

• application_dir
• application_shared_dir
• user_application_dir

最后，对于支持应用程序容器或捆绑包概念的系统，以下将提供这些目录的位置。目前这些仅适用于 macOS。

• app_container_dir_for
• app_container_executable_dir_for
• user_app_container_dir_for
• user_app_container_executable_dir_for

与 dirs-next 一样，此库通过利用 Linux 上定义的

• XDG 基目录 和 XDG 用户目录 规范的机制来提供这些目录的位置。
• Windows上的已知文件夹系统，以及
• macOS上的标准目录。

变更

版本 0.1.1

• 新增：README中的示例和文本。
• 修复：文档链接和函数表。

版本 0.1.0

• 初始版本：在Linux（Ubuntu）、macOS和Windows上测试了所有主要功能。
• 文档：包含与dirs_next相同格式的函数文档。

待办事项

• 支持WASM目标，dist-next支持。
• 研究flatpack、app-image或snap应用容器支持。