ComOfficeKit SDK · iOS 與 macOS

在你的 iPhone、iPad 與 Mac App 中處理 Office 文件

ComOfficeKit 是 LynxOffice 背後的文件引擎,以兩個 Swift 框架的形式提供,讓你放進自己的 App。讀取、編輯與儲存 Word、Excel 和 PowerPoint 檔案,並把頁面渲染成圖片或 PDF,全程都在裝置上完成。

iOS 16+macOS 13+Swift可離線使用

可免費評估約 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 風格的錯誤值,會以儲存格值的形式傳回,而不會以例外(exception)拋出。

內建字型

SDK 內附與 Calibri 和 Cambria 度量相容的字型,因此以這兩種字型排版的文件,版面尺寸都會正確。其他字型則取自系統,並備有可處理中文、日文與韓文文字的後備機制。

專為正式上線的 App 打造

在把文件引擎交到客戶手上之前,你原本得自己逐一確認的事項。

  • 完全不連網。你的授權是一行經過簽署的文字,直接在裝置上驗證,因此文件絕不會離開你的 App,啟用沙盒的 App 也不需要為了授權而取得網路 entitlement。
  • 型別明確的錯誤。引擎無法讀取的檔案,會產生一個指出有問題的部分及原因的錯誤;文件輸入絕不會讓你的 App 當機。
  • 可安全地平行執行。場景是符合 Sendable 的值型別,解析器、寫入器與渲染器都是無狀態的,因此可以同時處理不同的文件。
  • 兩種加入方式。從 GitHub 加入套件後,Swift Package Manager 會從其版本下載這兩個 framework 並驗證校驗和;或者使用每個版本附上的 zip,它是一個包含 framework、文件與範例的資料夾,再把它作為本機套件加入。

平台

iOS 16 與 iPadOS 16 或以上版本,以及 macOS 13 或以上版本。

格式

可讀入 .docx、.xlsx、.xlsm 與 .pptx,並輸出相同的格式、頁面圖片與 PDF。.xlsm 活頁簿中的巨集會原封不動地保留,而且絕不會執行。

技術文件

涵蓋兩個框架的 API 參考文件,另附入門、授權、錯誤與執行緒、渲染,以及處理 Word、試算表與簡報檔案的指南。線上閱讀(英文)。

它不做什麼

讓你及早判斷它是否適合。

不支援 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 在任何時候都不會發出網路呼叫,因此文件會留在你的 App 內。

支援哪些版本的 iOS 與 macOS?

iOS 與 iPadOS 16 或以上版本,以及 macOS 13 或以上版本。

可以開啟 PDF 檔案嗎?

不能。ComOfficeKit 處理的是 .docx、.xlsx、.xlsm 與 .pptx 檔案,並可將它們渲染成 PDF,但不會開啟或編輯 PDF 文件。

它和 LynxOffice 是同一個引擎嗎?

是的。LynxOffice 就是建立在同一個文件引擎之上,因此 SDK 讀取與渲染檔案的方式,和 App 相同。

與我們聊聊 ComOfficeKit

告訴我們你正在打造什麼、需要哪些平台,我們的業務團隊會回覆你。你也可以寫信至 support@comofficekit.com。