{"id":16365,"date":"2026-05-29T10:00:00","date_gmt":"2026-05-29T08:00:00","guid":{"rendered":"https:\/\/www.sigterritoires.fr\/?p=16365"},"modified":"2026-05-23T14:55:38","modified_gmt":"2026-05-23T12:55:38","slug":"criar-plugin-qgis-com-plugin-builder","status":"publish","type":"post","link":"https:\/\/www.sigterritoires.fr\/index.php\/pt\/criar-plugin-qgis-com-plugin-builder\/","title":{"rendered":"[PT]Desenvolver um Plugin QGIS: Criar um Plugin com o Plugin Builder"},"content":{"rendered":"\n

Criar um plugin QGIS \u00e9 muito mais simples do que parece, especialmente para quem est\u00e1 come\u00e7ando a programar. Com o Plugin Builder<\/strong>, \u00e9 poss\u00edvel gerar em poucos minutos toda a estrutura de um plugin, sem escrever c\u00f3digo complexo.<\/p>\n\n\n\n

Neste segundo artigo do tutorial, vamos ver como criar seu primeiro plugin QGIS usando o Plugin Builder<\/strong>, passo a passo: instala\u00e7\u00e3o da ferramenta, escolha do template, desativa\u00e7\u00e3o das op\u00e7\u00f5es avan\u00e7adas e gera\u00e7\u00e3o do plugin.<\/p>\n\n\n\n

O objetivo \u00e9 obter rapidamente um plugin funcional no QGIS<\/strong>, para compreender o funcionamento geral antes de avan\u00e7ar gradualmente no c\u00f3digo Python.<\/p>\n\n\n\n

\n\n\n\n\n\n\n
\n\n\n\n
\n
\n
Contenu <\/p>\nToggle<\/span>
Criar o primeiro plugin com o Plugin Builder<\/a><\/li>
O que \u00e9 o Plugin Builder?<\/a><\/li>
Instalar o Plugin Builder<\/a><\/li>
Iniciar o assistente de cria\u00e7\u00e3o<\/a><\/li>
Informa\u00e7\u00f5es gerais do plugin<\/a>
Nome e descri\u00e7\u00e3o<\/a><\/li>
Vers\u00e3o e autor<\/a><\/li><\/ul><\/li>
Configura\u00e7\u00f5es t\u00e9cnicas importantes<\/a>
Escolha do template<\/a><\/li>
Op\u00e7\u00f5es que devem ser desmarcadas no in\u00edcio<\/a><\/li>
Classe do plugin<\/a><\/li>
Menu e \u00edcone<\/a><\/li><\/ul><\/li>
Gera\u00e7\u00e3o do plugin<\/a><\/li>
Onde colocar o plugin?<\/a><\/li>
Ativar o plugin no QGIS<\/a><\/li>
Entender o que o Plugin Builder criou<\/a><\/li>
Erros comuns para iniciantes<\/a><\/li>
O que voc\u00ea aprendeu<\/a><\/li>
E no pr\u00f3ximo artigo?<\/a><\/li><\/ul><\/nav><\/div>\n
<\/span>Criar o primeiro plugin com o Plugin Builder<\/span><\/h2>\n\n\n\n
No primeiro artigo, vimos para que servem os plugins QGIS e de quais arquivos eles s\u00e3o compostos. Agora \u00e9 hora de colocar a m\u00e3o na massa.<\/p>\n\n\n\n
O objetivo deste artigo \u00e9 simples: criar um plugin QGIS funcional sem escrever c\u00f3digo complexo<\/strong>, para entender o ciclo b\u00e1sico de desenvolvimento de um plugin.<\/p>\n\n\n\n
Para isso, vamos utilizar uma ferramenta essencial para iniciantes: Plugin Builder<\/strong>.<\/p>\n\n\n\n
\n\n\n\n
<\/span>O que \u00e9 o Plugin Builder?<\/span><\/h2>\n\n\n\n
O Plugin Builder \u00e9 um plugin oficial do QGIS que gera automaticamente a estrutura b\u00e1sica de um plugin.<\/p>\n\n\n\n
Ele cria para voc\u00ea:<\/p>\n\n\n\n
\n
a estrutura de pastas,<\/li>\n\n\n\n
os arquivos Python essenciais,<\/li>\n\n\n\n
o arquivo metadata.txt<\/code>,<\/li>\n\n\n\n
um plugin que pode ser carregado imediatamente no QGIS.<\/li>\n<\/ul>\n\n\n\nO Plugin Builder evita erros comuns no in\u00edcio e permite focar no mais importante: entender e modificar um plugin existente<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Instalar o Plugin Builder<\/span><\/h2>\n\n\n\n\nAbra o QGIS<\/li>\n\n\n\n V\u00e1 em Complementos \u2192 Gerenciar e Instalar Complementos<\/strong><\/li>\n\n\n\n Procure por Plugin Builder<\/strong><\/li>\n\n\n\n Instale o plugin<\/li>\n<\/ol>\n\n\n\nAp\u00f3s a instala\u00e7\u00e3o, o Plugin Builder estar\u00e1 dispon\u00edvel no menu Complementos<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>Iniciar o assistente de cria\u00e7\u00e3o<\/span><\/h2>\n\n\n\n\nMenu Complementos \u2192 Plugin Builder \u2192 Plugin Builder<\/strong><\/li>\n\n\n\n O assistente de cria\u00e7\u00e3o ser\u00e1 aberto<\/li>\n<\/ul>\n\n\n\nVoc\u00ea precisar\u00e1 preencher v\u00e1rias informa\u00e7\u00f5es. N\u00e3o se preocupe: algumas s\u00e3o apenas descritivas.<\/p>\n\n\n\n \n\n\n\n<\/span>Informa\u00e7\u00f5es gerais do plugin<\/span><\/h2>\n\n\n\n<\/span>Nome e descri\u00e7\u00e3o<\/span><\/h3>\n\n\n\n\nNome do plugin<\/strong>: nome leg\u00edvel para o usu\u00e1rio (ex.: MeuPrimeiroPlugin<\/em>)<\/li>\n\n\n\n Descri\u00e7\u00e3o<\/strong>: frase curta explicando a finalidade do plugin<\/li>\n<\/ul>\n\n\n\nEssas informa\u00e7\u00f5es aparecer\u00e3o no gerenciador de plugins do QGIS.<\/p>\n\n\n\n \n\n\n\n<\/span>Vers\u00e3o e autor<\/span><\/h3>\n\n\n\n\nVers\u00e3o<\/strong>: comece simplesmente com 0.1<\/code><\/li>\n\n\n\n Autor<\/strong>: seu nome ou o nome da sua organiza\u00e7\u00e3o<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>Configura\u00e7\u00f5es t\u00e9cnicas importantes<\/span><\/h2>\n\n\n\n<\/span>Escolha do template<\/span><\/h3>\n\n\n\nO Plugin Builder oferece v\u00e1rios templates (modelos de plugin).<\/p>\n\n\n\n Para quem est\u00e1 come\u00e7ando, \u00e9 fortemente recomendado<\/strong> escolher:<\/p>\n\n\n\n Template: Tool button with dialog<\/strong><\/p>\n\n\n\n Esse template \u00e9 o mais did\u00e1tico porque:<\/p>\n\n\n\n \ncria um bot\u00e3o na interface do QGIS,<\/li>\n\n\n\n prepara uma janela gr\u00e1fica simples,<\/li>\n\n\n\n corresponde \u00e0 maioria dos plugins comuns.<\/li>\n<\/ul>\n\n\n\nEle ser\u00e1 uma base s\u00f3lida para os pr\u00f3ximos artigos.<\/p>\n\n\n\n \n\n\n\n<\/span>Op\u00e7\u00f5es que devem ser desmarcadas no in\u00edcio<\/span><\/h3>\n\n\n\nPara o primeiro plugin, \u00e9 aconselh\u00e1vel desmarcar todas as op\u00e7\u00f5es avan\u00e7adas<\/strong>, especialmente:<\/p>\n\n\n\n \nInternationalization (tradu\u00e7\u00f5es)<\/li>\n\n\n\n Help (documenta\u00e7\u00e3o integrada)<\/li>\n\n\n\n Unit testing<\/li>\n\n\n\n Empacotamento avan\u00e7ado<\/li>\n<\/ul>\n\n\n\nEssas funcionalidades s\u00e3o \u00fateis em plugins mais maduros, mas complicam desnecessariamente a estrutura para iniciantes.<\/p>\n\n\n\n Vamos abord\u00e1-las mais adiante, quando os fundamentos estiverem bem consolidados.<\/p>\n\n\n\n \n\n\n\n<\/span>Classe do plugin<\/span><\/h3>\n\n\n\nO Plugin Builder solicita o nome da classe principal do plugin.<\/p>\n\n\n\n Exemplo:<\/p>\n\n\n\n \nNome do plugin: MeuPrimeiroPlugin<\/code><\/li>\n\n\n\n Classe: MeuPrimeiroPlugin<\/code><\/li>\n<\/ul>\n\n\n\nPor conven\u00e7\u00e3o, utiliza-se o mesmo nome e capitaliza\u00e7\u00e3o para evitar confus\u00f5es.<\/p>\n\n\n\n \n\n\n\n<\/span>Menu e \u00edcone<\/span><\/h3>\n\n\n\nVoc\u00ea pode indicar:<\/p>\n\n\n\n \no menu onde o plugin aparecer\u00e1 (normalmente Complementos<\/strong>),<\/li>\n\n\n\n um \u00edcone (opcional nesta etapa).<\/li>\n<\/ul>\n\n\n\nEssas escolhas podem ser alteradas facilmente depois.<\/p>\n\n\n\n \n\n\n\n<\/span>Gera\u00e7\u00e3o do plugin<\/span><\/h2>\n\n\n\nDepois de preencher todos os campos:<\/p>\n\n\n\n \nClique em Generate<\/strong><\/li>\n\n\n\n Escolha a pasta de destino<\/li>\n<\/ol>\n\n\n\nO Plugin Builder criar\u00e1 automaticamente a pasta do plugin com todos os arquivos necess\u00e1rios.<\/p>\n\n\n\n \n\n\n\n<\/span>Onde colocar o plugin?<\/span><\/h2>\n\n\n\nPara que o QGIS reconhe\u00e7a o plugin, ele deve estar na pasta de plugins do usu\u00e1rio.<\/p>\n\n\n\n Dependendo do sistema operacional:<\/p>\n\n\n\n \nWindows<\/strong> C:\/Users\/...\/AppData\/Roaming\/QGIS\/QGIS3\/profiles\/default\/python\/plugins<\/code><\/li>\n\n\n\n Linux<\/strong> ~\/.local\/share\/QGIS\/QGIS3\/profiles\/default\/python\/plugins<\/code><\/li>\n\n\n\n macOS<\/strong> ~\/Library\/Application Support\/QGIS\/QGIS3\/profiles\/default\/python\/plugins<\/code><\/li>\n<\/ul>\n\n\n\n💡 Dica: o Plugin Builder normalmente sugere essa pasta por padr\u00e3o.<\/p>\n\n\n\n \n\n\n\n<\/span>Ativar o plugin no QGIS<\/span><\/h2>\n\n\n\n\nV\u00e1 em Complementos \u2192 Gerenciar e Instalar Complementos<\/strong><\/li>\n\n\n\n Aba Instalados<\/strong><\/li>\n\n\n\n Marque o seu plugin<\/li>\n<\/ol>\n\n\n\nSe tudo tiver funcionado corretamente, o plugin aparecer\u00e1 no menu e poder\u00e1 ser ativado.<\/p>\n\n\n\n 👉 Neste ponto, o plugin praticamente n\u00e3o faz nada\u2026 e isso \u00e9 completamente normal.<\/p>\n\n\n\n \n\n\n\n<\/span>Entender o que o Plugin Builder criou<\/span><\/h2>\n\n\n\nAntes de seguir adiante, reserve um tempo para abrir os arquivos gerados:<\/p>\n\n\n\n \n__init__.py<\/code><\/li>\n\n\n\n metadata.txt<\/code><\/li>\n\n\n\n o arquivo Python principal<\/li>\n<\/ul>\n\n\n\nAgora voc\u00ea deve reconhecer os elementos descritos no artigo anterior.<\/p>\n\n\n\n \n\n\n\n<\/span>Erros comuns para iniciantes<\/span><\/h2>\n\n\n\n\no plugin n\u00e3o aparece \u2192 pasta incorreta<\/li>\n\n\n\n erro ao carregar \u2192 problema de mai\u00fasculas\/min\u00fasculas no nome da classe<\/li>\n\n\n\n QGIS rejeita o plugin \u2192 vers\u00e3o m\u00ednima do QGIS incorreta<\/li>\n<\/ul>\n\n\n\nEsses erros s\u00e3o normais e fazem parte do processo de aprendizagem.<\/p>\n\n\n\n \n\n\n\n<\/span>O que voc\u00ea aprendeu<\/span><\/h2>\n\n\n\nAo final deste artigo, voc\u00ea j\u00e1 sabe:<\/p>\n\n\n\n \ninstalar o Plugin Builder,<\/li>\n\n\n\n gerar um plugin QGIS vazio,<\/li>\n\n\n\n instal\u00e1-lo localmente,<\/li>\n\n\n\n ativ\u00e1-lo no QGIS.<\/li>\n<\/ul>\n\n\n\nVoc\u00ea atingiu uma etapa importante: agora \u00e9 oficialmente um desenvolvedor de plugins QGIS<\/strong>.<\/p>\n\n\n\n \n\n\n\n<\/span>E no pr\u00f3ximo artigo?<\/span><\/h2>\n\n\n\nNo pr\u00f3ximo artigo, veremos:<\/p>\n\n\n\n \ncomo adicionar um bot\u00e3o ao QGIS,<\/li>\n\n\n\n como exibir uma janela simples,<\/li>\n\n\n\n como organizar o c\u00f3digo sem se perder.<\/li>\n<\/ul>\n\n\n\n👉 Um plugin que hoje n\u00e3o faz nada pode se tornar amanh\u00e3 uma ferramenta poderosa.<\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"Criar um plugin QGIS \u00e9 muito mais simples do que parece, especialmente para quem est\u00e1 come\u00e7ando a programar. Com o Plugin Builder, \u00e9 poss\u00edvel gerar em poucos minutos toda a estrutura de um plugin, sem escrever…<\/p>\n","protected":false},"author":1,"featured_media":16328,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"give_campaign_id":0,"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"sfsi_plus_gutenberg_text_before_share":"","sfsi_plus_gutenberg_show_text_before_share":"","sfsi_plus_gutenberg_icon_type":"","sfsi_plus_gutenberg_icon_alignemt":"","sfsi_plus_gutenburg_max_per_row":"","_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[3418,2134],"tags":[4099,4161,4652,4166,4163,4103],"class_list":["post-16365","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin-pt","category-qgis","tag-criar-plugin-qgis","tag-desenvolvimento-de-plugin-qgis","tag-plugin-builder-qgis-pt","tag-plugin-qgis-com-python","tag-plugin-qgis-para-iniciantes","tag-tutorial-plugin-qgis"],"aioseo_notices":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/www.sigterritoires.fr\/wp-content\/uploads\/2026\/01\/pluginsQGIS2.jpg?fit=409%2C307&ssl=1","jetpack_shortlink":"https:\/\/wp.me\/p6XU0A-4fX","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16365","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/comments?post=16365"}],"version-history":[{"count":0,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/posts\/16365\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media\/16328"}],"wp:attachment":[{"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/media?parent=16365"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/categories?post=16365"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sigterritoires.fr\/index.php\/wp-json\/wp\/v2\/tags?post=16365"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}