是否有关于 appindicator 的 python 绑定的详细 API 文档？

Question

我正在认真考虑自己的项目，需要一份关于 Python appindicator 模块的良好文档。到目前为止，我发现了：

1. dev.ubuntu.com 上的 API 文档
2. 社区 wiki 条目
3. C 代码的 API 文档
4. 很棒的博客文章

他们怎么了：

1. 只是一个列表，没有关于参数、返回值和方法作用的解释
2. 仅涉及设计考虑和背景，对实际编程帮助不大
3. 缺少 Python 模块的内容（例如 create_menu_from_desktop）
4. 许多有用信息被压缩但不完整

所以基本上我需要一些像 3 一样详细的东西。但是对于 python 模块来说。

我的问题示例：

void build_menu_from_desktop (桌面文件，桌面配置文件)

参数应该是什么，方法的作用是什么？我的猜测是，该方法从“*.desktop”文件创建菜单项。但如果是这样，为什么它需要的参数不仅仅是该文件？它从文件中的哪些条目获取菜单项？对于这样的问题，我很难找到答案。

Answer 1

是的，我们意识到我们需要具有适当详细程度的 Python 文档。这就是长颈鹿项目它将与 GObject Introspection 绑定一起工作，这是编写新 Python 应用程序以使用应用程序指示器的方式。

在此之前，最好的选择是您记下的 API 文档。它应该大致相同，尽管“经过 Python 化”。

build_menu_from_desktop 是一个便利函数，用于加载原本位于Unity 中的 quicklist。因此，要获取这些条目，您需要build_menu_from_desktop("/my/path/myfile.desktop", "Unity")指定 TargetEnvironment。

这使您可以在桌面文件中拥有不同的条目，并且其中一些条目重叠，而另一些则不重叠。