web-dev-qa-db-fra.com

Existe-t-il une documentation API détaillée sur la liaison python pour appindicator?

Je deviens séreuse avec un projet personnel et j'ai besoin d'une bonne documentation sur le module appindicator pour python. Ce que j'ai trouvé jusqu'à présent:

  1. documentation de l'API sur dev.ubuntu.com
  2. entrée du wiki de la communauté
  3. documentation de l'API sur le code C
  4. Beau blog

qu'est-ce qui ne va pas avec eux:

  1. Juste une liste sans explications sur les arguments, les retours et ce que font les méthodes
  2. Uniquement des considérations de conception et d’arrière-plan - peu d’aide à la programmation
  3. Objets manquants du module python (par exemple, create_menu_from_desktop)
  4. Beaucoup d'informations utiles compressées mais non complètes

Donc, fondamentalement, j'ai besoin de quelque chose d'aussi détaillé que 3. sauf pour le module python.

Exemple sur mon problème:

void build_menu_from_desktop (desktop_file, desktop_profile)

Quels sont les arguments supposés être et que fait la méthode? À mon avis, la méthode crée des entrées de menu à partir d'un fichier '* .desktop'. Mais si oui, pourquoi a-t-il besoin de plus d'arguments que ce fichier? Quelles entrées dans le fichier prend-il les éléments de menu? Ce sont des questions comme celle-ci pour lesquelles j'ai un peu de difficulté à trouver une réponse.

indicatorpythonapplication-developmentdocumentation
18
con-f-use

Oui, nous réalisons que nous avons besoin de la documentation Python avec le niveau de détail approprié. C'est l'objectif de projet Giraffe . Il fonctionnera avec les liaisons GObject Introspection, ce qui correspond à la manière dont les nouvelles applications Python doivent être écrites pour utiliser les indicateurs d'application.

Jusque-là, le meilleur choix est la documentation de l'API que vous avez notée. Ce devrait être à peu près le même si "python-ified".

Build_menu_from_desktop est une fonction pratique qui permet de charger les entrées qui seraient autrement dans quelque chose comme un liste rapide dans Unity . Donc, pour obtenir ces entrées, vous utiliseriez build_menu_from_desktop("/my/path/myfile.desktop", "Unity") pour spécifier TargetEnvironment.

Cela vous permet d’avoir différentes entrées dans le fichier de bureau et d’avoir des chevauchements et d’autres pas.

7
Ted Gould