우리는 GroupDocs.Viewer for Python 26.9의 릴리스를 발표하게 되어 기쁩니다. 이 릴리스는 2026년 9월부터 사용할 수 있습니다. 이번 릴리스에서는 기본 GroupDocs.Viewer 엔진을 26.4에서 26.8로 업그레이드하고, Linux 및 macOS에서 Microsoft Project 파일 렌더링을 지원하며, Word 문서에 페이지 번호와 해상도 제어 기능을 도입하고, 비 Windows 플랫폼에서 libgdiplus 의존성을 제거했으며, Python 3.5–3.7과의 호환성을 복원했습니다. 내장된 .NET 런타임은 10.0.12로 업데이트되었으며, Python API에는 코드 예제가 포함된 완전한 docstring이 추가되었습니다.

이번 릴리스의 새로운 기능

  • [Feature] 렌더링된 Word 문서에 페이지 번호를 찍기 위해 WordProcessingOptions.page_number_location 및 WordsPageNumberLocation 열거형을 추가 (VIEWERPYTHON-153)
  • [Feature] Word 문서의 PNG 및 JPEG 출력 DPI를 설정하기 위해 WordProcessingOptions.horizontal_resolution / vertical_resolution 를 추가 (VIEWERPYTHON-154)
  • [Feature] Linux 및 macOS에서 Microsoft Project 파일(MPP, MPT, MPX) 렌더링 지원 추가 (VIEWERPYTHON-155)
  • [Enhancement] GroupDocs.Viewer 엔진을 26.4에서 26.8로 업데이트 (VIEWERPYTHON-156)
  • [Enhancement] 내장 .NET 런타임을 10.0.0에서 10.0.12로 업데이트 (VIEWERPYTHON-157)
  • [Enhancement] Linux 및 macOS에서 libgdiplus / mono-libgdiplus 요구 사항 제거 (VIEWERPYTHON-158)
  • [Enhancement] 모든 플랫폼에서 동일한 Python API 제공 — Linux 및 macOS 패키지에 ProjectManagementOptions와 Project, Photoshop, Illustrator, OneNote FileType 멤버 추가 (VIEWERPYTHON-159)
  • [Enhancement] Python API에 요약, 매개변수 및 코드 예제가 포함된 docstring 추가 (VIEWERPYTHON-160)
  • [Enhancement] API 레퍼런스에 개발자 가이드 섹션 추가 (VIEWERPYTHON-161)
  • [Fix] Python 3.5 – 3.7에서 패키지를 사용할 수 없음 (VIEWERPYTHON-162)
  • [Fix] Linux 및 macOS 버전에서 pip가 실행할 수 없는 패키지를 설치함 (VIEWERPYTHON-163)

공개 API 변경 사항

제거되거나 이름이 바뀐 항목은 없습니다.

새 유형

Type Module Description
WordsPageNumberLocation groupdocs.viewer.options 렌더링된 Word 문서에 페이지 번호를 찍는 위치: NOT_APPLY(기본값), TOP_LEFT, TOP_CENTER, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT

기존 클래스의 새 멤버

Class Member Description
WordProcessingOptions page_number_location 렌더링 중 적용할 페이지 번호(WordsPageNumberLocation)
WordProcessingOptions horizontal_resolution PNG / JPEG 출력의 가로 DPI, 72 – 600 (기본값 96)
WordProcessingOptions vertical_resolution PNG / JPEG 출력의 세로 DPI, 72 – 600 (기본값 96)

Linux 및 macOS에서의 새로운 기능

ProjectManagementOptions, BaseViewOptions.project_management_options 및 FileType.MPP, MPT, MPX, PSD, PSB, AI, ONE 은 기존에 Windows에서만 제공되었으며 이제 Linux 및 macOS 패키지에서도 사용할 수 있습니다 — 모든 플랫폼에서 동일한 Python API를 참고하십시오.

새 기능

Linux 및 macOS에서 Microsoft Project 파일

MPP, MPT, MPX 파일은 이전에 Windows에서만 렌더링되었으며, Linux 및 macOS에서는 Failed to detect file type 오류가 발생했습니다. 26.8 엔진은 모든 플랫폼에서 동일한 ProjectManagementOptions를 사용해 파일을 렌더링합니다:

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)를 설치해야 합니다. 폰트를 설치하지 않으면 Cannot find fallback font 'Generic Sans Serif' 오류가 발생하고, Liberation과 같은 메트릭 호환 대체 폰트는 해당 조회를 만족하지 못합니다.

렌더링된 Word 문서의 페이지 번호

WordProcessingOptions.page_number_location 은 문서에 페이지 번호가 없더라도 렌더링 시 페이지 번호를 찍습니다. 새 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)

Word 문서의 PNG 및 JPEG 출력 해상도

WordProcessingOptions.horizontal_resolution 와 vertical_resolution 은 Word 문서에서 렌더링된 이미지의 DPI를 설정합니다. 기본값은 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 를 호출하지 않으며, 모든 문서 예제는 libgdiplus 나 그 그래픽 종속성이 없는 Linux 컨테이너에서도 정상적으로 동작합니다. 이미지와 프로비저닝 스크립트에서 libgdiplus / mono-libgdiplus 를 제거하십시오.

모든 플랫폼에서 동일한 Python API

이전 Linux 및 macOS 패키지는 Windows 패키지보다 작은 API를 제공했습니다. 26.9 버전은 모든 플랫폼에서 동일한 API를 제공하므로, 문서에 따라 작성된 코드를 모든 환경에서 그대로 사용할 수 있습니다. Linux 및 macOS 패키지는 이제 ProjectManagementOptions와 FileType.MPP, MPT, MPX 멤버를 포함합니다.

또한 FileType.PSD, PSB, AI, ONE 멤버도 추가되었습니다. 이 형식은 여전히 Windows 전용이며, 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)   # Windows에서는 True, Linux 및 macOS에서는 False
print(".mpp" in supported)   # 모든 플랫폼에서 True

코드 예제

Linux 또는 macOS에서 일일 시간 단위로 Microsoft Project 파일을 렌더링하는 예제:

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

직접 다운로드

GroupDocs.Viewer for Python via .NET 26.9 페이지에서 모든 플랫폼용 wheel 파일을 다운로드하십시오.

리소스