Voltron: Новая страница: «{{Статья|Опубликована|qgis-repo}} {{Аннотация|Как создать и использовать хранилище расширений…»

2012-07-25T14:08:47Z

Новая страница: «{{Статья|Опубликована|qgis-repo}} {{Аннотация|Как создать и использовать хранилище расширений…»

Новая страница

{{Статья|Опубликована|qgis-repo}}
{{Аннотация|Как создать и использовать хранилище расширений QGIS.}}

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

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

=== Создание репозитория ===

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

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

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

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

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

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

<syntaxhighlight lang="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>
</syntaxhighlight>

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

<syntaxhighlight lang="xml"><pyqgis_plugin></pyqgis_plugin></syntaxhighlight>

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

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

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

=== Работа с репозиторием в QGIS ===

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

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

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

Для этого:

<ol>
<li>Подключим, если оно еще не подключено расширение «Plugin Installer» («Модули → Управление модулями») 
[[Файл:qgis-repo-01.gif|center]]
</li>
<li>Вызовем установщик расширений «Модули → Загрузить модули» и перейдем на закладку «Репозитории». Исходно в ней содержится только один, официальный репозиторий 
[[Файл:qgis-repo-02.gif|center]]
Чтобы добавить остальные, нажмем на кнопку Добавить сторонние репозитории, добавятся все остальные, среди которых будет и репозиторий GIS-Lab 
[[Файл:qgis-repo-07.gif|center]]
Если по какой-то причине у вас это не получилось, можно добавить репозиторий вручную («Добавить») 
<pre>
Имя: GIS-Lab
Адрес: http://gis-lab.info/programs/qgis/qgis-repo.xml
</pre>
[[Файл:qgis-repo-03.gif|center]]
На закладке параметры включим проверку новых версий при старте и включите отображение экспериментальных модулей 
[[Файл:qgis-repo-08.gif|center]]
</li>
<li>Перейдем на закладку расширений. Если все было сделано правильно, в списке расширений будут указаны неколько расширений и из нашего репозитория, которые можно тут же установить, обновить или удалить</li>
<li>Включим автоматическое обновление при загрузке QGIS («Проверять обновления при запуске»). Теперь, если будет увеличена версия расширения в XML, QGIS даст знать с помощью сообщения в строке статуса программы, что расширение изменилось и его можно обновить. Щелчок на надпись откроет установщик расширений 
[[Файл:qgis-repo-04.gif|center]]
Либо в самом установщике расширений 
[[Файл:qgis-repo-05.gif|center]]
</li>
</ol>

=== Ссылки по теме ===

* [http://gis-lab.info/qa/qgis-dev-python.html Разработка простого расширения для QGIS на Python]
* [http://gis-lab.info/qa/qgis-repo-update.html Автоматическое обновление репозитория расширений QGIS из SVN]

Организация и работа с репозиториями расширений QGIS - История изменений

Voltron: Новая страница: «{{Статья|Опубликована|qgis-repo}} {{Аннотация|Как создать и использовать хранилище расширений…»