mkDesktop

mkDesktop 是一个用 Rust 编写的 CLI 应用程序，可以将您的输入转换为 .desktop 文件。在您从 GitHub 安装应用程序或自己编译代码之后，您通常会发现应用程序未显示在您的桌面环境中的应用程序查找器中。为此，您需要在特定位置创建一个 .desktop 文件。为了帮助您创建这样的文件，这个应用程序非常有用。它引导您完成创建此类文件的引导式体验。您不必知道此文件的位置，文件语法或有效值。应用程序会将所有这些信息提供给您。

用法

您可以通过引导模式或通过 CLI 参数向应用程序提供所需信息。

引导模式

引导模式意味着您只能在应用程序请求信息后提供信息。运行应用程序后，您将需要回答一些关于 .desktop 文件所针对的应用程序的问题。这包括名称、应用程序类型、它所属的类别或它应在菜单中使用的图标。您可以在此处找到有关有效类型和类别的更多信息

类型

类别

自动检测

使用此应用程序创建 .desktop 文件的第三种方法是使用 --auto-detect 标志。为此，您必须处于包含目标应用程序的文件夹中，因为当前文件夹将用于检测应用程序的名称。mkDesktop 只能检测名称和可执行文件。对于其他选项，它使用预定义的值。默认类别为 "工具"，应用程序类型为 "应用程序"。您可以通过编辑配置文件来更改默认值。

模板

如果您只想有一个 .desktop 文件的模板，可以使用 --template 标志。它将在当前目录中输出一个没有值的 .desktop 文件。

CLI 使用 (mk_desktop --help)

示例：'mk_desktop --name example --global global --icon example/resource/example.png -c Utility -a Application --exec chromium'

用法

mk_desktop [OPTIONS]

选项

-a, --app-type <APP_TYPE>
        Application Type (possible values: Application, Link, Directory)

        [default: Application]

-A, --auto-detect
        Auto detect informations Only the following field can be detected: name (folder name),
        exec (file rights), icon (filename), global is predefined to "global", app-type is
        predefined to "Application"

-c, --categories <CATEGORIES>
        Categories wich describes your Application, you can find possible Categories here:
        https://specifications.freedesktop.org/menu-spec/menu-spec-1.0.html#category-registry

        [default: Utility]

-e, --exec <EXEC>
        The binary or .sh etc. which should be executed

-g, --global <GLOBAL>
        Should mkDesktop install the in global Directory or in the Local only for the current
        user

        [default: global]

-G, --guided
        Starts the guided mode of mkDesktop, you will get asked step by step all needed
        Information. Good for beginners

-h, --help
        Print help information

-i, --icon <ICON>
        The Icon wich will be displayed with this Application

-n, --name <NAME>
        Name of the File you want to create
-o, --output                     Redirects output of the file to stdout
-p, --path <PATH>
        Path in which the file will be written. Warning: Overwrites the global and local Path(if
        the global parameter is set it will be no longer active. The app will use this Path)

-t, --template
        Only Print out a template of the .desktop file

-V, --version
        Print version information

配置

配置文件定义了一些默认值，如果未指定，应用将使用这些默认值。有效的配置包括

global_path -> 定义全局安装 .desktop 文件的路径。

local_path -> 定义本地安装 .desktop 文件的路径。

categorie_default -> 定义默认的分类，如果未指定则使用此值。

app_type_default -> 定义默认的应用类型，如果未指定则使用此值。

安装

需求

• cargo
• rust

目前您需要自行编译应用程序。这可以通过以下方式完成

git clone https://github.com/LucasJaiser/mkDesktop.git
cd mkDekstop
cargo install --path .

或者您可以使用 crates.io

cargo install mk_desktop

贡献

您可以在该文件中找到有关如何贡献的更多信息。

目前应用程序只是一个简单的脚本，但目前正在计划许多更多功能。如果您想了解更多即将到来的功能信息，或者想贡献，请查看问题部分。我们非常欢迎您的贡献。