ONLYOFFICE Desktop Editors no incluye una opción para habilitar el desarrollo de complementos. El flujo de trabajo recomendado consiste en instalar el complemento mediante el Administrador de complementos, ubicarlo en la carpeta local de complementos y, opcionalmente, reemplazar la copia instalada con un enlace simbólico a la carpeta de código fuente. Para inspeccionar errores y usar puntos de interrupción, inicie la aplicación de escritorio con la opción de depuración activada. Estos pasos son independientes: el modo de depuración expone las herramientas de desarrollo, mientras que la instalación o el enlace del complemento lo ponen a disposición del editor.
La documentación actual de la API de ONLYOFFICE describe este mismo flujo de trabajo de escritorio y también documenta una opción para mantener el modo de depuración activado entre ejecuciones. No encontré ninguna notificación oficial sobre una nueva opción para activar el modo de desarrollo que modifique estos pasos. Esta guía sigue las instrucciones oficiales disponibles el 6 de octubre de 2026. Las rutas pueden variar según el tipo de instalación, así que confirme la ruta para su plataforma antes de modificar los archivos.
| Acercarse | Lo mejor para | Compensación |
|---|---|---|
Instalar un .pluginarchivo en el Administrador de complementos | Instalación inicial, pruebas rápidas o cambios ocasionales. | Sencillo y compatible, pero debes reconstruir y reinstalar el archivo después de cada cambio de código fuente. |
| Vincula la carpeta del plugin instalado a tu carpeta de origen. | Ediciones frecuentes durante el desarrollo | Elimina el empaquetado repetido, pero requiere la ruta correcta por usuario y recargar o volver a abrir la aplicación para que se apliquen los cambios. |
| Iniciar con la bandera de depuración | Inspeccionar la salida de la consola, los marcos de los complementos o los puntos de interrupción. | Habilita las herramientas para desarrolladores; no instala ningún complemento ni carga automáticamente código no confiable. |
Para la mayoría de los desarrolladores, basta con usar el archivo una sola vez para registrar el complemento y, posteriormente, un enlace simbólico para iterar. Añada la bandera de depuración únicamente al diagnosticar el código. Deje desactivada la variante persistente a menos que necesite herramientas de desarrollo en cada inicio.
Comience con un directorio local de complementos que contenga al menos los archivos necesarios para su complemento, incluidos config.jsony index.html. El archivo de configuración debe tener un GUID de complemento válido y apuntar a la página de entrada y los recursos del complemento utilizando el esquema de complementos de ONLYOFFICE. Consulte los complementos de ejemplo oficiales o la documentación de la API para obtener el esquema completo; un GUID mal formado, una ruta rota o una configuración no válida pueden impedir que el complemento aparezca.
El GUID config.jsonsuele tener el formato asc.{YOUR-GUID}. Los editores de escritorio utilizan el GUID como nombre de la carpeta del complemento, pero omiten el asc.prefijo. Mantenga el mismo GUID en el directorio de origen, el archivo y la ruta de instalación. No reutilice el GUID de un complemento integrado ni de otro complemento instalado.
.zipa .plugin..pluginarchivo y confirma.El complemento debería aparecer en la pestaña «Complementos» del editor abierto y en los editores que se abran posteriormente. El método de archivo manual funciona sin conexión a internet. La instalación desde Marketplace está pensada para complementos listos para usar; no sustituye la instalación de una versión de desarrollo propia.
Tras la primera instalación, Desktop Editors guarda una copia en un sdkjs-pluginsdirectorio. Reemplaza esa copia con un enlace simbólico a tu carpeta de origen para poder editar directamente los archivos de trabajo. Cierra Desktop Editors antes de modificar la carpeta del plugin de prueba instalado. Realiza una copia de seguridad o asegúrate de que tu carpeta de origen esté intacta y elimina únicamente la carpeta que coincida con el GUID de tu plugin de prueba.
| Sistema operativo | Directorio de complementos de usuario |
|---|---|
| Windows | %LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\ |
| macOS | ~/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/ |
| Linux | ~/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/ |
Dentro del directorio, el nombre del enlace es el GUID entre llaves sin el asc.prefijo. Por ejemplo, si el GUID de configuración es asc.{91EAC419-EF8B-440C-A960-B451C7DF3A37}, el nombre de la carpeta o enlace es {91EAC419-EF8B-440C-A960-B451C7DF3A37}.
Abra el Símbolo del sistema como administrador si su cuenta o política de Windows lo requiere. Después de cerrar los editores y mover la carpeta test-plugin instalada a un lugar apartado, cree el enlace del directorio:
mklink /D "%LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\{YOUR-GUID}" "C:\path\to\your\plugin"Sustituya ambos marcadores de posición por el GUID y la ruta completa a su directorio de origen. El destino del enlace no debe existir previamente.
ln -s "/path/to/your/plugin" "$HOME/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/{YOUR-GUID}"ln -s "/path/to/your/plugin" "$HOME/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/{YOUR-GUID}"Utilice las rutas correspondientes a su edición instalada; las versiones empaquetadas o aisladas pueden almacenar los datos del usuario en otra ubicación. Tras editar el código fuente, vuelva a abrir el documento o recargue el complemento según corresponda. El enlace simbólico evita la reconstrucción del archivo, pero los cambios no se aplican necesariamente hasta que el editor recarga el complemento.
Para depurar un complemento, cierre completamente Desktop Editors e inícielo con --ascdesktop-support-debug-info. Use el comando correspondiente a su sistema operativo; si instaló la aplicación en una ubicación personalizada, ajuste la ruta del ejecutable.
Ejecuta esto en el símbolo del sistema:
"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-infoComo alternativa, edite el campo Destino de un acceso directo agregando un espacio y el indicador después de la ruta del ejecutable. Esto afecta a los inicios realizados a través de ese acceso directo.
"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-infoUna vez que la aplicación esté en funcionamiento, haga clic dentro de un documento y presione F1, o haga clic con el botón derecho en un campo editable de la barra de herramientas y seleccione Inspeccionar elemento . En las herramientas para desarrolladores, seleccione el iframe del complemento para inspeccionar su propio JavaScript y registros. El código que se pasa a callCommandse ejecuta en el marco del editor, llamado frameEditor, por lo que sus errores y puntos de interrupción pueden aparecer en un contexto diferente al del código de la interfaz de usuario del complemento.
El indicador opcional --ascdesktop-support-debug-info-keep=1mantiene el modo de depuración activado entre ejecuciones. Para desactivar el estado persistente, ejecute con --ascdesktop-support-debug-info-keep=0; use --ascdesktop-support-debug-info-keep=defaultpara volver al estado predeterminado. Las herramientas de desarrollo persistentes son útiles en una máquina de prueba dedicada, pero dejarlas activadas en una estación de trabajo compartida genera desorden y mantiene las herramientas de inspección disponibles cuando no se necesitan.
F1o a través de la función Inspeccionar elemento después de iniciar la aplicación con la bandera de depuración.frameEditor.Si falta el complemento, verifique que config.jsonse index.htmlencuentre en la raíz del archivo, que el GUID sea válido y que la carpeta utilice el GUID sin el asc.prefijo. Confirme que el enlace apunte al directorio de origen y no a un directorio superior que lo contenga. Si el complemento aparece pero se comporta como una versión anterior, cierre y vuelva a abrir el documento para que el editor recargue los archivos vinculados.
La opción de depuración para escritorio no es un interruptor de permisos global para el desarrollo de complementos. Instalar un archivo o colocar una carpeta en el directorio de complementos compatibles hace que dicho complemento esté disponible; la opción de depuración expone las herramientas de inspección. Del mismo modo, las instrucciones para cargar un complemento mediante su URL en un editor web no se aplican automáticamente a los editores de escritorio. Utilice el flujo de trabajo de instalación y depuración específico para escritorio descrito anteriormente.
Estas instrucciones se refieren a los complementos para los editores de escritorio de ONLYOFFICE. No explican cómo habilitar complementos en DocSpace, cómo configurar complementos del lado del servidor en ONLYOFFICE Docs ni cómo publicar un complemento en el Marketplace. Para esos procesos, consulte la documentación oficial del producto.
Configura el desarrollo de plugins en los editores de escritorio de ONLYOFFICE: instala un archivo .plugin local, crea un enlace a tu carpeta de origen, habilita las herramientas para desarrolladores y prueba los cambios.
Aprende cuándo usar macros de Python directamente en Calc y cómo llamar a funciones de Python desde LibreOffice Basic con ejemplos prácticos de UNO y ScriptForge.
Solucione el error "Host WOPI no autorizado" de Collabora Online CODE haciendo coincidir el nombre de host de WOPI, configurando los grupos de hosts de Docker, comprobando la lista de direcciones IP permitidas de Nextcloud y verificando la conectividad.
Fix ONLYOFFICE “Token is not valid” errors in Nextcloud by checking the JWT secret, authorization header, Docker settings, proxy behavior, and connector health.
Solucione el error "No se pudo guardar el documento" de ONLYOFFICE en Nextcloud revisando las devoluciones de llamada, las URL internas, JWT, TLS, el enrutamiento del proxy, los registros y el almacenamiento.
Solucione los errores de conexión de socket de Collabora Online revisando el cambio de WebSocket 26.04, las rutas de proxy, los encabezados de actualización, los tiempos de espera, TLS y los registros.
Habilite la revisión ortográfica multilingüe en Collabora Online agregando diccionarios de servidor, permitiendo códigos de idioma, asignando idiomas al texto y probando documentos con varios idiomas.
Create a reliable LibreOffice Writer mail merge with per-record images using Calc data, a named image placeholder, and a Basic macro, with troubleshooting and verification steps.
Diagnostica y soluciona los fallos de conexión de documentos de Collabora Online comprobando WOPI, el proxy inverso, TLS, DNS, WebSockets y la accesibilidad entre servidores.
Convierta un PDF a un DOCX editable en los editores de escritorio de ONLYOFFICE sin conexión. Siga los pasos de Guardar como, compruebe si el PDF se ha escaneado y revise el formato.
