2.1. ライブラリファイル、ヘッダーファイルを配置する

2.2. ライセンスファイルを配置する

2.3. フォントの準備

テキスト透かしを挿入したりページ上に文字を描画するには、フォント情報が必要です。

Windows版では、PDF Tool APIはシステムのフォントフォルダに存在するフォントを参照します。

2.4. Windows開発環境における環境変数のまとめ

3.1. プロジェクトの新規作成とPDF Tool APIモジュールファイルの参照追加

(1) Visual Studio 2022を起動します。

(2) 「新しいプロジェクトを作成」において、C#の「コンソールアプリ」を選択し「次へ」ボタンをクリックします。

(3) 「プロジェクト名」、「場所」を設定し「次へ」ボタンをクリックします。

(4) 「フレームワーク」に「.NET 6.0（長期的なサポート）」が選択されているのを確認し「作成」ボタンをクリックするとプロジェクトが開きます。

(5) 「プロジェクト」メニューの「既存の項目の追加. . .」を選択するとファイル選択ダイアログが表示されます。

(6) サンプルのcsファイルをひとつ選択します。プロジェクトのソースファイルとして追加されます。プロジェクト生成時に作成されるcsファイルはプロジェクトから削除してください。

(7) 「ビルド」メニューの「構成マネージャー. . .」を選択します。

(8) 「アクティブソリューション構成」と「アクティブソリューションプラットフォーム」を設定します。プラットフォームは、「x86」または「x64」のどちらかを新規作成します。

(9) 「プロジェクト」メニューの「プロジェクト参照の追加. . .」を選択すると、「参照マネージャー」ダイアログが開きます。

(10) 「参照」タブを開き、ダイアログ右下の「参照．．．」ボタンをクリックします。

(11) ファイル選択ダイアログが開きます。インストールフォルダまたは任意の場所に配置したPDF Tool APIモジュールファイルの「PdfTkNet6_70.dll」を選択します。ソリューションプラットフォームが「x64」の場合は「bin64」フォルダにある64bit用、「x86」の場合は「bin32」フォルダにある32bit用の「PdfTkNet6_70.dll」を選択してください。

(12) 「OK」ボタンをクリックして「参照マネージャー」ダイアログを閉じます。参照したDLLは、ソリューションエクスプローラーの「依存関係」‐「アセンプリ」で確認できます。

3.2. ビルドの設定とビルド

Windows用のビルドを行います。

(1) 「プロジェクト」メニューの「（プロジェクト名）のプロパティ」を選択します。

（図のプロジェクト名はConsoleApp1です。）

(2) 左側の「ビルド」タブを開き「出力」を選択します。

(3) 「基本出力パス」の欄にPdfTkNet6_70.dll、PdfTkNet6.dllを含むPDF Tool APIのdllが存在するフォルダを指定します。

(4) 「ビルド」メニューの「ソリューションのビルド」をクリックすると、ビルドが開始されます。

(5) ビルドされたexeを実行するには、exeとともに作成される、exeと同名の「.dll」と「.runtimeconfig.json」が必要です。

3.3. デバッグビルドの設定とデバッグ実行

Windows用のデバッグビルドを行います。

(1) 「プロジェクト」メニューの「（プロジェクト名）のプロパティ」を選択します。

（図のプロジェクト名はConsoleApp1です。）

(2) 左側の「デバッグ」タグを開き「デバッグ起動プロファイルUIを開く」をクリックして「プロファイルの起動」ダイアログを開きます。

(3) 「プロファイルの起動」ダイアログの「作業ディレクトリ」の欄にPdfTkNet6_70.dll、PdfTkNet6.dllを含むPDF Tool APIのdllのあるフォルダを指定します。必要に応じて、「コマンドライン引数」を指定します。

(4) 「デバッグ」メニューの「デバッグの開始」をクリックすると、デバッグ実行できます。

3.4. アプリケーションの発行

Windows用、Linux用それぞれのアプリケーションファイルを発行します。

(1) プロジェクトで右クリックし開いたメニューで「発行. . .」を選択します。

2. 「公開」ダイアログが開くので公開先を指定します。ここでは、ローカルフォルダーにアプリケーションを作成しますので、「フォルダー」を選択し、右下の「次へ」ボタンをクリックします。
3. 次の画面でも「フォルダー」を選択し右下の「次へ」ボタンをクリックします。

(4) 「フォルダーの場所」を指定します。

(5) 「実行プロファイル作成の進行状況」が表示された場合は、「閉じる」ボタンをクリックします。

(6) 中央下にある「すべての設定を表示」をクリックします。

(7) 「プロファイル設定」ダイアログが開くので各項目を設定します。

ターゲットフレームワーク：net6.0

配置モード：「自己完結」

発行されるアプリケーションファイルには、ターゲットフレームワークのランタイムライブラリーが含まれます。このため、アプリケーションファイルを実行する環境に、ターゲットフレームワークの.NETランタイムライブラリーをインストールする必要はありません。ただし、ファイルサイズは大きくなります。

配置モード：「フレームワーク依存」

発行されるアプリケーションファイルには、ターゲットフレームワークのランタイムライブラリーは含まれません。アプリケーションファイルを実行する環境には、ターゲットフレームワークの.NETランタイムライブラリーをインストールしてください。

ターゲットランタイム

「win-x64 (Windows 64bit)」、「win-x86 (Windows 32bit)」、「linux-x64 (Linux 64bit)」のいずれかを選択します。PDF Tool APIは、arm、osx（Mac OS X）には対応していません。

(8) 「ファイルの公開オプション」を開きます。「単一ファイルの作成」にチェックを入れます。

(9) 「発行」ボタンをクリックすると、「（日時）に公開が成功しました。」と表示され発行が完了します。

(10) 「フォルダーを開く」または「ターゲットの場所」をクリックすると「フォルダーの場所」に指定したフォルダが開き、発行されたファイルを確認できます。

(11) 「ターゲットランタイム」が「win-x86」、「win-x64」の場合、発行された拡張子「.exe」ファイルが実行ファイルです。.exeファイルとPDF Tool APIのモジュールファイルを同じフォルダに配置することで実行可能です。

「ターゲットランタイム」が「linux-x64」の場合、発行された拡張子のないファイルが実行ファイルです。

4.1. Windowsでの実行について

1. 「配置モード」が「フレームワーク依存」であるアプリケーションファイルの場合、あらかじめ、ターゲットフレームワークの.NETランタイムライブラリーをインストールしてください。※1
2. PDF Tool APIのモジュールファイルをセットアップします。※2
3. 発行されたアプリケーションファイルを、PDF Tool APIのモジュールファイルと同じ場所に配置します。あるいは、環境変数「PATH」に、PDF Tool APIのモジュールファイルが存在するフォルダパスを設定します。
4. PDF Tool APIのライセンスファイルを配置します。「「PdfTk70.dll」」と同じ場所に配置する、または、ライセンスファイルを配置したフォルダパスを環境変数「PTL70_LIC_PATH」に設定してください。※3
5. 必要に応じ、フォント構築ファイルの設定を行ってください。※4
6. コマンドプロンプトを起動しアプリケーションファイルが存在するフォルダパスをカレントディレクトリにして実行します。必要に応じて、コマンド入力時に引数を指定してください。

※1 .NET6ランタイム　インストーラの入手先

https://dotnet.microsoft.com/ja-jp/download/dotnet/6.0

「.NET Runtime 6.0.xx」の項にある「Windows」の「x64」または「x86」インストーラ－をダウンロードしてセットアップしてくだい。

※2 実行環境にモジュールファイルをセットアップする場合、PDF Tool API付属のインストーラは使用しないでください。

※3 『Windows開発環境における環境変数のまとめ』をご参照くさい。

※4 『フォントの準備』をご参照ください。

4.2. Linuxでの実行について

1. 「配置モード」が「フレームワーク依存」であるアプリケーションファイルの場合、あらかじめ、ターゲットフレームワークの.NETランタイムライブラリーをインストールしてください。※1
2. PDF Tool APIのモジュールファイルをセットアップします。※2
3. アプリケーションファイルを任意の場所に配置します。
4. PDF Tool APIのライセンスファイルを配置します。
5. テキスト透かしやテキスト追加など文字を扱う処理を行う場合、「font-config.xml」（フォント構築ファイル）にてフォントディレクトリの設定を行います。Linuxでは、フォント構築ファイルは必須です。
6. モジュールファイル、フォント構築ファイル、ライセンスファイルを利用するための環境変数を設定します。※3
7. 「端末」を起動し、アプリケーションファイルがあるディレクトリをカレントにして実行します。必要に応じて、コマンド入力時に引数を指定してください。※4a、※4b

※1 『付録1.,NET6ランタイムのインストール方法』参照

※2 実行環境にモジュールファイルをセットアップする場合、PDF Tool API付属のインストーラは使用しないでください。

※3 環境変数と設定値

LD_LIBRARY_PATH={PDF Tool APIモジュールファイルのディレクトリ} :${LD_LIBRARY_PATH}

PTL70_LIC_PATH={ライセンスファイルのディレクトリ}

PTL70_FONT_CONFIGFILE={ font-config.xmlのパス}

※4a 「配置モード」が「自己完結」設定のアプリケーションファイルを実行する場合

アプリケーションファイルに.NET6ランタイムライブラリーが含まれているため、「dotnet」コマンドは不要です。

　コマンド：./{アプリケーションファイル名} {オプション}

※4b 「配置モード」が「フレームワーク」設定のアプリケーションファイルを実行する場合

「dotnet」コマンド付けて実行ます。

コマンド：dotnet {アプリケーションファイル名} {オプション

5.1. Linux環境

5.1.4. PDF Tool API のサンプルコードを使用したプログラムの作成

(1) PDF Tool APIのインストール

「2.PDF Tool APIの開発環境を整える」を参照してください。

(2) VSCodeを起動してプロジェクトを作成します。

(3) 「（フォルダ名）.csproj」 を開いて赤字の箇所を追記します。
<HintPath> にはPdfTkNet6_70.dllのパスを記入します。

(4) 「ファイル」メニューの「ファイルを開く」を選択して使用したいサンプルコードのcsファイルを開きます。

(5) 「ファイル」メニューの「名前を付けて保存」を選択してプロジェクト生成時に作成された「Program.cs」に上書き保存します。または、「ファイル」メニューの「名前を付けて保存」を選択して別名保存を行い、その後「Program.cs」を選択し右クリックメニューで「削除」します。

(6) ターミナルに下記のコマンドを入力しビルドを行います。

dotnet build -c Release

(7) ビルドが完了したら、下記のコマンドで実行します。

dotnet run

5.2. Windows環境