NotePublic/Software/Development/OperatingSystem/Linux/User/创建_Desktop_Entry.md

# 创建 Desktop Entry

## 1.系统级设置

Linux 桌面图标入口不仅仅是一个可编辑文件，称作 Desktop Entry，扩展名为“.desktop”。一般集中保存在 /usr/share/applications 目录下。

两个应用程序 .desktop 参考模板如下：

```ini
[Desktop Entry]
Name=GtkTerm
Type=Application
Comment=A gtk+ based serial port communication program
Exec=/usr/bin/gtkterm
Icon=gtkterm
MimeType=x-scheme-handler/gtkterm;
Categories=Network;
```

```ini
[Desktop Entry]
Name=STM32CubeIDE
Comment=STM32CubeIDE 1.5.0
GenericName=STM32CubeIDE
Exec=env GDK_BACKEND=x11 stm32cubeide %F
Icon=stm32cubeide
Path=/opt/stm32cubeide/
Terminal=false
StartupNotify=true
Type=Application
Categories=Development
```

应用程序图标保存在 /usr/share/icons 目录下，图标通过 MIME 配置文件与程序关联。

## 2.用户级设置

在 ~/.local/share/applications 目录下也可以保存 Desktop Entry，这个目录属于用户级别设置，只对当前用户有效。

如果 ~/.local/share/applications 与 /usr/share/applications 目录下存在同名称文件，则用户级别设置生效。有时系统级别设置有效，而用户级别设置无效，将导致菜单中无法找到该应用的入口。

## 3.特殊说明

修改 ~/.local/share/applications 或 /usr/share/applications 目录中的内容后需要执行一下：

```bash
sync
```

命令，确保修改生效。