GNOME Shell 系统监视器扩展技术文档

本文档旨在帮助用户安装、使用以及理解 GNOME Shell 系统监视器扩展。以下是详细的安装指南、使用说明以及项目 API 使用文档。

1. 安装指南

在安装此扩展之前，请确保您的系统满足以下先决条件：

• GNOME Shell 版本 3.26 或更高。
• 根据您的操作系统安装必要的系统包。

根据操作系统安装依赖

• Ubuntu:

  sudo apt install gir1.2-gtop-2.0 gir1.2-nm-1.0 gir1.2-clutter-1.0 gnome-system-monitor
  

• Debian:

  sudo apt install gir1.2-gtop-2.0 gir1.2-nm-1.0 gir1.2-clutter-1.0 gnome-system-monitor
  

• Fedora:

  sudo dnf install libgtop2-devel NetworkManager-libnm-devel gnome-system-monitor
  

• Arch Linux:

  sudo pacman -S libgtop networkmanager gnome-system-monitor clutter
  

• openSUSE (Leap 42.1):

  sudo zypper install gnome-shell-devel libgtop-devel libgtop-2_0-10 gnome-system-monitor
  

• Mageia 64-bit:

  sudo urpmi lib64gtop-gir2.0 lib64nm-gir1.0 lib64clutter-gir1.0 gnome-system-monitor
  

如果您的系统有 NVIDIA 显卡并且想要监视其内存使用情况，您需要安装 nvidia-smi。

浏览器安装

建议通过 GNOME Shell 扩展网站安装。访问 扩展的页面，在 Firefox 中安装，然后点击扩展名称旁边的切换按钮。

2. 项目使用说明

安装成功后，您可以通过 GNOME 设置中的扩展工具启用并配置此扩展。

3. 项目 API 使用文档

目前该项目的 API 使用文档未提供详细说明。如需开发或测试，建议查看项目的源代码以及相关开发文档。

4. 项目安装方式

浏览器安装

如上所述，通过 GNOME Shell 扩展网站安装。

存储库安装

在 Fedora 上，可以通过以下命令安装：

sudo dnf install gnome-shell-extension-system-monitor-applet

然后使用 gnome-tweak-tool 或 gnome-shell-extension-tool --enable-extension=[e-mail] 启用扩展。

手动安装

1. 下载 ZIP/Tarball，解压存档，打开终端进入解压目录，运行：

   make install
   

2. 如果您计划在扩展上进行开发或测试修改，建议检出 Git 存储库并安装符号链接。首先安装 git（如 sudo apt-get install git-core），然后运行：

   GIT_PROJECTS=~/git_projects
   PROJECT_NAME=gnome-shell-system-monitor-applet
   mkdir $GIT_PROJECTS
   cd $GIT_PROJECTS
   git clone git://github.com/paradoxxxzero/gnome-shell-system-monitor-applet.git $PROJECT_NAME
   mkdir -p ~/.local/share/gnome-shell/extensions
   cd ~/.local/share/gnome-shell/extensions
   { [ -d "./$PROJECT_NAME" ] || [ -L "./$PROJECT_NAME" ]; } && rm -Rf "./$PROJECT_NAME"
   ln -s $GIT_PROJECTS/gnome-shell-system-monitor-applet/$PROJECT_NAME
   gnome-shell-extension-tool --enable-extension=$PROJECT_NAME
   gnome-extensions enable [e-mail]
   

   然后重新加载 GNOME Shell（Alt + F2，然后输入 r）或重启您的 GNOME 会话（如果您使用 Wayland）。

在 openSUSE 上，您需要安装一个开发包，它提供了 gnome-shell-extension-tool 命令：

sudo zypper install gnome-shell-devel