# desktop-entry-builder

**Repository Path**: zinface/desktop-entry-builder

## Basic Information

- **Project Name**: desktop-entry-builder
- **Description**: 简单构建 desktop-entry 与自定义扩展 desktops 构建
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-14
- **Last Updated**: 2025-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Desktop Entry Collection

一个精心整理的 Linux 桌面入口文件（`.desktop`）集合，提供经过优化和验证的应用程序快捷方式。

## 这是什么？

这是一个预配置的 `.desktop` 文件仓库，包含了常用应用程序的桌面入口配置，特别针对：
- Wayland 环境优化
- 国产软件适配
- 特殊参数配置（DPI、启动参数等）
- 多架构支持（AMD64/ARM64）

## 包含的桌面入口

### 1. **VS Code 优化入口**
- `code-open-directory.desktop`
- 优化了文件浏览器集成
- 支持右键快捷打开目录

### 2. **Linux QQ (Wayland 支持)**
- `qq-wayland.desktop`
- 原生 Wayland 支持配置
- 修复了屏幕分享和输入法问题

### 3. **星火商店 (多版本/多架构)**
- **基础版本**：
  - `spark-store-wayland.desktop` - Wayland 原生支持
  - `spark-store-wayland-dpi.desktop` - 高DPI缩放优化
- **APM 版本**（应用包管理器）：
  - Chrome/Edge/Web 版本
  - AMD64 和 ARM64 架构
  - 独立应用沙箱配置

## 快速使用

### 手动安装（用于测试）

```bash
# 安装单个桌面文件(code 增强)
sudo cp desktops/code-desktops/code-open-directory.desktop /usr/share/applications/

# 安装所有桌面文件
sudo cp desktops/*/*.desktop /usr/share/applications/
```

### 使用 CMake 构建和安装(必须由构建包触发自动配置)

**构建限制**：这不是传统 cmake 项目构建，应由构建包触发配置过程

```bash
# 构建(自动配置 单个模块）
make package-code-desktops
# make package-linuxqq-desktops
# make package-...

# 进入已构建的目录
cd build

# 安装到系统
sudo make install
# 或测试安装到临时目录
make install DESTDIR=/tmp/test-install
```

### 生成 Debian 包

```bash
# 构建所有包
make package-all

# 构建特定包
make package-code-desktops
make package-linuxqq-desktops
make package-spark-store-wayland-desktops

# 安装生成的包
sudo dpkg -i build/*.deb
```

## 项目结构

```
desktop-entries/
├── CMakeLists.txt                    # 主构建配置
├── desktops/                         # 桌面文件集合
│   ├── code-desktops/                # VS Code 配置
│   │   ├── code-desktops.cmake      # 安装脚本
│   │   └── code-open-directory.desktop
│   ├── linuxqq-desktops/             # QQ配置
│   │   ├── linuxqq-desktops.cmake
│   │   └── qq-wayland.desktop
│   └── spark-store-wayland-desktops/ # 星火商店配置
│       ├── spark-store-wayland-desktops.cmake
│       ├── spark-store-wayland.desktop
│       ├── spark-store-wayland-dpi.desktop
│       └── apm-*.desktop            # APM 多版本
├── cmake/                           # CMake 辅助模块
├── Makefile                         # 便捷构建脚本
└── README.md
```

## 配置选项

每个桌面入口都是独立单独构建：

```bash
# 选择性构建
make package-code-desktops
make package-linuxqq-desktops
make package-...
```

## 各入口说明

### VS Code 入口
- **功能**：右键菜单"在 VS Code 中打开"
- **依赖**：VS Code 已安装
- **环境变量**：自动继承终端环境

### Linux QQ (Wayland)
- **特性**：
  - 修复 Wayland 下截图黑屏
  - 支持 XWayland 视频桥接
  - 输入法框架集成
- **启动参数**：已配置必要的环境变量

### 星火商店
- **基础版本**：
  - Wayland 原生支持 (`--ozone-platform=wayland`)
  - 高分屏缩放支持 (`--force-device-scale-factor`)
- **APM 版本**：
  - 应用沙箱支持
  - 多架构适配（AMD64/ARM64）
  - 多浏览器引擎（Chrome/Edge/Web）

## 自定义和扩展

### 添加新的桌面入口

1. 在 `desktops/` 下创建目录：
   ```bash
   mkdir desktops/myapp-desktops
   ```

2. 创建 `.desktop` 文件：
   ```ini
   # desktops/myapp-desktops/myapp.desktop
   [Desktop Entry]
   Name=MyApp
   Exec=myapp --special-flag
   Icon=myapp-icon
   Type=Application
   Categories=Utility;
   ```

3. 创建 CMake 安装脚本：
   ```cmake
   # desktops/myapp-desktops/myapp-desktops.cmake
   install(FILES 
       "${CMAKE_CURRENT_LIST_DIR}/myapp.desktop"
       DESTINATION /usr/share/applications
   )
   ```

4. 重新配置 CMake 即可

### 修改现有配置

直接编辑对应的 `.desktop` 文件，然后重新安装：

```bash
# 修改后重新安装
sudo rm /usr/share/applications/qq-wayland.desktop
sudo cp desktops/linuxqq-desktops/qq-wayland.desktop /usr/share/applications/
```

## 常见问题

### 桌面图标不显示？
```bash
# 更新桌面数据库
sudo update-desktop-database
```

### 启动参数无效？
检查应用程序是否支持相应参数，可能需要调整 `.desktop` 文件中的 `Exec` 行。

### Wayland 兼容性问题？
确保桌面环境运行在 Wayland 会话下，某些应用可能需要额外的环境变量。

## 许可证

MIT License - 可自由使用、修改和分发

## 贡献

欢迎提交：
- 新的 `.desktop` 文件配置
- Wayland 兼容性改进
- 更多应用程序的优化配置
- 文档改进和翻译

## 相关项目

- [desktop-entry-builder](https://github.com/xxx) - 桌面入口构建工具（规划中）
- [spark-store](https://www.spark-app.store/) - 星火应用商店
- [LinuxQQ](https://im.qq.com/linuxqq/) - QQ Linux 版

---

**提示**：这是桌面入口文件的**示例集合**，未来计划基于此开发 `desktop-entry-builder` 工具来自动化生成和管理。