Lib.rs

关于

已停止维护 我不再计划对这个项目进行工作了。

请参阅网站以获取概述。

Emulsion 面向 Windows、Mac 和 Linux，尽管目前仅在 Linux 和 Windows 上进行测试。Linux 用户请注意：Wayland 支持有限，因此例如，请预期 CPU 使用率高，标题文本可能无法显示。但是 X 完全受支持。

计划发布的版本以里程碑（在问题下）表示。我尽量每两个月发布一个新的版本，但不要过于重视截止日期。如果您对某个功能或错误修复特别感兴趣，请在问题中说明 - 喜欢或点赞可能就足够了，但有时最好留下评论，因为这是我会收到通知的方式。

欢迎贡献。您可以随意发布功能请求、错误报告和提交拉取请求。

构建和安装

建议使用网站上和 GitHub 发布页面提供的官方安装程序。虽然有人可能出于几个原因想要从源代码构建。为此，需要安装 Rust 的最新稳定版本；完成后继续。

在许多情况下，尝试运行以下命令是不错的选择：cargo install emulsion。如果构建失败或emulsion在启动时崩溃，请查看 nix-example/emulsion/default.nix 文件，并找到列出emulsion依赖库的 rpathLibs。安装这些库的开发版本，然后再次尝试构建/安装。例如，在Ubuntu上，可以通过运行以下命令安装 libXi：

sudo apt install libXi-dev

对于 Nix软件包管理器 用户：理论上，nix-example 中找到的Nix表达式能够从emulsion源代码的某个状态构建一个可工作的可执行文件。不能保证构建的可执行文件将与emulsion的任何发布版本完全相同。提供Nix表达式是为了找到依赖关系，并且对于喜欢在Nix中摆弄的人来说，否则我建议不要使用它。

关于Cargo功能的说明

网站上的所有软件包都支持avif，但这不是默认功能，因为依赖关系不容易设置。如果您是从源代码构建（例如，使用cargo install）并且希望emulsion能够打开avif文件，我建议查看发布工作流程以获取安装avif开发依赖关系的步骤。

通过Windows安装程序安装Emulsion时，Emulsion将启用网络，并且默认会检查更新。然而，其他版本都没有网络，默认功能集也没有。这也意味着在调用时，Emulsion将不具有网络相关的功能

cargo install emulsion

要启用这些功能，请在使用cargo安装时运行

cargo install emulsion --features=networking

报告错误

如果Emulsion意外关闭，请找到 "panic.txt" 文件。此文件的位置取决于目标平台。

• Windows: %localappdata%\emulsion\data
• MacOS: $HOME/Library/Application Support/emulsion
• Linux: $XDG_DATA_HOME/emulsion 或 $HOME/.local/share/emulsion

在发布错误报告时，请将此文件的 内容上传到GitHub。如果您认为它太大，只需粘贴等号之间的最后一个panic条目即可。如果没有 "panic.txt" 文件，请描述您遇到故障行为的场景，如果您认为这可能会有所帮助，请提供重现步骤。