Importante

A tradução é um esforço comunitário você pode contribuir. Esta página está atualmente traduzida em 94.74%.

17. Escrevendo um complemento de processamento

Dependendo do tipo de plug-in que você desenvolverá, pode ser uma opção melhor adicionar sua funcionalidade como um algoritmo de Processar (ou um conjunto deles). Isso proporcionaria uma melhor integração ao QGIS, funcionalidade adicional (já que pode ser executada nos componentes do Processar, como o modelador ou a interface de processamento em lote) e um tempo de desenvolvimento mais rápido (já que o Processar consumirá grande parte do trabalhos).

Para distribuir esses algoritmos, você deve criar um nov complemento que os adicione à Caixa de Ferramentas de Processar. O complemento deve conter um provedor de algoritmos, que deve ser registrado quando o complemento é instanciado.

17.1. Criando do zero

Para criar um complemento do zero que contém um provedor de algoritmos, siga estas etapas usando o Plugin Builder:

  1. Instale o complemento Plugin Builder

  2. Crie um novo complemento usando o Plugin Builder. Quando o Plugin Builder perguntar qual modelo usar, selecione “Processing provider”.

  3. O complemento criado contém um provedor com um único algoritmo. O arquivo do provedor e o arquivo do algoritmo são totalmente comentados e contêm informações sobre como modificar o provedor e adicionar algoritmos adicionais. Consulte-os para obter mais informações.

17.2. Atualizando um complemento

Se você deseja adicionar seu complemento existente ao Processar, precisará adicionar algum código.

  1. No seu arquivo metadata.txt, você precisa adicionar uma variável:

    hasProcessingProvider=yes

  2. No arquivo Python em que seu complemento está configurado com o método initGui, você precisa adaptar algumas linhas como esta:

     1from qgis.core import QgsApplication
 2from .processing_provider.provider import Provider
 3
 4class YourPluginName:
 5
 6    def __init__(self):
 7        self.provider = None
 8
 9    def initProcessing(self):
10        self.provider = Provider()
11        QgsApplication.processingRegistry().addProvider(self.provider)
12
13    def initGui(self):
14        self.initProcessing()
15
16    def unload(self):
17        QgsApplication.processingRegistry().removeProvider(self.provider)

  3. Você pode criar uma pasta processing_provider com três arquivos:

    • __init__.py com nada nele. Isso é necessário para criar um pacote Python válido.

    • provider.py que criará o Provedor de Processamento e exporá seus algoritmos.

       1from qgis.core import QgsProcessingProvider
 2from qgis.PyQt.QtGui import QIcon
 3
 4from .example_processing_algorithm import ExampleProcessingAlgorithm
 5
 6
 7class Provider(QgsProcessingProvider):
 8
 9    """ The provider of our plugin. """
10
11    def loadAlgorithms(self):
12        """ Load each algorithm into the current provider. """
13        self.addAlgorithm(ExampleProcessingAlgorithm())
14        # add additional algorithms here
15        # self.addAlgorithm(MyOtherAlgorithm())
16
17    def id(self) -> str:
18        """The ID of your plugin, used for identifying the provider.
19
20        This string should be a unique, short, character only string,
21        eg "qgis" or "gdal". This string should not be localised.
22        """
23        return 'yourplugin'
24
25    def name(self) -> str:
26        """The human friendly name of your plugin in Processing.
27
28        This string should be as short as possible (e.g. "Lastools", not
29        "Lastools version 1.0.1 64-bit") and localised.
30        """
31        return self.tr('Your plugin')
32
33    def icon(self) -> QIcon:
34        """Should return a QIcon which is used for your provider inside
35        the Processing toolbox.
36        """
37        return QgsProcessingProvider.icon(self)

    • example_processing_algorithm.py que contém o arquivo de algoritmo de exemplo. Copie/cole o conteúdo do arquivo script template e atualize-o de acordo com suas necessidades.

You should have a tree similar to this :

1└── your_plugin_root_folder
2   ├── __init__.py
3   ├── LICENSE
4   ├── metadata.txt
5   └── processing_provider
6         ├── example_processing_algorithm.py
7         ├── __init__.py
8         └── provider.py

  1. Agora você pode recarregar seu complemento no QGIS e deverá ver o seu exemplo de script na caixa de ferramentas Processar e modelador.