ONLYOFFICE Desktop Editors nu documentează niciun parametru „Activează dezvoltarea pluginurilor”. Fluxul de lucru acceptat este de a instala propriul plugin prin Plugin Manager, de a-l plasa în folderul local al pluginurilor și, opțional, de a înlocui copia instalată cu un link simbolic către folderul sursă de lucru. Pentru a inspecta erorile și a utiliza puncte de întrerupere, lansați aplicația desktop cu semnalizatorul de depanare documentat. Aceștia sunt pași separați: modul de depanare expune instrumentele pentru dezvoltatori, în timp ce instalarea sau conectarea pluginului îl face disponibil editorului.
Documentația actuală a API-ului ONLYOFFICE descrie același flux de lucru pentru desktop și documentează, de asemenea, un semnalizator pentru menținerea modului de depanare activat la lansări. Nu am găsit nicio notificare oficială privind o nouă comutare a modului de dezvoltare care să modifice acești pași. Acest ghid urmează instrucțiunile oficiale disponibile pe 6 octombrie 2026. Căile pot varia în funcție de tipul de instalare, așa că confirmați calea pentru platforma dvs. înainte de a modifica fișierele.
Alegeți un flux de lucru pentru dezvoltarea pluginurilor
| Abordare | Cel mai bun pentru | Compromis |
Instalați o .pluginarhivă în Managerul de pluginuri | Prima instalare, teste rapide sau modificări ocazionale | Simplu și suportat, dar trebuie să reconstruiți și să reinstalați arhiva după fiecare modificare a sursei. |
| Legați folderul pluginului instalat la folderul sursă | Modificări frecvente în timpul dezvoltării | Elimină ambalajele repetate, dar necesită calea corectă pentru fiecare utilizator și o reîncărcare sau redeschidere pentru a prelua modificările. |
| Lansare cu semnalizatorul de depanare | Inspectarea ieșirii consolei, a cadrelor pluginului sau a punctelor de întrerupere | Activează instrumentele pentru dezvoltatori; nu instalează un plugin și nu încarcă automat cod nesigur. |
Pentru majoritatea dezvoltatorilor, folosiți arhiva o singură dată pentru a înregistra pluginul, apoi folosiți o legătură simbolică pentru iterație. Adăugați indicatorul de depanare doar atunci când diagnosticați codul. Lăsați varianta sa persistentă dezactivată, cu excepția cazului în care aveți nevoie de instrumente de dezvoltare la fiecare lansare.
Pregătiți fișierele pluginului
Începeți cu un director local de pluginuri care să conțină cel puțin fișierele necesare pluginului dvs., inclusiv config.jsonși index.html. Fișierul de configurare trebuie să aibă un GUID valid pentru plugin și să indice către pagina de intrare și resursele pluginului folosind schema pluginului ONLYOFFICE. Folosiți pluginurile oficiale de exemplu sau documentația API pentru schema completă; un GUID incorect, o cale întreruptă sau o configurație invalidă pot împiedica apariția pluginului.
GUID-ul din config.json[de obicei, ] are forma asc.{YOUR-GUID}. Desktop Editors folosește GUID-ul ca nume de folder pentru plugin, dar omite asc.prefixul. Păstrați același GUID în directorul sursă, arhivă și calea instalată. Nu reutilizați GUID-ul unui plugin încorporat sau al unui alt plugin instalat.
Instalați pluginul pentru prima dată
- Puneți fișierele și subfolderele pluginului într-o arhivă ZIP. Fișierele în sine trebuie să se afle la rădăcina arhivei, nu într-un folder suplimentar de proiect.
- Schimbați extensia arhivei de
.zipla la .plugin.
- Deschideți editorii desktop ONLYOFFICE, selectați fila Pluginuri și faceți clic pe Manager pluginuri .
- Deschideți Pluginurile mele , alegeți Instalare plugin manuală , selectați
.pluginfișierul și confirmați.
Pluginul ar trebui să apară apoi în fila Pluginuri din editorul deschis și în editoare deschise ulterior. Ruta de arhivare manuală funcționează fără o conexiune la internet. Instalarea Marketplace este destinată pluginurilor gata de utilizare; nu înlocuiește încărcarea propriei versiuni de dezvoltare.
Folosește o legătură simbolică pentru o iterație mai rapidă
După prima instalare, Desktop Editors stochează o copie într-un sdkjs-pluginsdirector. Înlocuiți acea copie cu un link simbolic către folderul sursă, astfel încât să puteți edita direct fișierele de lucru. Închideți Desktop Editors înainte de a modifica folderul pluginului de testare instalat. Păstrați o copie de rezervă sau asigurați-vă că folderul sursă este intact și eliminați doar folderul care corespunde GUID-ului pluginului de testare.
| Sistem de operare | Directorul pluginului utilizatorului |
| Ferestre | %LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\ |
| macOS | ~/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/ |
| Linux | ~/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/ |
În interiorul directorului, numele linkului este GUID-ul între acolade, fără asc.prefix. De exemplu, dacă GUID-ul de configurare este asc.{91EAC419-EF8B-440C-A960-B451C7DF3A37}, numele folderului sau al linkului este {91EAC419-EF8B-440C-A960-B451C7DF3A37}.
Ferestre
Deschideți Linia de comandă ca administrator dacă acest lucru este necesar în contul sau politica dvs. Windows. După închiderea editorilor și mutarea folderului test-plugin instalat, creați linkul directorului:
mklink /D "%LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\{YOUR-GUID}" "C:\path\to\your\plugin"
Înlocuiți ambele titluri substituibile cu GUID-ul și calea completă către directorul sursă. Ținta linkului nu trebuie să existe deja.
macOS
ln -s "/path/to/your/plugin" "$HOME/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/{YOUR-GUID}"
Linux
ln -s "/path/to/your/plugin" "$HOME/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/{YOUR-GUID}"
Folosește căile pentru ediția instalată; versiunile package sau sandbox pot stoca datele utilizatorului în altă parte. După editarea sursei, redeschide documentul sau reîncarcă pluginul, după caz. Legătura simbolică evită reconstruirea arhivei, dar modificările nu sunt neapărat preluate până când editorul nu reîncarcă pluginul.
Lansați editorii desktop cu instrumentele pentru dezvoltatori
Pentru a depana un plugin, închideți complet Desktop Editors și porniți-l cu --ascdesktop-support-debug-info. Folosiți comanda pentru sistemul dvs. de operare; dacă ați instalat aplicația într-o locație personalizată, ajustați calea executabilă.
Ferestre
Executați asta în Linia de comandă:
"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-info
Alternativ, editați câmpul Țintă al unei comenzi rapide adăugând un spațiu și steagul după calea executabilă. Acest lucru afectează lansările prin comanda rapidă respectivă.
Linux
"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info
macOS
"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-info
După ce aplicația rulează, faceți clic în interiorul unui document și apăsați F1, sau faceți clic dreapta pe un câmp editabil din bara de instrumente și alegeți Inspectare element . În instrumentele pentru dezvoltatori, selectați iframe-ul pluginului pentru a-i inspecta propriul JavaScript și jurnalele. Codul transmis către callCommandse execută în cadrul editorului, numit frameEditor, așadar erorile și punctele de întrerupere pot apărea într-un context diferit față de codul interfeței utilizator a pluginului.
Indicatorul opțional --ascdesktop-support-debug-info-keep=1menține modul de depanare activat la lansări. Pentru a dezactiva starea persistentă, lansați cu --ascdesktop-support-debug-info-keep=0; utilizați --ascdesktop-support-debug-info-keep=defaultpentru a reveni la starea implicită. Instrumentele persistente pentru dezvoltatori sunt convenabile pe o mașină de testare dedicată, dar lăsarea lor activată pe o stație de lucru partajată adaugă dezordine și menține instrumentele de inspecție disponibile atunci când nu aveți nevoie de ele.
Verificați dacă configurația de dezvoltare funcționează
- Pluginul apare cu numele configurat în fila Pluginuri.
- După o modificare a sursei, redeschiderea documentului sau reîncărcarea pluginului afișează comportamentul actualizat.
- Instrumentele pentru dezvoltatori se deschid cu
F1sau prin Inspect Element după lansarea cu semnalizatorul de depanare.
- Jurnalele din codul interfeței utilizator a pluginului apar atunci când este selectat iframe-ul pluginului; comenzile documentului sunt inspectate în
frameEditor.
Dacă pluginul lipsește, verificați dacă config.jsonși index.htmlse află la rădăcina arhivei, GUID-ul este valid și folderul folosește GUID-ul fără asc.prefix. Confirmați că linkul indică directorul sursă și nu un director părinte care îl conține. Dacă pluginul apare, dar se comportă ca o versiune mai veche, închideți și redeschideți documentul, astfel încât editorul să reîncarce fișierele legate.
Ceea ce această configurație nu permite
Indicatorul de depanare desktop nu este un comutator global de permisiuni pentru dezvoltarea de pluginuri. Instalarea unei arhive sau plasarea unui folder în directorul pluginurilor acceptate face ca pluginul respectiv să fie disponibil; indicatorul de depanare expune instrumentele de inspecție. De asemenea, instrucțiunile pentru încărcarea unui plugin prin URL într-un editor web nu se aplică automat editorilor desktop. Utilizați fluxul de lucru de instalare și depanare specific desktopului de mai sus.
Aceste instrucțiuni se referă la pluginurile pentru editorii desktop ONLYOFFICE. Nu explică cum se activează pluginurile în DocSpace, cum se configurează pluginurile pe server în ONLYOFFICE Docs sau cum se publică un plugin pe Marketplace. Pentru aceste fluxuri de lucru, utilizați documentația oficială corespunzătoare a produsului.
Referințe oficiale