소개
한글 문서 파일을 파싱하고 렌더링하는 Swift 패키지
본 제품은 한글과컴퓨터의 한글 문서 파일(.hwp) 공개 문서를 참고하여 개발하였습니다.
라이브러리 구조와 공개 API는 모듈별 문서에서 확인할 수 있습니다.
모듈 문서
- CoreHwp — HWP 5.0·HWPX(OWPML) 파일 파서 (macOS·iOS·tvOS·watchOS·Linux)
- HwpKitCore — 조판과 그리기 명령 생성을 담당하는 렌더링 코어 (Apple 전용)
- HwpKitNative — AppKit·UIKit 기반 렌더링 계층 (Apple 전용)
- HwpKit — SwiftUI 뷰어 공개 API (Apple 전용)
전체 모듈 색인은 패키지 문서 페이지에서도 볼 수 있습니다.
설치
Apple 플랫폼(macOS 14+ / iOS 17+ / tvOS 17+ / watchOS 10+)은 추가 설치가 필요 없습니다 — 압축 해제에 SDK 내장
Compression을 씁니다. Linux 등 그 외 플랫폼에서는 zlib이 필요합니다. 빌드에는 개발
헤더(apt install zlib1g-dev, rpm 계열은 dnf install zlib-devel), 실행에는 zlib 런타임이 있어야 합니다.
공식 Swift 도커 이미지에는 이미 포함되어 있습니다.
Xcode에서 File > Swift Packages > Add Package Dependency... 메뉴를
선택하세요.
또는 의존성을 아래와 같이 수동으로 추가합니다.
dependencies: [
.package(url: "https://github.com/sboh1214/hwp-swift.git", .upToNextMinor(from: "0.19.0")),
],이 저장소는 1.0 전까지 파괴 변경을 minor 버전에 싣습니다.
.upToNextMinor(from: "0.19.0")은 0.19.0..<0.20.0만 허용하므로, minor 버전은 릴리스 노트를 확인한 뒤 올리는 것을 권장합니다.
기여
CONTRIBUTING.md를 방문하세요.
라이센스
본 라이브러리는 LGPL 라이센스를 따릅니다.