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.
| 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.
Î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.
.zipla la .plugin..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.
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}.
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.
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}"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.
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ă.
Executați asta în Linia de comandă:
"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-infoAlternativ, 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ă.
"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-infoDupă 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.
F1sau prin Inspect Element după lansarea cu semnalizatorul de depanare.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.
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.
Aflați cum să trageți o imagine în Word, să alegeți încadrarea textului, să o păstrați într-un paragraf sau să o remediați pe pagină și să depanați imaginile care nu se mișcă.
Aflați cum să inserați o casetă de selectare în Excel cu instrumentul în celulă, să numărați elementele bifate cu formule sau să adăugați un control formular legat în versiunile desktop mai vechi.
Generați litere mici de la A la Z sau etichete după Z în Excel cu o formulă de umplere cu ghidaj, o secvență sau o listă personalizată reutilizabilă.
Aflați cum să tăiați cu o linie în Excel pe Windows, Mac și web, să formatați o parte a unei celule și să eliminați linia fără a șterge valoarea acesteia.
Aflați cum să importați un fișier PST în Outlook 2010 sau să exportați e-mailuri, contacte, calendar și activități. Urmați meniurile corecte și evitați folderele lipsă sau duplicatele.
Aflați cum să ajustați înălțimea și lățimea grilei în Word 2010, să modificați frecvența liniilor vizibile și să setați spațierea orizontală și verticală subiacentă a grilei de desen.
Recuperează o parolă Outlook PST uitată cu pașii actuali ai Kernel, inclusiv cum să identifici fișierul corect, să faci o copie de rezervă și să verifici limitele instrumentului.
Utilizați programul de completare LiveWeb pentru a plasa un site web pe un diapozitiv PowerPoint, a seta dimensiunea și comportamentul de reîmprospătare și a verifica compatibilitatea înainte de prezentare.
Adăugați sărbători specifice fiecărei țări în noul Outlook, Outlook pe web sau Outlook clasic. Aflați cum să evitați evenimentele duplicate și să verificați dacă lipsesc datele din perioada 2026-2027.
Exportați un tabel Access 2010 în Excel 2010, alegeți dacă doriți să includeți formatarea, salvați pașii de export reutilizabili și verificați problemele comune legate de transferul de date.
