Как создать и использовать хранилище расширений QGIS.

Разработка расширений для QGIS может вестись на C++ и Python. Разработка на Python, помимо того, что является более простой, быстрой и кросс-платформенной, еще и имеет мощную децентрализованную систему распространения результатов. Каждый автор расширения имеет возможность быстро организовать систему полуавтоматического его распространения через свой сайт. Средства самого QGIS позволяют подключать и отслеживать обновление расширений, происходящие на веб-сайте автора. К сожалению, из-за сложностей связанных с компиляцией и установкой, эта возможность работает пока только для расширений, написанных на языке Python.

Эта статья рассказывает, как автор расширения может создать репозиторий, а пользователь им воспользоваться.

[править] Создание репозитория

Допустим расширение разработано, проверенно и работает локально. Создание репозитория заключается в пакетировке расширения и создании специального файла XML описания репозитория.

Пакет с расширением должен представлять из себя архив папки с набором всех необходимых файлов расширения, например:

/testplugin
|
+- __init__.py
|
+- icon.png
|
+- plugin.py
|
+- resources.py

Архив должен быть создан с помощью архиватора ZIP.

После того, как расширение запакетировано, надо настроить его описание, являющееся частью XML файла репозитория.

Пример XML файла с описанием плагина, расположенного в репозитории выглядит следующим образом:

<?xml version="1.0" ?>
<?xml-stylesheet type="text/xsl" href="plugins.xsl" ?>
<plugins>
  <pyqgis_plugin name="TestPlugin" version="0.1.29">
    <description>This is the test plugin</description>
    <homepage>http://gis-lab.info/qa/qgis-dev-python.html</homepage>
    <qgis_minimum_version>1.0</qgis_minimum_version>
    <file_name>testplugin.zip</file_name>
    <author_name>GIS-Lab</author_name>
    <download_url>http://gis-lab.info/programs/qgis/testplugin.zip</download_url>
  </pyqgis_plugin>
</plugins>

При добавлении в репозиторий еще одного расширения, добавляется еще один блок

<pyqgis_plugin></pyqgis_plugin>

и все что содержится в нем.

Разберем по пунктам:

• pyqgis_plugin — начало описания расширения, содержит параметры названия name="TestPlugin" и последней версии version="0.1.29" расширения.
• description — строка описание расширения
• homepage — домашняя страница
• qgis_minimum_version — минимальная версия QGIS под которой будет работать расширение
• author_name — автор расширения
• download_url — ссылка на пакет расширения (файл zip)

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

[править] Работа с репозиторием в QGIS

Для получения расширения теперь нам не обязательно рассылать его само, достаточно дать ссылку на репозиторий. Например, репозиторий расширений GIS-Lab:

http://gis-lab.info/programs/qgis/qgis-repo.xml

Подключимся к этому репозиторию из QGIS.

Для этого:

1. Подключим, если оно еще не подключено расширение «Plugin Installer» («Модули → Управление модулями»)
   
   
2. Вызовем установщик расширений «Модули → Загрузить модули» и перейдем на закладку «Репозитории». Исходно в ней содержится только один, официальный репозиторий
   
   

   Чтобы добавить остальные, нажмем на кнопку Добавить сторонние репозитории, добавятся все остальные, среди которых будет и репозиторий GIS-Lab
   

   

   Если по какой-то причине у вас это не получилось, можно добавить репозиторий вручную («Добавить»)
   

   Имя: GIS-Lab
   Адрес: http://gis-lab.info/programs/qgis/qgis-repo.xml
   

   

   На закладке параметры включим проверку новых версий при старте и включите отображение экспериментальных модулей
   

   
3. Перейдем на закладку расширений. Если все было сделано правильно, в списке расширений будут указаны неколько расширений и из нашего репозитория, которые можно тут же установить, обновить или удалить
4. Включим автоматическое обновление при загрузке QGIS («Проверять обновления при запуске»). Теперь, если будет увеличена версия расширения в XML, QGIS даст знать с помощью сообщения в строке статуса программы, что расширение изменилось и его можно обновить. Щелчок на надпись откроет установщик расширений
   
   

   Либо в самом установщике расширений
   

   

[править] Ссылки по теме

• Разработка простого расширения для QGIS на Python
• Автоматическое обновление репозитория расширений QGIS из SVN