<\/p>\n\n\n\n
def classFactory(iface):\n from .meu_plugin import MeuPlugin\n return MeuPlugin(iface)\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n
Neste momento, basta lembrar que:<\/p>\n\n\n\n
\n- este arquivo \u00e9 obrigat\u00f3rio,<\/li>\n\n\n\n
- ele faz a liga\u00e7\u00e3o entre o QGIS e o c\u00f3digo principal do plugin.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n<\/span>Explica\u00e7\u00e3o linha por linha<\/span><\/h3>\n\n\n\n<\/span>1️⃣ def classFactory(iface):<\/code><\/span><\/h4>\n\n\n\n✔ O QGIS procura obrigatoriamente uma fun\u00e7\u00e3o com esse nome: classFactory<\/code><\/p>\n\n\n\nQuando o QGIS l\u00ea o plugin, ele chama automaticamente:<\/p>\n\n\n
<\/div>
<\/div>
<\/div><\/div>
<\/p>\n\n\n\n
classFactory(iface)\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n
e transmite:<\/p>\n\n\n\n
\niface<\/code> = a interface do QGIS (objeto QgisInterface<\/code>)<\/li>\n<\/ul>\n\n\n\nEsse objeto d\u00e1 acesso a:<\/p>\n\n\n\n
\n- o mapa (
mapCanvas<\/code>),<\/li>\n\n\n\n- o menu Plugins,<\/li>\n\n\n\n
- a barra de ferramentas,<\/li>\n\n\n\n
- a camada ativa,<\/li>\n\n\n\n
- mensagens e logs,<\/li>\n\n\n\n
- etc.<\/li>\n<\/ul>\n\n\n\n
➡️ \u00c9 o objeto central que permite ao plugin interagir com o QGIS.<\/p>\n\n\n\n
\n\n\n\n<\/span>2️⃣ from .meu_plugin import MeuPlugin<\/code><\/span><\/h4>\n\n\n\nO ponto (.<\/code>) significa: \u201cno mesmo diret\u00f3rio que este arquivo\u201d.<\/p>\n\n\n\nO QGIS carrega ent\u00e3o a classe principal a partir de:<\/p>\n\n\n\n
meu_plugin.py<\/code><\/p>\n\n\n\nEssa classe cont\u00e9m:<\/p>\n\n\n\n
\ninitGui()<\/code> \u2192 adiciona a\u00e7\u00f5es, menus e \u00edcones,<\/li>\n\n\n\nunload()<\/code> \u2192 remove os elementos do plugin,<\/li>\n\n\n\n- as fun\u00e7\u00f5es de neg\u00f3cio (ativa\u00e7\u00e3o de ferramentas, exibi\u00e7\u00e3o de janelas, etc.).<\/li>\n<\/ul>\n\n\n\n
➡️ \u00c9 a classe principal do plugin, aquela que controla tudo.<\/p>\n\n\n\n
\n\n\n\n<\/span>3️⃣ return MeuPlugin(iface)<\/code><\/span><\/h4>\n\n\n\nO QGIS espera uma inst\u00e2ncia da classe<\/strong>, e n\u00e3o a classe em si.<\/p>\n\n\n\nPortanto:<\/p>\n\n\n\n
\n- a classe
MeuPlugin<\/code> \u00e9 instanciada,<\/li>\n\n\n\n- a interface do QGIS (
iface<\/code>) \u00e9 passada como par\u00e2metro.<\/li>\n<\/ul>\n\n\n\nO QGIS usar\u00e1 esse objeto para:<\/p>\n\n\n\n
\n- chamar
initGui()<\/code> ao ativar o plugin,<\/li>\n\n\n\n- chamar
unload()<\/code> ao desativ\u00e1-lo.<\/li>\n<\/ul>\n\n\n\n➡️ \u00c9 a cria\u00e7\u00e3o concreta do plugin dentro do QGIS.<\/p>\n\n\n\n
\n\n\n\n<\/span>📌 Resumo<\/span><\/h3>\n\n\n\n👉 __init__.py<\/code> indica ao QGIS qual classe usar para o plugin.
👉 A fun\u00e7\u00e3o classFactory()<\/code> \u00e9 obrigat\u00f3ria em todo plugin QGIS.
👉 iface<\/code> fornece acesso completo \u00e0 interface do QGIS.
👉 O plugin s\u00f3 come\u00e7a realmente a funcionar ap\u00f3s a instancia\u00e7\u00e3o:<\/p>\n\n\n\nMeuPlugin(iface)\n<\/code><\/pre>\n\n\n\n
\n\n\n\n<\/span>O arquivo metadata.txt<\/code><\/span><\/h2>\n\n\n\nEste arquivo \u00e9 fundamental: sem ele, o QGIS n\u00e3o reconhece o plugin.<\/p>\n\n\n\n
Ele cont\u00e9m as informa\u00e7\u00f5es gerais:<\/p>\n\n\n\n
\n- nome do plugin,<\/li>\n\n\n\n
- descri\u00e7\u00e3o,<\/li>\n\n\n\n
- autor,<\/li>\n\n\n\n
- vers\u00e3o,<\/li>\n\n\n\n
- vers\u00e3o m\u00ednima do QGIS.<\/li>\n<\/ul>\n\n\n\n
Exemplo:<\/p>\n\n\n\n
[general]\nname=Meu primeiro plugin\ndescription=Um plugin simples para aprender\nversion=0.1\nauthor=Seu nome\nqgisMinimumVersion=3.16\n<\/code><\/pre>\n\n\n\n\u00c9 esse arquivo que aparece no gerenciador de plugins do QGIS.<\/p>\n\n\n\n
\n\n\n\n<\/span>O arquivo principal Python (ex.: meu_plugin.py<\/code>)<\/span><\/h2>\n\n\n\n\u00c9 aqui que est\u00e1 o cora\u00e7\u00e3o do plugin.<\/p>\n\n\n\n
Normalmente encontramos:<\/p>\n\n\n\n
\n- a classe principal do plugin,<\/li>\n\n\n\n
- os m\u00e9todos
initGui()<\/code> e unload()<\/code>,<\/li>\n\n\n\n- o c\u00f3digo que adiciona um bot\u00e3o ou menu no QGIS.<\/li>\n<\/ul>\n\n\n\n
De forma bem esquem\u00e1tica:<\/p>\n\n\n
<\/div>
<\/div>
<\/div><\/div>
<\/p>\n\n\n\n
class MeuPlugin:\n def __init__(self, iface):\n self.iface = iface\n\n def initGui(self):\n pass\n\n def unload(self):\n pass\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n
N\u00e3o se preocupe se isso ainda parecer confuso: cada elemento ser\u00e1 explicado progressivamente nos pr\u00f3ximos artigos.<\/p>\n\n\n\n
\n\n\n\n<\/span>Arquivos opcionais, mas muito comuns<\/span><\/h2>\n\n\n\n<\/span>Interfaces gr\u00e1ficas (.ui<\/code>)<\/span><\/h3>\n\n\n\nO QGIS utiliza o Qt para interfaces gr\u00e1ficas. Os arquivos .ui<\/code> s\u00e3o criados com o Qt Designer, sem escrever c\u00f3digo.<\/p>\n\n\n\nEles permitem construir janelas com:<\/p>\n\n\n\n
\n- bot\u00f5es,<\/li>\n\n\n\n
- listas suspensas,<\/li>\n\n\n\n
- campos de entrada.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n<\/span>Recursos (resources.qrc<\/code>)<\/span><\/h3>\n\n\n\nEste arquivo serve para agrupar:<\/p>\n\n\n\n