วิธีเปิดใช้งานการพัฒนาปลั๊กอินใน ONLYOFFICE Desktop Editors

โปรแกรม ONLYOFFICE Desktop Editors ไม่ได้ระบุตัวเลือก “เปิดใช้งานการพัฒนาปลั๊กอิน” ไว้ในเอกสาร ขั้นตอนการทำงานที่รองรับคือการติดตั้งปลั๊กอินของคุณเองผ่าน Plugin Manager วางไว้ในโฟลเดอร์ปลั๊กอินในเครื่อง และอาจแทนที่สำเนาที่ติดตั้งด้วยลิงก์สัญลักษณ์ไปยังโฟลเดอร์ซอร์สโค้ดของคุณ ในการตรวจสอบข้อผิดพลาดและใช้เบรกพอยต์ ให้เปิดแอปพลิเคชันเดสก์ท็อปโดยใช้แฟล็กการดีบักตามที่ระบุไว้ ขั้นตอนเหล่านี้แยกจากกัน: โหมดดีบักจะแสดงเครื่องมือสำหรับนักพัฒนา ในขณะที่การติดตั้งหรือการเชื่อมโยงปลั๊กอินจะทำให้ปลั๊กอินพร้อมใช้งานในโปรแกรมแก้ไข

เอกสาร API ของ ONLYOFFICE ฉบับปัจจุบันอธิบายขั้นตอนการทำงานบนเดสก์ท็อปแบบเดียวกันนี้ และยังระบุถึงแฟล็กสำหรับการเปิดใช้งานโหมดดีบักไว้ตลอดการเปิดใช้งานด้วย ฉันไม่พบประกาศอย่างเป็นทางการเกี่ยวกับการสลับโหมดการพัฒนาใหม่ที่เปลี่ยนแปลงขั้นตอนเหล่านี้ คู่มือนี้ปฏิบัติตามคำแนะนำอย่างเป็นทางการที่มีอยู่ ณ วันที่ 6 ตุลาคม 2026 เส้นทางอาจแตกต่างกันไปตามประเภทการติดตั้ง ดังนั้นโปรดตรวจสอบเส้นทางสำหรับแพลตฟอร์มของคุณก่อนทำการเปลี่ยนแปลงไฟล์

เลือกเวิร์กโฟลว์การพัฒนาปลั๊กอิน

สำหรับนักพัฒนาส่วนใหญ่ ให้ใช้ไฟล์เก็บถาวรเพียงครั้งเดียวเพื่อลงทะเบียนปลั๊กอิน จากนั้นใช้ลิงก์สัญลักษณ์สำหรับการพัฒนาต่อยอด เพิ่มแฟล็กการดีบักเฉพาะเมื่อต้องการวิเคราะห์โค้ดเท่านั้น ปิดใช้งานตัวเลือกแบบถาวรเว้นแต่คุณต้องการเครื่องมือสำหรับนักพัฒนาทุกครั้งที่เปิดใช้งาน

เตรียมไฟล์ปลั๊กอิน

เริ่มต้นด้วยการสร้างไดเร็กทอรีปลั๊กอินในเครื่องที่มีไฟล์ที่จำเป็นสำหรับปลั๊กอินของคุณอย่างน้อยที่สุด รวมถึงไฟล์ `.py` config.jsonและindex.html`.py` ไฟล์การกำหนดค่าต้องมี GUID ของปลั๊กอินที่ถูกต้องและชี้ไปยังหน้าเริ่มต้นและไฟล์สินทรัพย์ของปลั๊กอินโดยใช้สคีมาปลั๊กอิน ONLYOFFICE ใช้ปลั๊กอินตัวอย่างอย่างเป็นทางการหรือเอกสาร API สำหรับสคีมาที่สมบูรณ์ GUID ที่ผิดรูปแบบ เส้นทางที่เสียหาย หรือการกำหนดค่าที่ไม่ถูกต้องอาจทำให้ปลั๊กอินไม่ปรากฏขึ้น

โดยปกติ GUID จะconfig.jsonมีรูปแบบasc.{YOUR-GUID}. Desktop Editors จะใช้ GUID เป็นชื่อโฟลเดอร์ปลั๊กอิน แต่ละเว้นasc.คำนำหน้า ควรใช้ GUID เดียวกันในไดเร็กทอรีต้นทาง ไฟล์เก็บถาวร และเส้นทางการติดตั้ง ห้ามใช้ GUID ซ้ำกับปลั๊กอินในตัวหรือปลั๊กอินอื่นที่ติดตั้งไว้แล้ว

ติดตั้งปลั๊กอินเป็นครั้งแรก

1. นำไฟล์และโฟลเดอร์ย่อยของปลั๊กอินใส่ลงในไฟล์ ZIP โดยไฟล์เหล่านั้นต้องอยู่ในไดเร็กทอรีหลักของไฟล์ ZIP ไม่ใช่ในโฟลเดอร์โปรเจ็กต์แยกต่างหาก
2. เปลี่ยนนามสกุลไฟล์เก็บถาวรจาก.zipเป็น.plugin.
3. เปิดโปรแกรม ONLYOFFICE Desktop Editors เลือก แท็บ Pluginsแล้วคลิกPlugin Manager
4. เปิด"ปลั๊กอินของฉัน " เลือก " ติดตั้งปลั๊กอินด้วยตนเอง"เลือก.pluginไฟล์ แล้วยืนยัน

จากนั้นปลั๊กอินจะปรากฏในแท็บปลั๊กอินในโปรแกรมแก้ไขที่เปิดอยู่ และในโปรแกรมแก้ไขที่เปิดในภายหลัง วิธีการสร้างไฟล์เก็บถาวรแบบแมนนวลใช้งานได้โดยไม่ต้องเชื่อมต่ออินเทอร์เน็ต การติดตั้งจาก Marketplace มีไว้สำหรับปลั๊กอินที่พร้อมใช้งานเท่านั้น ไม่ใช่สิ่งทดแทนการโหลดเวอร์ชันสำหรับการพัฒนาของคุณเอง

ใช้ลิงก์เชิงสัญลักษณ์เพื่อการวนซ้ำที่รวดเร็วยิ่งขึ้น

หลังจากการติดตั้งครั้งแรก Desktop Editors จะจัดเก็บสำเนาไว้ในsdkjs-pluginsไดเร็กทอรีหนึ่ง ให้แทนที่สำเนานั้นด้วยลิงก์สัญลักษณ์ไปยังโฟลเดอร์ต้นฉบับของคุณ เพื่อให้คุณสามารถแก้ไขไฟล์งานได้โดยตรง ปิด Desktop Editors ก่อนที่จะเปลี่ยนแปลงโฟลเดอร์ปลั๊กอินทดสอบที่ติดตั้งไว้ เก็บสำรองข้อมูลหรือตรวจสอบให้แน่ใจว่าโฟลเดอร์ต้นฉบับของคุณยังคงอยู่ และลบเฉพาะโฟลเดอร์ที่ตรงกับ GUID ของปลั๊กอินทดสอบของคุณเท่านั้น

ภายในไดเร็กทอรี ชื่อลิงก์จะเป็น GUID ที่อยู่ในวงเล็บปีกกาโดยไม่มีasc.คำนำหน้า ตัวอย่างเช่น หาก GUID ของการกำหนดค่าคือasc.{91EAC419-EF8B-440C-A960-B451C7DF3A37}ชื่อโฟลเดอร์หรือลิงก์จะ{91EAC419-EF8B-440C-A960-B451C7DF3A37}เป็น

วินโดวส์

เปิด Command Prompt ในฐานะผู้ดูแลระบบ หากบัญชี Windows หรือนโยบายของคุณกำหนดไว้ หลังจากปิดโปรแกรมแก้ไขและย้ายโฟลเดอร์ปลั๊กอินทดสอบที่ติดตั้งออกไปแล้ว ให้สร้างลิงก์ไดเร็กทอรี:

mklink /D "%LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\{YOUR-GUID}" "C:\path\to\your\plugin"

แทนที่ตัวยึดตำแหน่งทั้งสองด้วย GUID และเส้นทางแบบเต็มไปยังไดเร็กทอรีต้นทางของคุณ เป้าหมายการเชื่อมโยงต้องไม่มีอยู่แล้ว

ระบบปฏิบัติการ macOS

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}"

ใช้เส้นทางสำหรับเวอร์ชันที่คุณติดตั้งไว้ การสร้างแบบแพ็กเกจหรือแบบแซนด์บ็อกซ์อาจจัดเก็บข้อมูลผู้ใช้ไว้ที่อื่น หลังจากแก้ไขซอร์สโค้ดแล้ว ให้เปิดเอกสารใหม่หรือโหลดปลั๊กอินใหม่ตามความเหมาะสม ลิงก์สัญลักษณ์จะช่วยหลีกเลี่ยงการสร้างไฟล์เก็บถาวรใหม่ แต่การเปลี่ยนแปลงอาจไม่ได้รับการนำไปใช้จนกว่าตัวแก้ไขจะโหลดปลั๊กอินใหม่

เปิดใช้งานโปรแกรมแก้ไขบนเดสก์ท็อปด้วยเครื่องมือสำหรับนักพัฒนา

ในการดีบักปลั๊กอิน ให้ปิดโปรแกรม Desktop Editors อย่างสมบูรณ์ แล้วเริ่มโปรแกรมใหม่โดย ใช้คำสั่ง `docker start` --ascdesktop-support-debug-infoใช้คำสั่งที่เหมาะสมกับระบบปฏิบัติการของคุณ หากคุณติดตั้งแอปในตำแหน่งที่กำหนดเอง ให้ปรับเส้นทางของไฟล์ปฏิบัติการด้วย

วินโดวส์

เรียกใช้คำสั่งนี้ใน Command Prompt:

"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-info

อีกวิธีหนึ่งคือ แก้ไขช่องเป้าหมาย (Target) ของทางลัดโดยเพิ่มช่องว่างและเครื่องหมายกำกับไว้หลังเส้นทางของไฟล์ปฏิบัติการ วิธีนี้จะใช้ได้ผลกับการเปิดใช้งานผ่านทางลัดนั้น

ลินุกซ์

"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info

ระบบปฏิบัติการ macOS

"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-info

เมื่อแอปทำงานแล้ว ให้คลิกภายในเอกสารแล้วกด Enter F1หรือคลิกขวาที่ช่องแถบเครื่องมือที่แก้ไขได้ แล้วเลือกInspect Elementในเครื่องมือสำหรับนักพัฒนา ให้เลือก iframe ของปลั๊กอินเพื่อตรวจสอบ JavaScript และบันทึกของปลั๊กอินเอง โค้ดที่ส่งไปยัง Inspect Element จะcallCommandทำงานในเฟรมตัวแก้ไขที่มีชื่อว่า `<insert_frame>` frameEditorดังนั้นข้อผิดพลาดและจุดหยุดอาจปรากฏในบริบทที่แตกต่างจากโค้ด UI ของปลั๊กอิน

ตัวเลือกเสริมนี้--ascdesktop-support-debug-info-keep=1จะเปิดใช้งานโหมดดีบักไว้ตลอดการเรียกใช้โปรแกรม หากต้องการปิดสถานะถาวร ให้เรียกใช้โปรแกรมด้วย--ascdesktop-support-debug-info-keep=0; ใช้--ascdesktop-support-debug-info-keep=defaultเพื่อกลับสู่สถานะเริ่มต้น เครื่องมือสำหรับนักพัฒนาแบบถาวรนั้นสะดวกบนเครื่องทดสอบเฉพาะ แต่การเปิดใช้งานไว้บนเวิร์กสเตชันที่ใช้ร่วมกันจะทำให้เกิดความยุ่งยากและทำให้เครื่องมือตรวจสอบพร้อมใช้งานเมื่อคุณไม่ต้องการใช้งาน

ตรวจสอบว่าการตั้งค่าการพัฒนาใช้งานได้หรือไม่

• ปลั๊กอินจะปรากฏในแท็บปลั๊กอินโดยใช้ชื่อที่ตั้งค่าไว้
• หลังจากแก้ไขโค้ดแล้ว การเปิดเอกสารใหม่หรือการโหลดปลั๊กอินใหม่จะแสดงพฤติกรรมที่อัปเดตแล้ว
• เครื่องมือสำหรับนักพัฒนาจะเปิดขึ้นพร้อมกับF1หรือผ่านทางInspect Elementหลังจากเรียกใช้โปรแกรมด้วยแฟล็กดีบัก
• บันทึกจากโค้ด UI ของปลั๊กอินจะปรากฏขึ้นเมื่อเลือก iframe ของปลั๊กอิน คำสั่งเอกสารจะถูกตรวจสอบในframeEditor.

หากปลั๊กอินหายไป ให้ตรวจสอบว่าconfig.jsonคุณindex.htmlอยู่ที่ไดเร็กทอรีรากของไฟล์เก็บถาวร GUID ถูกต้อง และโฟลเดอร์ใช้ GUID โดยไม่มีasc.คำนำหน้า ยืนยันว่าลิงก์ชี้ไปยังไดเร็กทอรีต้นทาง ไม่ใช่ไดเร็กทอรีแม่ที่บรรจุปลั๊กอินนั้นอยู่ หากปลั๊กอินปรากฏขึ้น แต่ทำงานเหมือนเวอร์ชันเก่า ให้ปิดและเปิดเอกสารใหม่เพื่อให้โปรแกรมแก้ไขโหลดไฟล์ที่เชื่อมโยงใหม่

สิ่งที่การตั้งค่านี้ไม่สามารถทำได้

ตัวเลือกการดีบักบนเดสก์ท็อปไม่ใช่สวิตช์อนุญาตทั่วไปสำหรับการพัฒนาปลั๊กอิน การติดตั้งไฟล์เก็บถาวรหรือการวางโฟลเดอร์ในไดเร็กทอรีปลั๊กอินที่รองรับจะทำให้ปลั๊กอินนั้นพร้อมใช้งาน ตัวเลือกการดีบักจะแสดงเครื่องมือตรวจสอบ ในทำนองเดียวกัน คำแนะนำสำหรับการโหลดปลั๊กอินโดยใช้ URL ลงในโปรแกรมแก้ไขเว็บจะไม่สามารถนำไปใช้กับโปรแกรมแก้ไขบนเดสก์ท็อปได้โดยอัตโนมัติ โปรดใช้ขั้นตอนการติดตั้งและการดีบักเฉพาะสำหรับเดสก์ท็อปที่กล่าวไว้ข้างต้น

คำแนะนำเหล่านี้เกี่ยวข้องกับปลั๊กอินสำหรับ ONLYOFFICE Desktop Editors ไม่ได้อธิบายวิธีการเปิดใช้งานปลั๊กอินใน DocSpace วิธีการกำหนดค่าปลั๊กอินฝั่งเซิร์ฟเวอร์ใน ONLYOFFICE Docs หรือวิธีการเผยแพร่ปลั๊กอินไปยัง Marketplace สำหรับขั้นตอนเหล่านั้น โปรดใช้เอกสารผลิตภัณฑ์อย่างเป็นทางการที่เกี่ยวข้อง

เอกสารอ้างอิงอย่างเป็นทางการ

• ONLYOFFICE: การพัฒนาปลั๊กอิน
• ONLYOFFICE: พัฒนาปลั๊กอินสำหรับโปรแกรมแก้ไขเอกสารบนเดสก์ท็อป
• ONLYOFFICE: การติดตั้งและทดสอบปลั๊กอินในโปรแกรมแก้ไขบนเดสก์ท็อป
• ONLYOFFICE: การเรียกใช้โปรแกรมแก้ไขบนเดสก์ท็อปในโหมดดีบัก
• ONLYOFFICE: การดีบักปลั๊กอินในโปรแกรมแก้ไขบนเดสก์ท็อป
• ONLYOFFICE: ตัวอย่างปลั๊กอินอย่างเป็นทางการและคลังเก็บซอร์สโค้ด