ONLYOFFICE Desktop Editors non documenta alcuna opzione per "Abilitare lo sviluppo di plugin". Il flusso di lavoro supportato prevede l'installazione del proprio plugin tramite Gestione plugin, il suo posizionamento nella cartella locale dei plugin e, facoltativamente, la sostituzione della copia installata con un collegamento simbolico alla cartella di origine di lavoro. Per esaminare gli errori e utilizzare i breakpoint, avviare l'applicazione desktop con il flag di debug documentato. Si tratta di passaggi distinti: la modalità di debug espone gli strumenti per sviluppatori, mentre l'installazione o il collegamento del plugin lo rende disponibile all'editor.
La documentazione API di ONLYOFFICE attualmente disponibile descrive lo stesso flusso di lavoro desktop e documenta anche un flag per mantenere la modalità di debug abilitata tra un avvio e l'altro. Non ho trovato alcuna comunicazione ufficiale relativa a una nuova opzione per la modalità di sviluppo che modifichi questi passaggi. Questa guida segue le istruzioni ufficiali disponibili il 6 ottobre 2026. I percorsi possono variare a seconda del tipo di installazione, quindi verificare il percorso per la propria piattaforma prima di modificare i file.
| Approccio | Ideale per | Scambio |
|---|---|---|
Installa un .pluginarchivio in Gestione plugin | Prima installazione, test rapidi o modifiche occasionali | Semplice e supportato, ma è necessario ricompilare e reinstallare l'archivio dopo ogni modifica al codice sorgente. |
| Collega la cartella del plugin installato alla tua cartella sorgente | Modifiche frequenti durante lo sviluppo | Rimuove i pacchetti duplicati, ma richiede il percorso corretto per ciascun utente e un ricaricamento o una riapertura per applicare le modifiche. |
| Avviare con il flag di debug | Ispezionare l'output della console, i frame dei plugin o i breakpoint. | Abilita gli strumenti per sviluppatori; non installa plugin né carica automaticamente codice non attendibile. |
Per la maggior parte degli sviluppatori, è consigliabile utilizzare l'archivio una sola volta per registrare il plugin, quindi utilizzare un collegamento simbolico per le iterazioni successive. Aggiungere il flag di debug solo durante la diagnostica del codice. Lasciare disattivata la variante persistente a meno che non siano necessari gli strumenti di sviluppo a ogni avvio.
Inizia creando una directory locale per i plugin contenente almeno i file richiesti dal plugin, inclusi config.jsone index.html. Il file di configurazione deve avere un GUID valido per il plugin e puntare alla pagina di ingresso e alle risorse del plugin utilizzando lo schema dei plugin ONLYOFFICE. Consulta i plugin di esempio ufficiali o la documentazione API per lo schema completo; un GUID non valido, un percorso errato o una configurazione non corretta possono impedire la visualizzazione del plugin.
Il GUID config.jsonha solitamente la forma asc.{YOUR-GUID}. Desktop Editors utilizza il GUID come nome della cartella del plugin, ma omette il asc.prefisso. Mantieni lo stesso GUID nella directory di origine, nell'archivio e nel percorso di installazione. Non riutilizzare il GUID di un plugin integrato o di un altro plugin installato.
.zipa .plugin..pluginfile e conferma.Il plugin dovrebbe quindi apparire nella scheda Plugin dell'editor aperto e negli editor aperti successivamente. La procedura di archiviazione manuale funziona anche senza connessione a Internet. L'installazione tramite Marketplace è pensata per plugin pronti all'uso; non sostituisce il caricamento della propria versione di sviluppo.
Dopo la prima installazione, Desktop Editors memorizza una copia in una sdkjs-pluginsdirectory. Sostituisci tale copia con un collegamento simbolico alla cartella sorgente in modo da poter modificare direttamente i file di lavoro. Chiudi Desktop Editors prima di modificare la cartella del plugin di test installato. Conserva una copia di backup o assicurati che la cartella sorgente sia integra e rimuovi solo la cartella corrispondente al GUID del plugin di test.
| Sistema operativo | directory dei plugin utente |
|---|---|
| Windows | %LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\ |
| macOS | ~/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/ |
| Linux | ~/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/ |
All'interno della directory, il nome del collegamento è il GUID tra parentesi graffe senza asc.prefisso. Ad esempio, se il GUID di configurazione è asc.{91EAC419-EF8B-440C-A960-B451C7DF3A37}, il nome della cartella o del collegamento è {91EAC419-EF8B-440C-A960-B451C7DF3A37}.
Apri il prompt dei comandi come amministratore se il tuo account Windows o i criteri di gruppo lo richiedono. Dopo aver chiuso gli editor e spostato la cartella del plugin di prova installato in un'altra posizione, crea il collegamento alla directory:
mklink /D "%LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\{YOUR-GUID}" "C:\path\to\your\plugin"Sostituisci entrambi i segnaposto con il GUID e il percorso completo della directory di origine. La destinazione del collegamento non deve già esistere.
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}"Utilizza i percorsi relativi alla tua edizione installata; le build pacchettizzate o in ambiente sandbox potrebbero memorizzare i dati utente altrove. Dopo aver modificato il codice sorgente, riapri il documento o ricarica il plugin, a seconda delle necessità. Il collegamento simbolico evita di ricompilare l'archivio, ma le modifiche non vengono necessariamente applicate finché l'editor non ricarica il plugin.
Per eseguire il debug di un plugin, chiudi completamente Desktop Editors e riavvialo con --ascdesktop-support-debug-info. Usa il comando per il tuo sistema operativo; se hai installato l'app in una posizione personalizzata, modifica il percorso dell'eseguibile.
Esegui questo comando nel prompt dei comandi:
"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-infoIn alternativa, è possibile modificare il campo Destinazione di un collegamento aggiungendo uno spazio e il flag dopo il percorso del file eseguibile. Questa modifica avrà effetto sugli avvii tramite tale collegamento.
"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-infoUna volta avviata l'app, fai clic all'interno di un documento e premi F1, oppure fai clic con il pulsante destro del mouse su un campo modificabile della barra degli strumenti e scegli Ispeziona elemento . Negli strumenti per sviluppatori, seleziona l'iframe del plugin per ispezionarne il codice JavaScript e i log. Il codice passato a callCommandviene eseguito nel frame dell'editor, denominato frameEditor, quindi i suoi errori e punti di interruzione potrebbero apparire in un contesto diverso rispetto al codice dell'interfaccia utente del plugin.
Il flag opzionale --ascdesktop-support-debug-info-keep=1mantiene la modalità di debug abilitata tra un avvio e l'altro. Per disattivare lo stato persistente, avviare con --ascdesktop-support-debug-info-keep=0; utilizzare --ascdesktop-support-debug-info-keep=defaultper tornare allo stato predefinito. Gli strumenti di sviluppo persistenti sono comodi su una macchina di test dedicata, ma lasciarli abilitati su una workstation condivisa aggiunge ingombro e mantiene gli strumenti di ispezione disponibili quando non servono.
F1o tramite Ispeziona elemento dopo l'avvio con il flag di debug.frameEditor.Se il plugin non è presente, verifica che i file config.jsone index.htmlsiano nella directory principale dell'archivio, che il GUID sia valido e che la cartella utilizzi il GUID senza asc.prefisso. Conferma che il collegamento punti alla directory di origine e non a una directory padre che la contiene. Se il plugin appare ma si comporta come una versione precedente, chiudi e riapri il documento in modo che l'editor ricarichi i file collegati.
Il flag di debug per desktop non è un interruttore di autorizzazione globale per lo sviluppo di plugin. L'installazione di un archivio o il posizionamento di una cartella nella directory dei plugin supportati rende il plugin disponibile; il flag di debug espone gli strumenti di ispezione. Allo stesso modo, le istruzioni per caricare un plugin tramite URL in un editor web non si applicano automaticamente agli editor desktop. Utilizzare il flusso di lavoro di installazione e debug specifico per desktop descritto sopra.
Queste istruzioni riguardano i plugin per ONLYOFFICE Desktop Editors. Non spiegano come abilitare i plugin in DocSpace, come configurare i plugin lato server in ONLYOFFICE Docs o come pubblicare un plugin sul Marketplace. Per queste procedure, consultare la documentazione ufficiale del prodotto.
Esegui LibreOffice in modalità headless in Docker per la conversione di file DOCX, XLSX, PPTX e PDF con un'immagine riproducibile, mount sicuri, font, profili e verifica.
Risolvi i problemi di avvio lento di LibreOffice su Windows 11 e Linux con la modalità di risoluzione dei problemi, i controlli delle estensioni, la riparazione del profilo e gli aggiornamenti specifici dell'installazione.
Configura lo sviluppo di plugin in ONLYOFFICE Desktop Editors: installa un archivio .plugin locale, collega la cartella sorgente, abilita gli strumenti per sviluppatori e testa le modifiche.
Scopri quando utilizzare le macro Python direttamente in Calc e come richiamare le funzioni Python da LibreOffice Basic con esempi pratici di UNO e ScriptForge.
Risolvi l'errore "Unauthorized WOPI Host" di Collabora Online CODE verificando la corrispondenza del nome host WOPI, configurando i gruppi di host Docker, controllando l'elenco IP consentito separato di Nextcloud e verificando la connettività.
Risolvi gli errori "Token non valido" di ONLYOFFICE in Nextcloud verificando il segreto JWT, l'intestazione di autorizzazione, le impostazioni Docker, il comportamento del proxy e lo stato del connettore.
Risolvi l'errore "Impossibile salvare il documento" di ONLYOFFICE in Nextcloud verificando callback, URL interni, JWT, TLS, routing proxy, log e spazio di archiviazione.
Risolvi gli errori di connessione socket di Collabora Online verificando la modifica WebSocket 26.04, le route proxy, le intestazioni di aggiornamento, i timeout, TLS e i log.
Abilita il controllo ortografico multilingue in Collabora Online aggiungendo dizionari server, consentendo i codici lingua, assegnando lingue al testo e testando documenti multilingue.
Crea una stampa unione affidabile con LibreOffice Writer, includendo immagini per ogni record, utilizzando i dati di Calc, un segnaposto per l'immagine con nome e una macro di base, con istruzioni per la risoluzione dei problemi e la verifica.
