เรามีความยินดีที่จะแจ้งการปล่อย GroupDocs.Viewer for Python 26.9 ซึ่งพร้อมให้ใช้งานตั้งแต่ กันยายน 2026 รุ่นนี้อัปเกรดเอนจิน GroupDocs.Viewer พื้นฐานจาก 26.4 ไปเป็น 26.8, เพิ่มการสนับสนุนการเรนเดอร์ไฟล์ Microsoft Project บน Linux และ macOS, แนะนำการจัดการหมายเลขหน้าและความละเอียดสำหรับเอกสาร Word, ลบการพึ่งพา libgdiplus บนแพลตฟอร์มที่ไม่ใช่ Windows, และคืนความเข้ากันได้กับ Python 3.5–3.7 .NET runtime ที่ฝังอยู่ได้รับการอัปเดตเป็น 10.0.12 และ API ของ Python ตอนนี้รวม docstrings เต็มรูปแบบพร้อมตัวอย่างโค้ดแล้ว

สิ่งใหม่ในรุ่นนี้

  • [Feature] เพิ่ม WordProcessingOptions.page_number_location และ enum WordsPageNumberLocation เพื่อใส่หมายเลขหน้าในเอกสาร Word ที่เรนเดอร์ (VIEWERPYTHON-153)
  • [Feature] เพิ่ม WordProcessingOptions.horizontal_resolution / vertical_resolution เพื่อกำหนด DPI ของผลลัพธ์ PNG และ JPEG สำหรับเอกสาร Word (VIEWERPYTHON-154)
  • [Feature] เพิ่มการสนับสนุนการเรนเดอร์ไฟล์ Microsoft Project (MPP, MPT, MPX) บน Linux และ macOS (VIEWERPYTHON-155)
  • [Enhancement] อัปเดตเอนจิน GroupDocs.Viewer จาก 26.4 ไปเป็น 26.8 (VIEWERPYTHON-156)
  • [Enhancement] อัปเดต .NET runtime ที่ฝังอยู่จาก 10.0.0 ไปเป็น 10.0.12 (VIEWERPYTHON-157)
  • [Enhancement] ลบความต้องการ libgdiplus / mono-libgdiplus บน Linux และ macOS (VIEWERPYTHON-158)
  • [Enhancement] ทำให้ API Python เหมือนกันบนทุกแพลตฟอร์ม — แพ็กเกจ Linux และ macOS เพิ่ม ProjectManagementOptions และสมาชิก FileType ของ Project, Photoshop, Illustrator และ OneNote (VIEWERPYTHON-159)
  • [Enhancement] เพิ่ม docstrings พร้อมสรุป, พารามิเตอร์และตัวอย่างโค้ดใน API ของ Python (VIEWERPYTHON-160)
  • [Enhancement] เพิ่มส่วน “Developer Guide” ในเอกสารอ้างอิง API (VIEWERPYTHON-161)
  • [Fix] ไม่สามารถใช้แพ็กเกจบน Python 3.5 – 3.7 ได้ (VIEWERPYTHON-162)
  • [Fix] pip ติดตั้งแพ็กเกจบน Linux และ macOS เวอร์ชันที่ไม่สามารถรันได้ (VIEWERPYTHON-163)

การเปลี่ยนแปลง API สาธารณะ

ไม่มีอะไรถูกลบหรือเปลี่ยนชื่อ

ประเภทใหม่

ประเภท โมดูล คำอธิบาย
WordsPageNumberLocation groupdocs.viewer.options ตำแหน่งที่ใส่หมายเลขหน้าในเอกสาร Word ที่เรนเดอร์: NOT_APPLY (ค่าเริ่มต้น), TOP_LEFT, TOP_CENTER, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT

สมาชิกใหม่ในคลาสที่มีอยู่

คลาส สมาชิก คำอธิบาย
WordProcessingOptions page_number_location การใส่หมายเลขหน้าในขณะเรนเดอร์ (WordsPageNumberLocation)
WordProcessingOptions horizontal_resolution DPI แนวนอนของผลลัพธ์ PNG / JPEG, 72 – 600 (ค่าเริ่มต้น 96)
WordProcessingOptions vertical_resolution DPI แนวตั้งของผลลัพธ์ PNG / JPEG, 72 – 600 (ค่าเริ่มต้น 96)

ใหม่บน Linux และ macOS

ProjectManagementOptions, BaseViewOptions.project_management_options และ FileType.MPP, MPT, MPX, PSD, PSB, AI, ONE มีให้ใช้งานบน Windows แล้วและตอนนี้ก็พร้อมในแพ็กเกจ Linux และ macOS ด้วย — ดู API Python ตัวเดียวบนทุกแพลตฟอร์ม

ฟีเจอร์ใหม่

ไฟล์ Microsoft Project บน Linux และ macOS

ไฟล์ MPP, MPT และ MPX ก่อนหน้านี้สามารถเรนเดอร์ได้เฉพาะบน Windows; บน Linux และ macOS จะเกิดข้อผิดพลาด Failed to detect file type เอนจิน 26.8 สามารถเรนเดอร์ไฟล์เหล่านี้บนทุกแพลตฟอร์มโดยใช้ ProjectManagementOptions เหมือนบน Windows:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, TimeUnit

with Viewer("project.mpp") as viewer:
    options = HtmlViewOptions.for_embedded_resources("page_{0}.html")
    options.project_management_options.time_unit = TimeUnit.DAYS
    viewer.view(options)

บน Linux ให้ติดตั้ง Microsoft core fonts (ttf-mscorefonts-installer) ก่อน: หากไม่มีฟอนต์เหล่านี้ การเรนเดอร์ Project จะล้มเหลวด้วยข้อความ Cannot find fallback font 'Generic Sans Serif' และฟอนต์ทดแทนที่เข้ากันเช่น Liberation จะไม่ทำงาน

หมายเลขหน้าในเอกสาร Word ที่เรนเดอร์

WordProcessingOptions.page_number_location จะใส่หมายเลขหน้าในเอกสาร Word ขณะเรนเดอร์ แม้ว่าเอกสารต้นฉบับจะไม่มีหมายเลขหน้า เลือกตำแหน่งจาก enum WordsPageNumberLocation ทั้งหกตำแหน่ง; ค่าเริ่มต้น NOT_APPLY จะไม่ทำการเปลี่ยนแปลงใด ๆ

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, WordsPageNumberLocation

with Viewer("document.docx") as viewer:
    options = PdfViewOptions("output.pdf")
    options.word_processing_options.page_number_location = WordsPageNumberLocation.BOTTOM_CENTER
    viewer.view(options)

ความละเอียดของผลลัพธ์ PNG และ JPEG สำหรับเอกสาร Word

WordProcessingOptions.horizontal_resolution และ vertical_resolution กำหนด DPI ของภาพที่เรนเดอร์จากเอกสาร Word ค่าเริ่มต้นคือ 96 DPI; ค่าที่อยู่นอกช่วง 72 – 600 DPI จะถูกจำกัดให้อยู่ในช่วงนั้น

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

with Viewer("document.docx") as viewer:
    options = PngViewOptions("page_{0}.png")
    options.word_processing_options.horizontal_resolution = 300
    options.word_processing_options.vertical_resolution = 300
    viewer.view(options)

ไม่ต้องใช้ libgdiplus อีกต่อไป

แพ็กเกจ Linux และ macOS เรนเดอร์ผ่าน SkiaSharp และ Aspose.Drawing ซึ่งถูกรวมอยู่ใน wheel แล้ว พวกมันไม่เรียก libgdiplus แต่อย่างใด: ตัวอย่างที่ระบุในเอกสารทั้งหมดทำงานในคอนเทนเนอร์ Linux ที่ไม่มี libgdiplus หรือไลบรารีกราฟิกที่เกี่ยวข้อง จึงสามารถลบ libgdiplus / mono-libgdiplus ออกจากอิมเมจและสคริปต์ provisioning ของคุณได้

API Python ตัวเดียวบนทุกแพลตฟอร์ม

ก่อนหน้านี้แพ็กเกจ Linux และ macOS มี API ย่อยกว่าบน Windows รุ่น 26.9 ทำให้ API เหมือนกันทุกที่ โค้ดที่เขียนตามเอกสารจะทำงานบนทุกแพลตฟอร์ม แพ็กเกจ Linux และ macOS เพิ่ม ProjectManagementOptions และสมาชิก FileType.MPP, MPT, MPX ซึ่งตอนนี้ทำงานได้เช่นกัน

พวกมันยังเพิ่ม FileType.PSD, PSB, AI และ ONE อีกด้วย ฟอร์แมตเหล่านี้ยังคงเป็น Windows‑only และบน Linux/macOS การเข้าถึงสมาชิกเหล่านี้จะทำให้เกิดข้อผิดพลาด GroupDocsViewerException: Member 'GroupDocs.Viewer.FileType.PSD' not found. หากต้องการตรวจสอบว่าฟอร์แมตใดสามารถเรนเดอร์ได้ในขณะรันไทม์ ให้เรียก FileType.get_supported_file_types() ซึ่งจะคืนรายการฟอร์แมตที่เอนจินกำลังสนับสนุน:

from groupdocs.viewer import FileType

supported = {file_type.extension for file_type in FileType.get_supported_file_types()}
print(".psd" in supported)   # True บน Windows, False บน Linux และ macOS
print(".mpp" in supported)   # True ทุกที่

ตัวอย่างโค้ด

การเรนเดอร์ไฟล์ Microsoft Project บน Linux หรือ macOS ด้วยหน่วยเวลาเป็นวัน:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, TimeUnit

with Viewer("project.mpp") as viewer:
    options = HtmlViewOptions.for_embedded_resources("page_{0}.html")
    options.project_management_options.time_unit = TimeUnit.DAYS
    viewer.view(options)

การใส่หมายเลขหน้าในเอกสาร Word และเรนเดอร์เป็น PDF:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, WordsPageNumberLocation

with Viewer("document.docx") as viewer:
    options = PdfViewOptions("output.pdf")
    options.word_processing_options.page_number_location = WordsPageNumberLocation.BOTTOM_CENTER
    viewer.view(options)

วิธีรับการอัปเดต

PyPI

อัปเกรดเป็นแพ็กเกจล่าสุดผ่าน PyPI:

pip install groupdocs-viewer-net==26.9.0

ดาวน์โหลดโดยตรง

ดาวน์โหลดไฟล์ wheel สำหรับทุกแพลตฟอร์มจากหน้า GroupDocs.Viewer for Python via .NET 26.9

แหล่งข้อมูล