Есть ли подробная API-документация по связыванию python для appindicator?


18

Я серьезно отношусь к собственному проекту, и мне нужна хорошая документация по модулю appindicator для python. Что я нашел до сих пор:

  1. Документация по API на dev.ubuntu.com
  2. Запись вики сообщества
  3. Документация API по коду C
  4. Хороший пост в блоге

что с ними не так:

  1. Просто список без объяснений аргументов, возвратов и методов.
  2. Только конструктивные соображения и фоны - мало что могло бы помочь в реальном программировании
  3. Материал, отсутствующий в модуле python (например, create_menu_from_desktop)
  4. Много полезной информации сжато, но не полно

Так что в основном мне нужно что-то подробное, как 3. но для модуля Python.

Пример по моей проблеме:

void build_menu_from_desktop (desktop_file, desktop_profile)

Каковы должны быть аргументы и что делает метод? Я предполагаю, что метод создает пункты меню из файла * .desktop. Но если это так, зачем ему нужно больше аргументов, чем просто этот файл? От каких записей в файле он берет пункты меню? Это такие вопросы, на которые мне трудно найти ответ.


2
Ссылки 1 и 3 не работают.
Мэтт Столяр

2
... больше ...
con-f-use

Ответы:


7

Да, мы понимаем, что нам нужна документация Python с соответствующим уровнем детализации. Это цель проекта Жираф . Он будет работать с привязками GObject Introspection, что позволяет писать новые приложения Python для использования индикаторов приложений.

До тех пор лучшим выбором будет документация API, которую вы заметили. Это должно быть примерно то же самое, хотя "python-ified".

Build_menu_from_desktop - это удобная функция, использующая загрузку записей, которые иначе были бы в чем-то вроде быстрого списка в Unity . Таким образом, чтобы получить те записи, которые вы использовали бы, build_menu_from_desktop("/my/path/myfile.desktop", "Unity")чтобы указать TargetEnvironment.

Это позволяет вам иметь разные записи в файле рабочего стола и иметь некоторые совпадения, а другие нет.


Это насчет ответов. Спасибо, что нашли время. Почему не документы или доксиген в первую очередь?
con-f-use

1
Мы используем gtk-doc. В основном то же самое. Но это еще не дошло до привязок.
Тед Гулд

1
Вы можете получить меню и изменить их там, но я бы не рекомендовал это. Если бы они должны были отличаться, я бы просто построил меню обычным способом ... На самом деле, функция предназначена для того, чтобы быть помощником только в том случае, если вы хотите, чтобы они были одинаковыми.
Тед Гулд

1
Просто хотел проверить, есть ли какие-нибудь обновления о Жирафе и списках ...
con-f-use

1
Каково состояние этого? Почему все ссылки на документы Google AppIndicator API не работают? Есть ли один живой?
Улидько
Используя наш сайт, вы подтверждаете, что прочитали и поняли нашу Политику в отношении файлов cookie и Политику конфиденциальности.
Licensed under cc by-sa 3.0 with attribution required.