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

Question

我对自己的项目越来越认真，需要有关 python 的 appindicator 模块的良好文档。到目前为止我发现了什么：

1. dev.ubuntu.com 上的 API 文档
2. 社区维基条目
3. C 代码的 API 文档
4. 不错的博文

他们怎么了：

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

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

我的问题示例：

void build_menu_from_desktop (desktop_file, desktop_profile)

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

Answer 1

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

在此之前，最好的选择是您已记下的 API 文档。虽然“python-ified”应该大致相同。

build_menu_from_desktop 是一个方便的函数，用于加载条目，否则这些条目将位于 Unity 中的快速列表之类的东西中。因此，要获取build_menu_from_desktop("/my/path/myfile.desktop", "Unity")用于指定 TargetEnvironment 的那些条目。

这允许您在桌面文件中有不同的条目，并且有一些重叠，而另一些则没有。