LinuxMint/Cinnamon 桌面环境：编写自定义小程序(Applet)教程

LinuxMint/Cinnamon 桌面环境：编写自定义小程序(Applet)教程

cinnamon A Linux desktop featuring a traditional layout, built from modern technology and introducing brand new innovative features. 项目地址: https://gitcode.com/gh_mirrors/ci/cinnamon

前言

在LinuxMint的Cinnamon桌面环境中，小程序(Applet)是增强用户体验的重要组件。本文将详细介绍如何从零开始创建一个简单的通知小程序，帮助开发者理解Cinnamon小程序的开发流程。

小程序基础概念

小程序是Cinnamon桌面环境中的小型交互组件，通常显示在面板上，提供特定功能。每个小程序由两个核心文件组成：

1. metadata.json - 包含小程序的元数据信息
2. applet.js - 包含小程序的JavaScript代码

开发环境准备

首先需要创建小程序的基本目录结构。Cinnamon支持两种安装位置：

• 用户级安装：~/.local/share/cinnamon/applets/
• 系统级安装：/usr/share/cinnamon/applets/

建议开发者使用用户级安装进行测试：

mkdir -p ~/.local/share/cinnamon/applets/notify-me@cinnamon.org/icons
cd ~/.local/share/cinnamon/applets/notify-me@cinnamon.org
touch metadata.json applet.js

定义小程序元数据

metadata.json文件是小程序的"身份证"，包含以下关键信息：

{
    "uuid": "notify-me@cinnamon.org",
    "name": "Notify Me",
    "description": "点击小程序发送通知",
    "icon": "cs-notifications",
    "version": "1.0.0",
    "max-instances": "-1"
}

重要参数说明：

• uuid：小程序唯一标识符，建议使用反向域名格式
• max-instances：控制小程序实例数量，-1表示无限制

小程序核心代码解析

完整的applet.js代码如下：

const Applet = imports.ui.applet;
const Util = imports.misc.util;
const GLib = imports.gi.GLib;

// 获取并格式化用户名
var user = GLib.get_user_name();
user = user.capitalize();

class NotifyMe extends Applet.IconApplet {
    constructor(metadata, orientation, panelHeight, instance_id) {
        super(orientation, panelHeight, instance_id);
        this.set_applet_icon_symbolic_name("bell-notif");
        this.set_applet_tooltip("点击发送通知");
    }

    on_applet_clicked(event) {
        let command = `bash -c 'notify-send -u normal `;
        command += `"感谢 ${user}" "您正在使用Cinnamon!"'`;
        Util.spawnCommandLineAsync(command);
    }
}

function main(metadata, orientation, panelHeight, instance_id) {
    return new NotifyMe(metadata, orientation, panelHeight, instance_id);
}

代码结构解析

1. 模块导入：

   • Applet：提供小程序基础功能
   • Util：包含实用工具函数
   • GLib：提供系统级功能访问

2. NotifyMe类：

   • 继承自Applet.IconApplet，表示这是一个图标类型的小程序
   • 构造函数初始化图标和工具提示
   • on_applet_clicked处理点击事件

3. main函数：

   • Cinnamon的入口点，负责创建并返回小程序实例

关键技术点

1. 图标设置：

   this.set_applet_icon_symbolic_name("bell-notif");
   

   使用符号化图标，会自动适应系统主题变化。

2. 异步命令执行：

   Util.spawnCommandLineAsync(command);
   

   避免阻塞UI线程，保持桌面响应流畅。

3. 用户交互处理： on_applet_clicked是预定义的点击事件处理器，开发者只需实现业务逻辑。

小程序部署与测试

完成代码编写后，可以通过以下步骤测试：

1. 保存所有文件
2. 重启Cinnamon（Alt+F2输入"r"回车）
3. 右键点击面板 → 添加小程序 → 选择"Notify Me"

进阶开发建议

1. 多语言支持： 使用Cinnamon的国际化机制支持多语言显示

2. 配置界面： 通过settings-schema.json添加用户配置选项

3. 错误处理： 添加适当的错误处理逻辑增强稳定性

4. 性能优化： 避免频繁的UI更新和同步IO操作

总结

本文详细介绍了在LinuxMint/Cinnamon环境中开发小程序的完整流程。通过这个简单的通知小程序示例，开发者可以掌握Cinnamon小程序的基本结构和开发模式。实际开发中，可以根据需求扩展功能，如添加配置选项、支持多语言等，打造更强大的桌面组件。

Cinnamon提供了丰富的API接口，开发者可以进一步探索面板菜单、弹出窗口等高级功能，创建更加复杂的桌面小程序。

cinnamon A Linux desktop featuring a traditional layout, built from modern technology and introducing brand new innovative features. 项目地址: https://gitcode.com/gh_mirrors/ci/cinnamon