Wayland环境下Gnome Shell 45扩展开发实用工作流问询

一、重载扩展的方法 #

1. Looking Glass 操作 #

Gnome 45 因ESM导入限制，旧的重载脚本无法直接运行，但可通过Looking Glass的REPL调用Shell内置API实现重载：

• 打开Looking Glass：按Alt+F2输入lg回车
• 在REPL中执行以下命令（替换your-extension-uuid为你的扩展UUID）：

  const uuid = 'your-extension-uuid@example.com';
  const manager = Main.extensionManager;
  // 卸载扩展
  if (manager.lookup(uuid)) {
    manager.unloadExtension(uuid);
  }
  // 重新加载扩展
  manager.loadExtension(uuid);
  

  注意：部分依赖Shell全局状态的扩展重载后可能出现异常，极端场景仍需重启Shell，但多数调试场景可替代登出重登。

2. CLI 命令重载 #

通过DBus接口直接调用Shell扩展管理器，无需打开Looking Glass：

# 卸载扩展
busctl --user call org.gnome.Shell /org/gnome/Shell/Extensions org.gnome.Shell.Extensions UnloadExtension s 'your-extension-uuid@example.com'
# 重新加载扩展
busctl --user call org.gnome.Shell /org/gnome/Shell/Extensions org.gnome.Shell.Extensions LoadExtension s 'your-extension-uuid@example.com'

二、窗口化运行Gnome Shell测试扩展 #

可启动嵌套Wayland会话，在独立窗口中运行Gnome Shell，避免影响主桌面：

1. 关闭当前桌面的扩展管理器（防止冲突）
2. 执行命令启动嵌套会话：

   gnome-shell --nested --wayland
   

3. 将扩展文件直接放在~/.local/share/gnome-shell/extensions/your-extension-uuid/目录下，嵌套Shell会自动识别，无需打包安装
4. 嵌套会话支持Looking Glass和扩展管理器，调试完成后直接关闭窗口即可，无需登出主桌面

三、无需完整Shell的单元测试方法 #

使用GJS编写单元测试，Mock必要的Shell API，无需加载完整Gnome Shell环境：

1. 编写测试文件（例如test-extension.js），模拟Shell核心对象：

   import GLib from 'gi://GLib';
   import Gio from 'gi://Gio';
   
   // Mock Extension类的必要方法
   class MockExtension {
     constructor(uuid) {
       this.uuid = uuid;
       this.metadata = { name: 'Test Extension' };
     }
   
     enable() {
       console.log('Extension enabled');
     }
   
     disable() {
       console.log('Extension disabled');
     }
   }
   
   // 测试扩展启停稳定性
   const testExtension = new MockExtension('test@example.com');
   testExtension.enable();
   // 验证启用后的状态逻辑
   testExtension.disable();
   // 验证禁用后的状态逻辑
   

2. 执行测试：

   gjs test-extension.js
   

3. 复杂场景可使用GJS内置的imports.testing.asserts断言库，或手动模拟Main、St等Shell模块的必要方法，覆盖扩展核心逻辑测试

内容的提问来源于stack exchange，提问作者interfect