AGS项目中App.windows属性为空问题的解决方案

在AGS（Aylur's Gtk Shell）项目开发过程中，开发者可能会遇到一个看似奇怪的现象：当使用App.add_window方法添加窗口后，尝试通过App.windows属性获取窗口列表时，返回的结果始终为空数组。这个问题涉及到AGS框架中Gtk.Application的API设计差异，需要开发者特别注意。

问题本质

这个问题源于JavaScript与传统GObject Introspection(GI)接口的命名规范差异。在标准的Gtk.Application中，添加窗口的方法是add_window（下划线命名法），而AGS框架为了保持JavaScript的编码习惯，提供了addWindow（驼峰命名法）作为更符合JS风格的替代方案。

当开发者直接调用App.add_window时，实际上调用的是Gtk.Application的原生方法，这个方法不会更新AGS框架维护的窗口列表。因此后续通过App.windows访问时自然得不到预期的结果。

正确使用方法

在AGS项目中，推荐使用以下两种方式之一来管理应用窗口：

方法一：使用驼峰命名法

App.addWindow(Widget.Window({}));
console.log(App.windows); // 现在可以正确输出窗口列表

方法二：通过config配置

App.config({
  windows: [
    Widget.Window({
      name: 'main-window'
    })
  ]
});
console.log(App.windows); // 可以正确输出

技术背景

这种设计是AGS框架为了平衡两种编程范式所做的折中：

1. 保留了原生Gtk.Application的所有方法（下划线命名）
2. 提供了更符合JavaScript习惯的包装方法（驼峰命名）
3. 通过config配置方式提供了声明式的窗口管理

最佳实践建议

1. 在纯AGS项目开发中，统一使用驼峰命名法的API
2. 如果需要与原生Gtk组件深度交互，再考虑使用原生方法
3. 对于复杂应用，推荐使用config配置方式来管理窗口生命周期
4. 注意检查方法调用的返回值，确保窗口添加成功

理解这个设计差异后，开发者就能更自如地在AGS框架中管理应用窗口，避免出现窗口列表为空的困惑情况。