ComOfficeKit SDK · iOS 및 macOS

iPhone, iPad, Mac 앱 안에서 Office 문서 다루기

ComOfficeKit은 LynxOffice의 기반이 되는 문서 엔진으로, 직접 만든 앱에 넣을 수 있는 두 개의 Swift 프레임워크로 제공됩니다. Word, Excel, PowerPoint 파일을 읽고, 편집하고, 저장하며, 파일의 페이지를 이미지나 PDF로 렌더링하는 모든 작업을 전적으로 기기에서 처리합니다.

iOS 16+macOS 13+Swift오프라인에서 작동
문의하기 무료 평가 시작하기 API 레퍼런스(영어) 보기

약 60일간 무료로 평가할 수 있습니다.

Swift

import DocumentCore
import AppleRender

// verified on the device; no network
try SDKLicense.activate(key: licence)

let scene = try DocumentParser.parse(docxAt: url)
let doc = ParsedDocument.word(scene)

let n = try DocumentRenderer.pageCount(of: doc)
let image = try DocumentRenderer.image(
    of: doc, page: 0, scale: 2)
let pdf = try DocumentRenderer.pdfData(of: doc)

SDK 구성

두 개의 Swift 프레임워크입니다. DocumentCore는 파일을 읽고 쓰며, AppleRender는 파일의 페이지를 그립니다.

DocumentCore: 읽기, 편집, 저장

.docx, .xlsx, .pptx 파일을 구조화된 불변 씬(scene)으로 파싱합니다. 씬은 단락, 런(run), 표, 구역; 시트, 셀, 수식; 슬라이드와 도형으로 이루어집니다. 편집한 씬을 파생해 저장하면 변경한 부분만 다시 생성되고, 파일의 나머지 부분은 손대지 않고 그대로 옮겨집니다.

AppleRender: 페이지, 이미지, PDF

Core Text와 Core Graphics로 문서를 레이아웃하고 모든 페이지를 이미지나 PDF로 렌더링합니다. Word 문서는 내용이 페이지 단위로 나뉘어 배치되고, 스프레드시트는 인쇄용으로 시트별로 페이지가 나뉘며, 각 슬라이드는 한 페이지가 됩니다.

수식 엔진

스프레드시트 수식을 계산합니다. #DIV/0!, #REF! 같은 Excel 방식의 오류 값은 예외가 아니라 항상 셀 값으로 반환됩니다.

글꼴 포함

Calibri 및 Cambria와 메트릭이 호환되는 글꼴이 SDK에 포함되어 있으므로, 이 글꼴로 작성된 문서도 올바른 크기로 배치됩니다. 그 밖의 글꼴은 시스템에서 가져오며, 중국어, 일본어, 한국어 텍스트를 처리하는 대체 글꼴 체계가 함께 적용됩니다.

앱에 바로 탑재할 수 있도록 설계

문서 엔진을 고객에게 내놓기 전에 직접 확인해야 하는 사항들입니다.

  • 네트워크를 전혀 사용하지 않습니다. 라이선스는 기기에서 검증하는 서명된 한 줄짜리 문자열이므로 문서가 앱 밖으로 나가지 않으며, 샌드박스 앱도 라이선스 때문에 네트워크 권한(entitlement)이 필요하지 않습니다.
  • 타입이 지정된 오류. 엔진이 읽을 수 없는 파일은 문제가 된 부분과 그 이유를 밝히는 오류를 반환하며, 문서를 입력하다가 앱이 비정상 종료되는 일은 없습니다.
  • 병렬 실행에 안전합니다. 씬은 Sendable 값 타입이고 파서, 라이터, 렌더러는 상태를 갖지 않으므로 서로 다른 문서를 동시에 처리할 수 있습니다.
  • 추가하는 방법은 두 가지입니다. GitHub에서 패키지를 추가하면 Swift Package Manager가 릴리스에서 두 프레임워크를 내려받아 체크섬을 검증합니다. 또는 각 릴리스에 첨부된 zip, 즉 프레임워크와 문서, 샘플이 들어 있는 폴더를 받아 로컬 패키지로 추가할 수 있습니다.

플랫폼

iOS 16 및 iPadOS 16 이상, macOS 13 이상.

형식

.docx, .xlsx, .xlsm, .pptx 파일을 입력받아 같은 형식, 페이지 이미지, PDF로 출력합니다. .xlsm 통합 문서의 매크로는 바이트 단위로 그대로 보존되며 실행되지 않습니다.

개발자 문서

시작하기, 라이선스, 오류와 스레딩, 렌더링, Word·스프레드시트·프레젠테이션 파일 작업에 관한 가이드를 갖춘 두 프레임워크의 API 레퍼런스입니다. 온라인에서 보기(영어).

제공하지 않는 기능

맞는 제품인지 미리 판단하실 수 있도록 정리했습니다.

PDF 편집 불가

ComOfficeKit은 문서를 PDF로 렌더링합니다. PDF 파일을 열거나 주석을 달거나 편집하지는 않습니다.

사용자 인터페이스 없음

편집기나 뷰어 화면이 없습니다. 인터페이스는 직접 만들고, SDK는 문서 모델을 제공하고 페이지를 그립니다.

Apple 플랫폼 전용

이 SDK는 iOS, iPadOS, macOS에서 실행됩니다. Windows에는 별도의 SDK인 ComOfficeKit for Windows가 있으니, 그 밖에 필요한 플랫폼을 알려 주시기 바랍니다.

자주 묻는 질문

ComOfficeKit은 어떻게 받을 수 있습니까?

Swift Package Manager로 GitHub에서 추가합니다. README에 약 60일간 유효한 무료 평가 키가 공개되어 있어 가입 없이 SDK 전체를 사용해 볼 수 있습니다. 라이선스가 필요하시면 문의 양식으로 영업팀에 프로젝트를 알려 주시거나 support@comofficekit.com으로 메일을 보내 주시기 바랍니다.

네트워크 연결이 필요합니까?

아니요. 라이선스는 기기에서 검증되며 SDK는 어떤 경우에도 네트워크 호출을 하지 않으므로, 문서가 앱 안에 그대로 남아 있습니다.

지원하는 iOS 및 macOS 버전은 무엇입니까?

iOS 및 iPadOS 16 이상, macOS 13 이상입니다.

PDF 파일을 열 수 있습니까?

아니요. ComOfficeKit은 .docx, .xlsx, .xlsm, .pptx 파일을 다루며 이를 PDF로 렌더링합니다. PDF 문서를 열거나 편집하지는 않습니다.

LynxOffice와 같은 엔진입니까?

예. LynxOffice는 같은 문서 엔진을 기반으로 만들어졌으므로, SDK는 앱과 같은 방식으로 파일을 읽고 렌더링합니다.

ComOfficeKit에 대해 상담하기

개발하려는 내용과 필요한 플랫폼을 알려 주시면 영업팀이 회신해 드립니다. support@comofficekit.com으로 직접 문의하셔도 됩니다.

문의하기 무료 평가 시작하기