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

2024-12-24 09:11:46作者：何将鹤

本文档旨在帮助用户安装、使用以及理解 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=system-monitor@paradoxxx.zero.gmail.com 启用扩展。

手动安装

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

如果您计划在扩展上进行开发或测试修改，建议检出 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 system-monitor@paradoxxx.zero.gmail.com