<\/p>\n\n\n\n
def classFactory(iface):\n from .mi_plugin import MiPlugin\n return MiPlugin(iface)\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n
Por ahora, basta con recordar que:<\/p>\n\n\n\n
\n- este archivo es obligatorio,<\/li>\n\n\n\n
- establece el v\u00ednculo entre QGIS y tu c\u00f3digo principal.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n<\/span>Explicaci\u00f3n l\u00ednea por l\u00ednea<\/span><\/h3>\n\n\n\n<\/span>1️⃣ def classFactory(iface):<\/code><\/span><\/h4>\n\n\n\n✔ QGIS busca obligatoriamente una funci\u00f3n con este nombre: classFactory<\/strong>.<\/p>\n\n\n\nCuando QGIS lee tu plugin, llama autom\u00e1ticamente a:<\/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
y transmite:<\/p>\n\n\n\n
\n- iface<\/strong> = la interfaz de QGIS (el objeto
QgisInterface<\/code>).<\/li>\n<\/ul>\n\n\n\nEste objeto da acceso a:<\/p>\n\n\n\n
\n- el lienzo del mapa (mapCanvas<\/em>),<\/li>\n\n\n\n
- el men\u00fa Plugins,<\/li>\n\n\n\n
- las barras de herramientas,<\/li>\n\n\n\n
- la capa activa,<\/li>\n\n\n\n
- los mensajes y registros, etc.<\/li>\n<\/ul>\n\n\n\n
➡️ Es el objeto central que permite a un plugin interactuar con QGIS.<\/p>\n\n\n\n
\n\n\n\n<\/span>2️⃣ from .mi_plugin import MiPlugin<\/code><\/span><\/h4>\n\n\n\nEl punto .<\/code> significa: \u201cen la misma carpeta que este archivo\u201d.<\/p>\n\n\n\nQGIS carga as\u00ed la clase principal desde:<\/p>\n\n\n\n
mi_plugin.py\n<\/code><\/pre>\n\n\n\nEsta clase contiene:<\/p>\n\n\n\n
\ninitGui()<\/code> \u2192 a\u00f1ade acciones, men\u00fas e iconos,<\/li>\n\n\n\nunload()<\/code> \u2192 elimina los elementos del plugin,<\/li>\n\n\n\n- las funciones de negocio (activaci\u00f3n de herramientas, apertura de ventanas, etc.).<\/li>\n<\/ul>\n\n\n\n
➡️ Es la clase ra\u00edz del plugin, la que lo controla todo.<\/p>\n\n\n\n
\n\n\n\n<\/span>3️⃣ return MiPlugin(iface)<\/code><\/span><\/h4>\n\n\n\nQGIS espera una instancia<\/strong> de la clase, no la clase en s\u00ed.<\/p>\n\n\n\nPor tanto:<\/p>\n\n\n\n
\n- se instancia la clase
MiPlugin<\/code>,<\/li>\n\n\n\n- se le pasa la interfaz de QGIS (
iface<\/code>).<\/li>\n<\/ul>\n\n\n\nQGIS utilizar\u00e1 este objeto para:<\/p>\n\n\n\n
\n- llamar a
initGui()<\/code> al activar el plugin,<\/li>\n\n\n\n- llamar a
unload()<\/code> al desactivarlo.<\/li>\n<\/ul>\n\n\n\n➡️ Es la creaci\u00f3n efectiva del plugin dentro de QGIS.<\/p>\n\n\n\n
\n\n\n\n<\/span>📌 Resumen<\/span><\/h3>\n\n\n\n👉 __init__.py<\/code> indica a QGIS qu\u00e9 clase debe usar para el plugin.
👉 La funci\u00f3n classFactory()<\/code> es obligatoria en todo plugin QGIS.
👉 iface<\/code> es el acceso completo a la interfaz de QGIS.
👉 El plugin solo empieza a funcionar realmente tras la instanciaci\u00f3n:<\/p>\n\n\n\nMiPlugin(iface)\n<\/code><\/pre>\n\n\n\n
\n\n\n\n<\/span>El archivo metadata.txt<\/span><\/h2>\n\n\n\nEste archivo es fundamental: sin \u00e9l, QGIS no reconoce el plugin.<\/p>\n\n\n\n
Contiene la informaci\u00f3n general:<\/p>\n\n\n\n
\n- nombre del plugin,<\/li>\n\n\n\n
- descripci\u00f3n,<\/li>\n\n\n\n
- autor,<\/li>\n\n\n\n
- versi\u00f3n,<\/li>\n\n\n\n
- versi\u00f3n m\u00ednima de QGIS.<\/li>\n<\/ul>\n\n\n\n
Ejemplo:<\/p>\n\n\n\n
[general]\nname=Mi primer plugin\ndescription=Un plugin sencillo para aprender\nversion=0.1\nauthor=Tu nombre\nqgisMinimumVersion=3.16\n<\/code><\/pre>\n\n\n\nEste es el archivo que aparece en el gestor de plugins de QGIS.<\/p>\n\n\n\n
\n\n\n\n<\/span>El archivo principal Python (por ejemplo mi_plugin.py)<\/span><\/h2>\n\n\n\nAqu\u00ed se encuentra el coraz\u00f3n del plugin.<\/p>\n\n\n\n
Normalmente contiene:<\/p>\n\n\n\n
\n- la clase principal del plugin,<\/li>\n\n\n\n
- los m\u00e9todos
initGui()<\/code> y unload()<\/code>,<\/li>\n\n\n\n- el c\u00f3digo que a\u00f1ade un bot\u00f3n o un men\u00fa en QGIS.<\/li>\n<\/ul>\n\n\n\n
De forma muy esquem\u00e1tica:<\/p>\n\n\n
<\/div>
<\/div>
<\/div><\/div>
<\/p>\n\n\n\n
class MiPlugin:\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
No te preocupes si esto parece confuso por ahora: cada elemento se explicar\u00e1 progresivamente en los siguientes art\u00edculos.<\/p>\n\n\n\n
\n\n\n\n<\/span>Archivos opcionales pero muy habituales<\/span><\/h2>\n\n\n\n<\/span>Interfaces gr\u00e1ficas (.ui)<\/span><\/h3>\n\n\n\nQGIS utiliza Qt para las interfaces gr\u00e1ficas. Los archivos .ui<\/code> se crean con Qt Designer<\/strong>, sin escribir c\u00f3digo.<\/p>\n\n\n\nPermiten construir ventanas con:<\/p>\n\n\n\n
\n- botones,<\/li>\n\n\n\n
- listas desplegables,<\/li>\n\n\n\n
- campos de entrada.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n<\/span>Recursos (resources.qrc)<\/span><\/h3>\n\n\n\nEste archivo sirve para agrupar:<\/p>\n\n\n\n