NuGetを使用したDocumentizeのインストール

NuGetパッケージマネージャーコンソールを使用したインストール方法

1. プロジェクトを開く:

   • Visual Studioを起動し、.NETアプリケーションを開きます。

2. パッケージマネージャーコンソールにアクセスする:

   • ツール > NuGetパッケージマネージャー > パッケージマネージャーコンソールに移動します。

3. パッケージをインストールする:

   • 最新のフルリリースをインストールするには、コマンドInstall-Package Documentizeを入力します。
   • ホットフィックスを含む最新のリリースをインストールするには、Install-Package Documentize -prereleaseを使用します。
   • コマンドを実行するにはEnterを押します。

NuGetパッケージマネージャーコンソールを使用したパッケージの更新方法

すでにNuGetを通じてDocumentizeをインストールしていて、最新バージョンに更新したい場合:

1. プロジェクトを開く:

   • Visual Studioを起動し、.NETアプリケーションを開きます。

2. パッケージマネージャーコンソールにアクセスする:

   • ツール > NuGetパッケージマネージャー > パッケージマネージャーコンソールに移動します。

3. パッケージを更新する:

   • 最新のフルリリースに更新するには、Update-Package Documentizeを入力します。
   • ホットフィックスを含む最新のリリースに更新するには、Update-Package Documentize -prereleaseを使用します。
   • コマンドを実行するにはEnterを押します。

NuGetパッケージマネージャーGUIを使用したインストール方法

1. プロジェクトを開く:

   • Visual Studioを起動し、.NETアプリケーションを開きます。

2. NuGetパッケージの管理に移動する:

   • プロジェクトメニューからNuGetパッケージの管理を選択します。

3. Documentizeを検索する:

   • ブラウズタブに移動し、検索ボックスにDocumentizeを入力します。

4. パッケージをインストールする:

   • Documentizeの最新バージョンの隣にあるインストール/更新をクリックします。
   • ポップアップウィンドウで受け入れるをクリックして確認します。

NuGetを使用する利点

• 自動依存関係管理:

  • NuGetは自動的に依存関係を管理し、必須のすべてのライブラリが正しく含まれ、更新されるようにしています。これにより、欠落や互換性のない依存関係のリスクが軽減されます。

• 簡素化された更新:

  • パッケージの更新は、パッケージマネージャーコンソールやGUIを通じて簡単です。これにより、ライブラリを最新の機能やバグ修正で常に最新の状態に保つことができます。

• Visual Studioとの統合:

  • NuGetはVisual Studioとシームレスに統合されており、開発環境を離れることなくパッケージを管理するためのユーザーフレンドリーなインターフェースを提供します。

• バージョン管理:

  • NuGetを使用すると、ライブラリの異なるバージョンを指定して管理でき、以前のバージョンに簡単に戻したり、新しいリリースをテストしたりすることができます。

NuGetを使用する欠点

• Visual Studioに限定:

  • NuGetは主にVisual Studioでの使用を目的としています。他の環境でも使用することはできますが、Visual Studioでの統合が最も強力です。

• バージョンの競合の可能性:

  • 多くの依存関係を持つ大規模プロジェクトでは、バージョンの管理や競合の解決が複雑になることがあります。NuGetはこれを管理するためのツールを提供しますが、注意深い対応が必要です。

• ネットワーク依存:

  • パッケージのインストールや更新にはインターネット接続が必要です。制限された環境やインターネットアクセスがない環境で作業している場合、オフラインの方法や事前にパッケージをダウンロードする必要があるかもしれません。

• 大規模プロジェクトの複雑さ:

  • 非常に大規模なプロジェクトで広範な依存関係ツリーを持つ場合、NuGetを通じてパッケージを管理するオーバーヘッドが煩雑になることがあります。そのような場合、依存関係を効果的に管理するための追加のツールや戦略が必要になることがあります。

MSIを介してDocumentizeをインストールする

MSIインストーラーを介してインストールする方法

1. MSIインストーラーをダウンロード:

   • v24.12 MSIをクリックして、最新バージョンのDocumentize用のMSIインストーラーをダウンロードします。

2. インストーラーを実行:

   • ダウンロードしたMSIファイルをダブルクリックして、インストールウィザードを起動します。

3. インストールウィザードに従う:

   • インストーラーから提供される画面の指示に従います。ライセンス契約に同意し、インストールオプションを選択する必要があるかもしれません。

4. インストールを完了:

   • インストールが完了すると、DocumentizeのDLLがシステムのグローバルアセンブリキャッシュ（GAC）または指定された別の場所にインストールされます。

5. インストールを確認:

   • 指定されたインストールディレクトリまたはGACにDLLが正しくインストールされているか確認します。

MSIインストーラーを使用する利点

• 使いやすさ:

  • MSIインストーラーは、シンプルでガイド付きのインストールプロセスを提供します。必要なすべての設定を処理し、DLLを中央の場所に配置するため、複数のプロジェクトでDocumentizeを簡単に使用できます。

• システム全体のインストール:

  • MSIメソッドはDocumentizeをシステムのグローバルアセンブリキャッシュ（GAC）または他の中央の場所にインストールします。これにより、システム上の任意のアプリケーションがDLLに個別に参照することなくアクセスできるようになります。

• 自動更新:

  • Documentizeが更新されたインストーラーを提供する場合、新しいMSIファイルを実行することで簡単にインストールを更新できます。通常、更新プロセスはスムーズに処理されます。

• 一貫性:

  • MSIインストーラーを使用することで、必要なすべてのファイルが異なる環境全体で正しく一貫してインストールされることが保証され、DLLの不足や配置ミスのリスクが減ります。

MSIインストーラーを使用する欠点

• 柔軟性の制限:

  • MSIインストーラーはDocumentizeをシステム全体の場所にインストールするため、すべての開発環境に適しているわけではありません。プロジェクト固有の設定やバージョンに対応できる柔軟性が欠けている場合があります。

• 潜在的なオーバーヘッド:

  • DLLをGACにインストールすると、オーバーヘッドや複雑さが生じる可能性があります。特に、複数のバージョンのDocumentizeが同時に必要とされるシナリオでは顕著です。

• 手動削除:

  • Documentizeをアンインストールする必要がある場合、MSIによって提供されるアンインストーラーを使用する必要があります。適切に管理されないと、残存ファイルや設定が残る可能性があります。

• バージョンの競合:

  • システム全体のインストールでは、異なるプロジェクトが異なるバージョンのDocumentizeを要求する場合にバージョンの競合を引き起こす可能性があります。これらの競合を管理するには、追加の設定やクリーンアップが必要になる場合があります。

ZIPを使用したDocumentizeのインストール

ZIPアーカイブを使用したインストール方法

1. ZIPアーカイブのダウンロード:

   • 最新バージョンのDocumentizeをアーカイブ形式でダウンロードするには、 v24.12 ZIPをクリックします。

2. コンテンツの抽出:

   • ダウンロード後、ZIPファイルの内容を任意のディレクトリに抽出します。これらのファイルを共有ディレクトリに保存するか、プロジェクト構造内に保持することができます。

3. プロジェクトに参照を追加:

   • IDE（例: Visual Studio）でプロジェクトを開きます。
   • プロジェクト > 参照の追加 > 参照に移動し、DLLを抽出したディレクトリに移動します。
   • 関連するDLLファイルを選択し、プロジェクトへの参照として追加します。

4. 手動更新:

   • Documentizeの新しいバージョンがリリースされた場合、更新されたZIPアーカイブを手動でダウンロードし、プロジェクト内の古いDLLファイルを新しいものと置き換える必要があります。

ZIPアーカイブの利点

• 完全な制御:

  • DLLがどこにどのように保存され、プロジェクトで参照されるかを完全に制御できます。カスタム設定を好む場合や、依存関係を手動で管理する必要がある場合に有利です。

• パッケージマネージャーへの依存なし:

  • NuGetとは異なり、インストールの管理にパッケージマネージャーに依存しません。これは、パッケージマネージャーが利用できない環境や好まれない環境で有利です。

• ポータビリティ:

  • ZIPアーカイブは容易に共有や移動ができ、外部ツールに依存せずにプロジェクトをポータブルまたは配布可能にするのに適しています。

ZIPアーカイブの欠点

• 手動管理:

  • 更新や依存関係の管理が自動化されているNuGetとは異なり、ZIPアーカイブでは手動で更新を管理し、必要なDLLが正しく参照されることを確認する必要があります。

• バージョンの競合のリスク:

  • 複数のプロジェクトを管理している場合やチームで作業している場合、異なるプロジェクトが異なるバージョンのDLLを使用している場合に、バージョンの競合のリスクがあります。これには、プロジェクト間でのバージョンの慎重な追跡が必要です。

• 自動更新なし:

  • 新しいバージョンが利用可能になった際に自動更新や通知は受け取れません。定期的に更新を確認しない限り、古いライブラリを使用するリスクがあります。

非Windows環境

非Windows環境での .NET Core DLL の取り扱い

Documentize for .NET は .NET Standard 2.0 (.NET Core 2.0) をサポートしているため、Linux系のオペレーティングシステムで動作する Core アプリケーションで使用できます。私たちは常に API の .NET Core サポートを改善するために取り組んでいます。しかし、Documentize for .NET の機能を使用する際に、より良い結果を得るためにお客様に実行をお勧めする操作があります。以下をインストールしてください:

• libgdiplus パッケージ
• Microsoft 互換フォントのパッケージ: ttf-mscorefonts-installer（例: sudo apt-get install ttf-mscorefonts-installer）。これらのフォントは /usr/share/fonts/truetype/msttcorefonts ディレクトリに配置する必要があります。Documentize for .NET は、Linux系オペレーティングシステムでこのフォルダーをスキャンします。オペレーティングシステムにフォント用の別のデフォルトフォルダー/ディレクトリがある場合、Documentize を使用して操作を行う前に以下のコード行を使用する必要があります:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<ユーザーのフォントへのパス>"));

v24.12

新しいプラグインを追加: PDFからPNGコンバータ

• クラス PngConverter: Documentize.PngConverterプラグインを表します。PDF文書をPNG形式に変換するために使用します。
• クラス PdfToPngOptions: Documentize.PngConverterプラグインのPDFからPNGコンバータのオプションを表します。

使用例:

// PngConverterを作成
var plugin = new PngConverter();
// 指示を設定するためのPdfToPngOptionsオブジェクトを作成
var opt = new PdfToPngOptions();
// 入力ファイルパスを追加
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 出力ファイルパスを設定
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// 処理を実行
plugin.Process(opt);

新しいプラグインを追加: PDFからTIFFコンバータ

• クラス TiffConverter: Documentize.TiffConverterプラグインを表します。PDF文書をTIFF形式に変換するために使用します。
• クラス PdfToTiffOptions: Documentize.TiffConverterプラグインのPDFからTIFFコンバータのオプションを表します。

使用例:

// TiffConverterを作成
var plugin = new TiffConverter();
// 指示を設定するためのPdfToTiffOptionsオブジェクトを作成
var opt = new PdfToTiffOptions();
// 入力ファイルパスを追加
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 出力ファイルパスを設定
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// 処理を実行
plugin.Process(opt);

新しいプラグインを追加: PDFテーブルジェネレーター

• クラス TableGenerator: Documentize.TableGeneratorプラグインを表します。PDF文書にテーブルを追加するために使用します。
• クラス TableBuilder: PDFページのテーブルのビルダーを表すクラスです。
• クラス TableRowBuilder: テーブル行のビルダーを表すクラスです。
• クラス TableCellBuilder: テーブルセルのビルダーを表すクラスです。

使用例:

// TableGeneratorを作成
var plugin = new TableGenerator();
// 指示を設定するためのTableOptionsオブジェクトを作成
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("名前")
            .AddCell().AddParagraph("年齢")
        .AddRow()
            .AddCell().AddParagraph("ボブ")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("サム")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("サンディ")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("トム")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("ジム")
            .AddCell().AddParagraph("27");
// 入力ファイルパスを追加
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 出力ファイルパスを設定
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// 処理を実行
plugin.Process(opt);

クラス PdfDocをDocConverterに名前変更

• クラス DocConverter: Documentize.DocConverterプラグインを表します。PDF文書をDOC/DOCX形式に変換するために使用します。

使用例:

// DocConverterを作成
var plugin = new DocConverter();
// 指示を設定するためのPdfToDocOptionsオブジェクトを作成
var opt = new PdfToDocOptions();
// 入力ファイルパスを追加
opt.AddInput(new FileDataSource(inputPath));
// 出力ファイルパスを設定
opt.AddOutput(new FileDataSource(outputPath));
// 処理を実行
plugin.Process(opt);

v24.11

新しいプラグインを追加: PDF to JPEG Converter

• 目的: JpegConverterクラスは、PDFドキュメントをJPEG形式に変換するように設計されており、ユーザーがPDFから派生した画像を扱いやすく、共有しやすくします。
• コンストラクタ:
  • JpegConverter(): JPEGコンバータの新しいインスタンスを初期化します。

使用例:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);

• メソッド:
  • Process(PdfToJpegOptions options): 指定されたオプションを使用してJPEG変換プロセスを開始します。

クラス DirectoryDataSource を追加

• 目的: DirectoryDataSourceクラスは、プラグイン内でのロードおよび保存操作のためのディレクトリデータを管理することをユーザーに許可します。
• コンストラクタ:
  • DirectoryDataSource(string path): 指定されたパスを持つ新しいディレクトリデータオブジェクトを初期化します。

使用例:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• プロパティ:
  • DataType: データソースのタイプを取得します。
  • Path: 現在のデータディレクトリのパスを取得します。

クラス PdfToJpegOptions を追加

• 目的: このクラスはJPEG変換プロセスを構成するためのオプションを含み、ユーザーが解像度、ページリスト、および画像品質を指定できるようにします。
• コンストラクタ:
  • PdfToJpegOptions(): JPEGコンバータ用の新しいオプションインスタンスを初期化します。

プロパティ:

• OutputResolution: 結果のJPEG画像の解像度を指定します。
• PageList: PDFから変換するページのリスト。
• Quality: JPEG出力の品質を設定します。

v24.10

新しいプラグインを追加: PDF/A コンバーター

• 新しい PDF/A 変換機能が導入され、ユーザーは標準 PDF ファイルを簡単に PDF/A 準拠の文書に変換できるようになりました。

使用例:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

バグ修正

• 不正な出力パスを引き起こしていた FileResult クラスに関連する問題を修正しました。
• 大きなファイルを扱う際に HtmlConverter に影響を与える細かなバグを解決しました。

改善

• PdfExtractor と ImageExtractor の性能を向上させ、処理時間を短縮しました。
• 追加の回転角度をサポートするために RotateOptions クラスを更新しました。

v24.9

リリース済み