Complementos QGIS

O QGIS foi concebido para trabalhar com uma arquitetura de complementos. Isto permite que muitas novas feições/funções seja adicionadas. Muitas destas feições já estão atualmente inclusas (complementos internos que já vêm com o QGIS) e complementos externos, que você pode adicionar sob demanda.

  • Complementos Internos são mantidos pelo time de desenvolvimento do QGIS e estão presentes na sua distribuição QGIS. Eles são escritos em uma ou duas linguagens C++ ou Python. Mais informações sobre complementos internos podem ser vistas na Seção Usando Complementos Internos

  • Complementos Externos são atualmente escritos em linguagem Python. Eles estão armazenados no repositório Oficial do QGIS e podem ser adicionados a partir de Instalador de Complementos Python. Mais informações sobre os complementos externos podem ser vistas na Seção Carregar um complemento externo do QGIS.

Gerenciar Complementos

Gerenciar complementos em geral significa carregar ou descarregar estes usando o Gerenciador de Complementos. Complementos externos podem ser instalados e diretamente ativados ou desinstalados usando-se o Instalados de Complementos Python. Para desativar ou reativar complementos externos, o Gerenciador de Complementos deverá ser usado novamente.

Carregar um complemento interno

Para carregar um complemento interno use o menu principal Complementos ‣ Gerenciar Complementos

Figure Plugins 1:

../../../_images/pluginmanager.png

Plugin Manager nix

The Plugin Manager lists all the available plugins and their status (loaded or unloaded), including all core plugins and all external plugins that have been installed and automatically activated using the Python Plugin Installer (see Section Carregar um complemento externo do QGIS). Those plugins that are already loaded have a check mark to the left of their name. Figure_plugins_1 shows the Plugin Manager dialog.

Para habilitar um complemento externo, marque aquele que deseja instalar e clique em [OK]. Ao você sair do QGIS, uma lista de complementos instalados será salva, para na sua próxima seção do QGIS ser carregada novamente.

Dica

Complementos quedrados

If you find that QGIS crashes on startup, a plugin may be at fault. You can stop all plugins from loading by editing your stored settings file (see Opções for location). Locate the plugins settings and change all the plugin values to false to prevent them from loading.

nix For example, to prevent the ‘Delimited text’ plugin from loading, the entry in $HOME/.config/QuantumGIS/qgis.conf on Linux should look like this: Add Delimited Text Layer=false.

Do this for each plugin in the [Plugins] section. You can then start QGIS and add the plugins one at a time from the Plugin Manager to determine which plugin is causing the problem.

Carregar um complemento externo do QGIS

External QGIS plugins are written in Python. They are by default stored in either the ‘Official’ QGIS Repository, or in various other external repositories maintained by individual authors. The ‘Official’ QGIS Repository is added by default in Python Plugin installer.

Detailed documentation about the usage, minimum QGIS version, homepage, authors, and other important information are provided for the ‘Official’ QGIS Repository at http://plugins.qgis.org/plugins/. For other external repositories, they might be available with the external plugins themselves. In general it is not included in this manual.

Nota

Updates of core python plugins may be available in this repository as external overlays.

Nota

fTools, Mapserver Export e o Instalador de Complmentos são complementos Python, mas eles são também parte da fonte do QGIS e são automaticamente carregados e habilitados no Gerenciador de Complementos QGIS (ver Seção Carregar um complemento externo do QGIS).

Currently there are over 150 external plugins available from the ‘Official’ QGIS Repository. Some of these plugins offer functionality that will be required by many users (for example: providing the user with the ability to view and edit OpenStreetMap data, or to add GoogleMap layers) while others offer very specialized functions (for example: Calculate economic pipe diameters for water supply networks).

Estas funcionalidades são bastante úteis para buscar através de todos os complementos externos, fornecendo uma palavra de busca, escolhendo um nome de repositório e/ou filtrando pela situação do complemento em seu computador (atualmente instalado ou desinstalado). Ações de buscar e filtrar podem ser realizadas a partir do Instalador de Complementos Python (veja figure_plugins_2).

Dica

Adicionar mais repositórios

To add external author repositories, open the Plugin Installer (Plugins ‣ Fetch Python Plugins), go to the tab Repositories, and click [Add]. If you do not want one or more of the added repositories, they can be disabled via the [Edit...] button, or completely removed with the [Delete] button.

Existe apenas um passo necessário para integrar complementos externos ao QGIS:

  • Baixe um complemento externo a partir de um repositório usando o Instalador de Complementos Python (veja Usando o Instalador de Complementos Python). O novo complemento será adicionado a lista de complementos disponíveis no Gerenciador de Complementos e ele será automaticamente carregado.

Usando o Instalador de Complementos Python

In order to download and install an external Python plugin, go to Plugins ‣ plugin_installer Fetch Python Plugins. The Plugin Installer window will appear (figure_plugins_2) with the tab Plugins, containing a list of all locally installed Python plugins, as well as plugin available in remote repositories.

Figure Plugins 2:

../../../_images/plugininstaller.png

Installing external python plugins nix

Cada complemento pode estar:

  • não instalado - isto significa que o complemento está disponível no repositório, mas não está ainda instalado. Para instalá-lo, selecione o complemento a partir da lista e clique no botão [Instalar/atualizar complemento].

  • novo - isto significa que o complemento foi recentemente adicionado ao repositório.

  • instalado - indica que o complemento já está instalado. Se ele estiver disponível em outro repositório, o botão [Reinstalar complemento] estará habilitado. Se a versão disponível for mais antiga do que a versão instalada, então, o botão [Desatualizar complemento] aparecerá.

  • Atualizável - significa que o complemento está instalado, mas existe uma versão mais atual disponível. Neste caso, estarão disponíveis os botões [Atualizar complemento] e [Atualizar tudo].

  • Inválido - significa que o complemento está instalado, mas está indisponível ou quebrado. A razão será explicada no campo de descrição do complemento.

Aba Complementos

Para instalar um complemento, selecione-o a partir da lista e clique no botão [Instalar complemento]. O complemento será ativado e instalado no seu PC.

  • nix Linux and other unices
    • /share/qgis/python/plugins
    • $HOME/.qgis/python/plugins
  • osx Mac OS X
    • /Contents/MacOS/share/qgis/python/plugins
    • /Users/$USERNAME/.qgis/python/plugins
  • win Windows
    • C:\Program Files\QGIS\python\plugins
    • C:\Documents and Settings\$USERNAME\.qgis\python\plugins

Se a instalação for bem sucedida, uma mensagemn de confirmação aparecerá.

If the installation fails, the reason for the failure will be displayed in a warning dialog. Most often, errors are the result of connection problems and/or missing Python modules. In the former case you will likely need to wait before trying the install again, in the latter case, you should install the missing modules relevant to your operating system prior to using the plugin. For Linux, most required modules should be available via a package manager. For install instructions in Windows visit the module home page.

If you are using a proxy, you may need to configure it under Edit ‣ Options (Gnome, OSX) or Settings ‣ Options (KDE, Windows)` on the Proxy tab.

O botão [Desinstalar complemento] aparece habilitado se o complemento estiver instalado e não for um complmento interno. Note que se você possuir instalado uma atualização para um complemento interno, você pode desinstalar esta atualização com **[Desinstalar complemento]**e reverter para a versão padrão entregue com sua versão do QGIS. Esta versão padrão, por sua vez, não pode ser desinstalada.

Aba Repositórios

The second tab Repositories, contains a list of plugin repositories available for the Plugin Installer. By default, only the QGIS Official Repository is enabled. You can add several user-contributed repositories, including the central QGIS Contributed Repository and other external repositories by clicking the [Add ...] button. The added repositories contain a large number of useful plugins which are not maintained by the QGIS Development Team. As such, we cannot take any responsibility for them. You can also manage the repository list manually, that is add, remove, and edit the entries. Temporarily disabling a particular repository is possible by clicking the [Edit ...] button.

Aba Opções

A aba Opções é onde você pode configurar as configurações do Instalador de Complementos. A checkbox Verificar por atualizações ao iniciar` marcada fará com que o QGIS verifique por atualizações de complementos sempre ao iniciar. O ajuste de frequência de verificação de atualizações pode ser feito através do menu de opções e, pode ser ajustado desde todos os dias até um intervalo mensal. Se um novo complemento ou atualização estiver disponível para um dos complementos instalados, uma notificação aparecerá na barra de situação. Se a opção checkbox Verificar por atualizações ao iniciar` não estiver marcada, a verificação deverá ser feita manualmente quando aberto o Instalador de Complementos.

Embora o atualizador do instalador de complementos consiga manusear portas diferentes de 80, algumas conexões de internet porderão causar problemas quando tentar verificar por atualizações, um indicador Buscando por novos complementos... estará visível na Barra de Situação durante toda a sua seção do QGIS e pode causar o fechamento do programa. Neste caso, desabilite a caixa de seleção.

Adicionalemente, voc^epode especificar o tipo dos complementos que são mostrados pelo Instalador de Complementos Python. Sob Complementos permitidos, você pode especificar o que você deseja fazer:

  • radiobuttonon Only show plugins from the official repository
  • radiobuttonoff Show all plugins except those marked as experimental
  • radiobuttonoff Show all plugins, even those marked as experimental

Dica

Usando complmentos experimentais

Complementos experimentais não são indicados para uso de produção. Estes complementos estão em estágio inicial de desenvolvimento e podem ser considerados como ferramentas ‘incompletas’. O time de desenvolvimento do QGIS não recomenda a instalação destes complementos ao menos que você deseje testá-los.

Provedores de dados

Data Providers are ‘special’ plugins that provides access to a data store. By default, QGIS supports PostGIS layers and disk-based data stores supported by the GDAL/OGR library. A Data Provider plugin extends the ability of QGIS to use other data sources.

Os complementos de Provedores de Dados são registrados automaticamente pelo QGIS ao iniciar. Eles não são gerenciados pelo Gerenciador de Complementos, mas usados atrás das cenas quando um tipo de dado é adicionado como uma camada do QGIS.