Spire.Doc for C++ 14.9.11 のリリースをお知らせします。本バージョンでは、対応プラットフォームを従来の2種類から10種類に拡張するとともに、4,237個の関数を宣言したパブリックC APIを導入しました。また、グラフ、SmartArt、テーマ、VBA、デジタル署名、変更履歴の追跡などに関する機能も追加しています。
重要: バージョン14.9.11は、バージョン13.8.2とそのまま置き換えて使用できる互換バージョンではありません。既存のプロジェクトではソースコードの修正と全面的な再ビルドが必要です。ライブラリファイルの置き換えだけでは対応できません。
| リリース変更一覧 | ID | 説明 |
| 新機能 | - | Windows ARM64、Linux ARM64、Linux musl、macOS ARM64、およびHarmonyOS ARM64とx86_64への対応を追加し、対応プラットフォームを10種類に拡張しました。 |
| 新機能 | - | Spire.Doc.C.h に4,237個の関数を宣言したパブリックC APIを導入しました。 |
| 新機能 | - | グラフ、SmartArt、テーマ、VBAプロジェクト、デジタル署名、変更履歴の追跡、ドキュメントのナビゲーション、ページ操作、レンダリングに関するAPIとクラスを追加しました。 |
| 新機能 | - | XLSX形式へのエクスポートに対応し、Markdownエクスポートオプション、カスタムフォント管理、ドキュメント保護、およびドキュメント形式関連のAPIを拡張しました。 |
| 調整 | - | C++のヘッダーファイル構成と名前空間を再編成しました。 |
| 調整 | - | 多くのAPIで、文字列の処理方式をワイド文字列からUTF-8文字列に変更しました。 |
| 調整 | - | リストスタイルの管理方式を再設計し、複数の主要メソッドとクラスを更新しました。 |
| 調整 | - | ライブラリ名とプラットフォーム別のライブラリディレクトリを変更しました。 |
| 調整 | - | バイナリインターフェースを変更しました。既存のプロジェクトでは、新しいヘッダーファイルとライブラリを使用して再ビルドする必要があります。 |
1. バージョン比較:13.8.2と14.9.11
| 項目 | バージョン13.8.2 | バージョン14.9.11 |
| 対応プラットフォーム数 | 2 | 10 |
| パッケージサイズ | 343.5 MB | 918.8 MB |
| ヘッダーファイル(.h) | 417 | 508 |
| パブリックC API | なし | 4,237個の関数を宣言 |
| エクスポートされたクラス定義数 | 271 | 336 |
| AOTライブラリのバージョン | 13.8.2.17370 | 14.9.11.3420 |
| デモソースファイル(.cpp) | 311 | 330 |
対応プラットフォームの拡張とパッケージ構成の再編成に伴い、パッケージサイズは343.5 MBから918.8 MBに増加しました。
2. プラットフォームとバイナリの変更
バージョン14.9.11では、以下のプラットフォームに対応しました。
- Windows: win-x64、win-arm64
- Linux(glibc): linux-x64、linux-arm64
- Linux (musl): linux-musl-x64、linux-musl-arm64
- HarmonyOS: ohos-x86_64、ohos-arm64-v8a
- macOS: osx-x64、osx-arm64
パッケージのディレクトリ構成とバイナリ依存関係も変更されています。
- Windowsのライブラリ名が Spire.Doc.Cpp.dll から SpireDocCpp.dll に変更されました。対応するインポートライブラリの名前も変更されています。
- プラットフォーム別のライブラリは、lib/win-x64、lib/linux-arm64、lib/ohos-arm64-v8a などのディレクトリに配置されるようになりました。
- Skiaに加えてHarfBuzzが追加され、新たなネイティブ依存関係が導入されました。
- 新しいパッケージでは、32ビット環境向けのターゲットは提供されません。
デプロイ要件
新バージョンをデプロイする前に、以下の要件を確認してください。
- Linux(glibc): 対象環境ではglibc 2.29以降が必要です。
- Linux(musl)およびHarmonyOS:パッケージのドキュメントに従って、ICUとfontconfigの依存関係を配置してください。依存関係が不足している場合、Document オブジェクトの生成やSkiaの読み込みに失敗する可能性があります。
- HarmonyOS: パッケージのドキュメントに従い、DevEco Studioに付属する ohos-clang ツールチェーンを使用してください。
- テキストレンダリング:HarfBuzzを含む必要なネイティブ依存関係が、デプロイ環境で利用可能であることを確認してください。
コンパイラー、リンカー、ランタイムの具体的な設定については、新しいパッケージに含まれるREADMEファイルを参照してください。
3. ヘッダーファイルと名前空間の再編成
従来のエントリーポイントとなるヘッダーファイル Spire.Doc.o.h は削除されました。バージョン14.9.11では、.NET APIにより近い構成となるよう、機能領域と名前空間に応じて include/Spire/Doc/ 以下にヘッダーファイルが再編成されています。
また、パブリックC APIを定義する Spire.Doc.C.h も提供されます。
インクルードディレクトリ
新しいパッケージのドキュメントでは、以下の3つのインクルードディレクトリが指定されています。
include
include/Spire/Doc
include/Spire/Doc/common/h
既存のプロジェクトでは、新しい構成に合わせてヘッダーファイルのインクルード指定とコンパイラー設定を更新する必要があります。
名前空間の変更
バージョン13.8.2では、多くのクラスが Spire::Doc に配置されていました。バージョン14.9.11では、クラスが以下のような複数の名前空間に分割されています。
- Spire::Doc::Documents
- Spire::Doc::Fields
- Spire::Doc::Formatting
- Spire::Doc::Collections
- Spire::Doc::Pages
- Spire::Doc::Fields::Shapes::Charts
- Spire::Doc::Reporting
- Spire::Doc::Interface
例えば、Document、Section、Table は引き続き Spire::Doc に属しますが、Paragraph、TextRange、CharacterFormat などのクラスは、より具体的な名前空間に配置されています。
そのため、using namespace Spire::Doc; のみを使用している既存コードでは、追加の名前空間指定が必要になる場合があります。
4. 互換性に影響するAPI変更
バージョン14.9.11では、公開C++インターフェースに大幅な変更が加えられています。以下に、ソースコードの修正が必要となる主な変更例を示します。
4.1 文字列ABI:ワイド文字列からUTF-8へ
多くのAPIで、文字列の処理方式がワイド文字列からUTF-8文字列に変更されました。
バージョン13.8.2:
typedef const wchar_t* LPCWSTR_S; intrusive_ptr<TextRange> AppendText(LPCWSTR_S text);
Version 14.9.11:
typedef const char* LPCWSTR_S; intrusive_ptr<TextRange> AppendText(const std::string& text);
その他、以下のAPIも変更されています。
- Document::LoadFromFile() と Document::SaveToFile():該当するパラメーターが const std::string& に変更されました。
- Style::GetName():戻り値が値渡しの std::string に変更されました。
- その他、ワイド文字列を引数または戻り値として使用していたメソッドも変更されています。
既存コードを移行する際は、必要に応じて L"example" のようなワイド文字列リテラル、std::wstring、wchar_t* などを、新しいUTF-8 APIに対応する形式へ変更してください。 MSVCを使用する場合は、新しいヘッダーに合わせて、必要に応じてソースコードの文字エンコーディングを /utf-8 で設定してください。
4.2 ListStyleとStyle Collection APIの再設計
リストスタイルの管理方式が再設計され、スタイルコレクションとリスト定義参照を使用する構成に変更されました。
バージョン13.8.2:
auto listStyle = new ListStyle(document, ListType::Numbered);
listStyle->SetName(L"MyStyle");
for (int i = 0; i < listStyle->GetLevels()->GetCount(); i++)
listStyle->GetLevels()->GetItem(i);
document->GetListStyles()->Add(listStyle);
バージョン14.9.11:
auto listStyle = document->GetStyles()->Add(ListType::Numbered, "MyStyle");
for (int i = 0; i < listStyle->GetListRef()->GetLevels()->GetCount(); i++)
listStyle->GetListRef()->GetLevels()->GetItem(i);
document->GetStyles()->Add(listStyle);
主な変更点は以下のとおりです。
- ListStyle のコンストラクターが protected になりました。インスタンスは StyleCollection::Add(ListType, name) などのファクトリーメソッドを通じて作成する必要があります。
- ListStyle::GetLevels() は削除され、GetListRef()->GetLevels() に置き換えられました。
- Document::GetListStyles() と AddListStyle() は削除され、Document::GetStyles() を使用する構成になりました。
- StyleCollection に Add(ListType, name) と Add(StyleType, name) のオーバーロードが追加されました。
- ListFormat は ListDefinitionReference を使用するようになり、ApplyListRef、GetCurrentListRef、SetCurrentListRef などのメソッドが導入されました。
4.3 その他の名称変更・削除されたAPI
主な変更例は以下のとおりです。
- Document::CloneDocument() → Document::Clone()
- Table::GetTableFormat() → Table::GetFormat()
- Table::GetTableStyleName() → TableFormat::GetStyleName()
- TableCell::GetWidth()、SetWidth()、SetCellWidthType() → GetCellWidth()、SetCellWidth(width, type)
- Paragraph::GetIsFrame() → Paragraph::GetFrame()->GetIsFrame()
- Paragraph::GetIsFrame() → Paragraph::GetFrame()->GetIsFrame()talSignatureCollection
- DigitalSignatures → DigitalSignatureCollection
- SpireString → String
- MathObject → OfficeMath
- TextEffect → TextEffectFormat
ライセンス設定も License::LicenseProvider 配下に再編成されています。置き換え後のメソッドとシグネチャについては、新しいヘッダーファイルを確認してください。
また、従来の Document で公開されていた以下のメソッドは、同じ形式では利用できなくなりました。
CreateObjectByTypeName、CreateParagraphItemByType、GetOriginalFileFormat、GetUseNewEngine、GetXHTMLValidateOption、OpenOnlineBin、SaveToOnlineBin
ここに挙げたのは代表的な変更例であり、すべての変更を網羅したものではありません。使用頻度の低いクラスやメソッドに依存するコードを移行する際は、新しいヘッダーファイルを確認してください。
4.4 C++ラッパーにおけるイベント登録
バージョン14.9.11のC++ラッパーでは、従来 Document クラスで利用できた一部のイベント登録メソッドが公開されなくなりました。これには、ページレイアウト、フィールド更新、ブックマークレイアウト、評価情報に関連するメソッドが含まれます。
一方、以下のような対応する関数の一部は、新しいC APIから引き続き利用できます。
- Document_add_PageLayout
- Document_add_UpdateFields
- Document_add_BookmarkLayout
これらのイベントに依存するアプリケーションでは、実装を確認し、C APIまたは適切なコールバック機構を使用するかどうかを検討してください。
5. 新しいAPIとドキュメント処理機能
バージョン14.9.11では、ドキュメント処理の複数の領域にわたり、多数のAPIとクラスが追加されました。
5.1 ドキュメントのナビゲーション、検索、ページ操作
主な追加メソッドは以下のとおりです。
- 検索:FindPattern、FindPatternInLine、Paragraph::FindAllString、Paragraph::FindAllPattern
- ページ操作: ExtractPages、RemovePages、RemoveBlankPages
- レンダリングとレイアウト: SaveToImages、RenderToScale、RenderToSize、UpdatePageLayout、UpdateTableLayout
- エクスポート:SaveToXLSX、GetMarkdownExportOptions、SaveToFile(..., ExportOptions)
5.2 グラフ、SmartArt、テーマ、VBA
新バージョンでは、ドキュメントのコンテンツや構造を扱うためのクラスが追加されました。
- グラフ:Chart、ChartAxis、ChartSeries、ChartDataLabel、ChartLegend、ChartTitle
- SmartArt:SmartArt、SmartArtNode および関連する書式設定・図形プロパティのクラス
- テーマ:Theme、ThemeColors、ThemeFonts
- VBA:VbaProject、VbaModule、VbaReference
これらの追加により、ドキュメント内の各種要素や関連設定を操作するためのAPIが拡充されました。
5.3 デジタル署名、変更履歴の追跡、ドキュメント保護
デジタル署名、変更履歴の追跡、ドキュメント保護、および関連操作のためのAPIが追加されました。主な例は以下のとおりです。
- Sign、HasDigitalSignature、GetDigitalSignatures
- StartTrackRevisions、StopTrackRevisions、GetRevisionInfos
- IsEncrypted、HasWriteProtection、SetWriteProtection、Unprotect
また、RevisionInfo、RevisionsView、MoveRevision、TextDiffMode などの変更履歴関連クラスも追加されました。
5.4 フォント管理と書式設定
カスタムフォント、フォントフォールバック設定、ハイフネーション辞書、書式設定オプションに関するAPIも拡張されています。主な例は以下のとおりです。
- SetCustomFonts、SetCustomFontsFolders、SetGlobalCustomFonts
- SetDefaultSubstitutionFontName、LoadFontFallbackRuleSettings
- RegisterHyphenationDictionary、UnregisterHyphenationDictionary
- 文字、段落、表の各書式設定に関する新しいプロパティ
5.5 エクスポート形式とパブリックC API
FileFormat 列挙型に、Dot、OOXML、Ott、Mhtml、HtmlFixed、PostScript、PCL、OFD、OnlineDoc、Wps、Wpt、XLSX、Auto などの値が追加されました。
新しいパブリックC APIは include/Spire.Doc.C.h で定義されており、4,237個の SPIRE_DOC_API 関数が宣言されています。このAPIは、C++ラッパーおよび基盤となるAOTエクスポートに加えて、C言語から利用できるインターフェースを提供します。文字列にはUTF-8を使用し、オブジェクトはヘッダーで定義されたハンドルを通じて操作します。
6. 移行チェックリスト
バージョン13.8.2から14.9.11へ既存のプロジェクトをアップグレードする前に、以下の項目を確認してください。
- アプリケーション全体を再ビルドする。 旧バージョン向けにコンパイルされたオブジェクトファイルと新しいライブラリを混在させないでください。パッケージのドキュメントでは、インターフェースおよび仮想関数テーブルのレイアウト変更に伴い、全面的な再ビルドが必要とされています。
- ヘッダーファイルのパスを更新する。 Spire.Doc.o.h への依存を削除し、新しい Spire/Doc/ 以下のヘッダーファイルを使用してください。
- インクルードディレクトリと名前空間を更新する。 必要なインクルードパスを設定し、必要に応じて名前空間の指定を追加してください。
- 文字列処理を移行する。 ワイド文字列を新しいUTF-8 APIに対応する形式へ変更し、必要に応じてMSVCで /utf-8 を設定してください。
- API呼び出しを更新する。 リストスタイルの管理、表の幅に関するメソッド、複製メソッド、書式設定API、ライセンス設定を確認してください。
- イベント処理を見直す。 C++ラッパーで公開されなくなったイベント登録メソッドについて、必要に応じてC APIまたは別の適切な方法を使用してください。
- リンカーとランタイムの設定を更新する。 新しいWindowsライブラリ名とプラットフォーム別ディレクトリを使用し、必要に応じてHarfBuzz、ICU、fontconfigなどのネイティブ依存関係を配置してください。
- C++言語標準を確認する。 パッケージの移行情報ではC++11/14が指定されており、C++17では byte の定義が競合する可能性が示されています。実際のビルド環境で互換性を確認してください。
- 代表的な処理を再ビルドしてテストする。 本番環境に導入する前に、ドキュメントの読み込み、編集、レンダリング、エクスポートを検証してください。
同梱デモに関する注意
同梱されている一部のデモソースには、削除された Spire.Doc.o.h、旧ライブラリパス、またはワイド文字列が残っている場合があります。そのため、バージョン14.9.11でコンパイルするには、デモ側の修正が必要になることがあります。
デモのコンパイルに失敗した場合は、新しいREADMEとサンプルを参照し、更新後のインクルードパス、文字列型、リンカー設定を確認してください。






