Plugins y marketplace

Gran parte de la funcionalidad de MappView se distribuye como plugins. El menú Plugins activa los plugins integrados, y el cuadro de diálogo Gestionar plugins (en Configuración) instala, actualiza y elimina plugins externos de un registro seleccionado.

El menú Plugins

El menú Plugins enumera todos los plugins disponibles en Activar plugin. Haga clic en un plugin para activarlo o desactivarlo; una marca de verificación indica cuáles están activos. Los plugins integrados incluyen Layer Control, Basemaps, Components (Measure, Bookmark, Legend, Colorbar, Minimap, View State, Search, Print, HTML), GeoEditor, Time Slider, Layer Swipe, Street View, USGS LiDAR, Overture Maps, GeoAgent, Historical Imagery y el grupo federal de Web Services. Consulte Integraciones de datos.

Para los plugins que añaden un control sobre el mapa, un submenú permite posicionar el control en cualquier esquina: superior izquierda, superior derecha, inferior izquierda o inferior derecha.

Gestionar plugins

Abra Configuración → Gestionar plugins para explorar el marketplace. El cuadro de diálogo está modelado según QGIS, con secciones para Todos, Instalados, No instalados, Actualizables y Configuración.

• Busque en el registro e Instale una entrada con un solo clic. La instalación registra la URL del manifiesto del plugin y lo registra inmediatamente, sin reinicio.
• Actualizar aparece cuando se publica una versión más reciente; vuelve a obtener y registrar el plugin en su lugar, conservando la versión antigua si la actualización falla.
• Desinstalar (tras una confirmación) anula el registro del plugin en tiempo de ejecución y desmonta cualquier control activo.
• La sección Configuración gestiona fuentes adicionales de plugins: directorios locales extra y URL de manifiestos manuales.

La compatibilidad se comprueba con respecto al minMappViewVersion de cada entrada, por lo que los plugins incompatibles se marcan en lugar de instalarse.

!!! note “Modelo de confianza” El registro del marketplace está seleccionado, los manifiestos exigen HTTPS (o HTTP en localhost, 127.0.0.1 o [::1] para desarrollo), y las instalaciones provenientes del marketplace o de proyectos requieren consentimiento explícito porque los plugins se ejecutan como código de confianza. Un operador del despliegue puede aprobar por separado URL exactas de manifiesto a través del registro de confianza; esas URL se cargan sin aviso, de modo que el control de ese registro equivale al control del código de la aplicación desplegada.

Origen de los plugins

• Registro seleccionado: el marketplace obtiene el registro JSON configurado mediante VITE_MAPPVIEW_PLUGIN_REGISTRY_URL. Por defecto es el origen de plugins del despliegue (registry.json en producción; también se incluye una copia en cada build).
• Registro de confianza del despliegue: la aplicación registra automáticamente las URL exactas de manifiesto publicadas por VITE_MAPPVIEW_TRUSTED_PLUGIN_REGISTRY_URL. Estos plugins aprobados por el despliegue no muestran un aviso de confianza del proyecto, pero el estado guardado del proyecto sigue controlando la activación.
• URL de manifiesto: apunte la sección de Configuración a cualquier URL de manifiesto plugin.json.
• Directorio local: cargue un plugin desde una carpeta local (aplicación de escritorio).
• Drop-ins incluidos: los plugins situados en public/plugins/<id>/ se cargan automáticamente en una build.

Escribir su propio plugin

Para construir un plugin, consulte Referencia → Plugin API para ver las interfaces TypeScript, el contrato del manifiesto plugin.json y la lista de plugins integrados.