チュートリアル：デスクトッププラットフォーム上のマルチデバイスアプリケーションから FireDAC を使用する

1 FireDAC を使用してデータベースに接続する
2 ユーザーインターフェイスを設計しセットアップする
3 ［LiveBinding ウィザード］を使用する
- 3.1 LiveBinding コンポーネントを追加する
- 3.2 グリッドコンポーネントを追加する
4 実行時用にアプリケーションを準備する
5 アプリケーションを OS X に配置する
- 5.1 Interbase ToGo を OS X に配置する
- 5.2 OS X 上のデータベースファイルに接続するようコードを変更する
6 Windows および OS X 上でアプリケーションを実行する
7 関連項目

このチュートリアルでは、Windows や Mac で FireDAC フレームワークを使って、InterBase ToGo が管理するデータを閲覧するための基本手順を説明します。

ヒント： このチュートリアルを実行するには、IBToGo のライセンスが必要です。トライアル版を使用していて、Mac 上で InterBase をテストしたい場合には、トライアル期間中、IBToGo テスト配置ライセンスを使用することができます。配置トライアルライセンスを有効にするには、リンクをたどって InterBase ToGo 配置にアクセスしてください。。

FireDAC を使用してデータベースに接続する

FireDAC は、Delphi、C++Builder、FreePascal でクロスプラットフォームデータベースアプリケーションを開発するための他に類を見ない汎用データアクセスコンポーネント セットです。 FireDAC を使用すると、その強力な共通アーキテクチャのため、Delphi から InterBase、SQLite、MySQL、SQL Server、Oracle、PostgreSQL、IBM DB2、SQL Anywhere、Access、Firebird、Informix などに高速かつ直接にネイティブアクセスすることができます。

FireDAC InterBase ネイティブドライバでは、Embarcadero InterBase の Server、Desktop、Developer、ToGo の各エディションおよび IBLite のバージョン 6 以降をサポートしています。

Windows 上で Interbase ToGo が管理するデータを FireDAC を使って閲覧するには、以下の x86 または x64 クライアントソフトウェアがワークステーションにインストールされている必要があります。
- IBTOGO.DLL：組み込み型の InterBase ToGo または IBLite を使ったデータベースを x86 アプリケーションから操作するためのライブラリ
- IBTOGO64.DLL：組み込み型の InterBase ToGo または IBLite を使ったデータベースを x64 アプリケーションから操作するためのライブラリ
OS X 上で Interbase ToGo が管理するデータを FireDAC を使って閲覧するには、x86 組み込み型 InterBase の libibtogo.dylib が必要です。

ユーザーインターフェイスを設計しセットアップする

新規プロジェクトを作成します。 ［HD マルチデバイスアプリケーション］を選択します。

フォーム上に、TFDConnection コンポーネントをドロップします。
TFDConnection コンポーネントを右クリックし、［接続エディタ...］を選択します。
［FireDAC 接続エディタ］で、TFDConnection のパラメータを以下のように設定します。
1. Driver ID プロパティを IB に設定します。
2. Database パラメータを次のように設定します： C:\Users\Public\Documents\Embarcadero\Studio\20.0\Samples\Data\EMPLOYEE.GDB（データベースの場所）
3. ［User_Name］パラメータを sysdba に設定します。
4. Passwordパラメータを masterkey に設定します。
5. ［テスト］ボタンをクリックして、接続をテストします。
6. ［OK］をクリックして、［FireDAC 接続エディタ］を閉じます。
オブジェクトインスペクタで、TFDConnection のプロパティを次のように設定します。
1. LoginPrompt プロパティを False に設定して、ユーザーにログインを求めるプロンプトを表示しないようにします。
2. Connected プロパティを True に設定します。

［LiveBinding ウィザード］を使用する

［LiveBindings ウィザード］を使用して、LiveBindings コンポーネント（TBindSourceDB、TBindNavigator）や TFDQuery、Grid のコンポーネントを追加することができます。

LiveBinding コンポーネントを追加する

［表示｜LiveBinding デザイナ］を選択して［LiveBinding デザイナ］を開きます。
［LiveBindings ウィザード］（）を選択します。
ウィザードの［バインディングタスク］ページで［データソースの作成］を選択し、［次へ >>］をクリックします。
［データソース］ページで FireDAC を選択し、［次へ >>］をクリックします。
［コマンドタイプ］を Query に変更します。
［コマンドテキスト］プロパティを select * from employee に設定します。
［コマンドのテスト］ボタンをクリックします。
［次へ］ボタンをクリックします。
［データソースナビゲータを追加］を選択します。
［完了］ボタンをクリックします。

この時点で、TBindSourceDB、TBindNavigator、TFDQuery のコンポーネントがフォームに追加されました。

グリッドコンポーネントを追加する

LiveBindings デザイナを再度開きます。
［グリッドをデータソースとリンク］バインディングタスクを選択します。
［次へ］ボタンをクリックします。
TSringGrid を選択します。
［次へ］ボタンをクリックします。
BindSourceDB1 を選択します。
［完了］ボタンをクリックしてウィザードを閉じます。

この結果、バインディング図は次のようになります。

実行時用にアプリケーションを準備する

FireDAC は疎結合の多層アーキテクチャを備えており、各レイヤでサービスが提供されます。それぞれのサービス API は、他のレイヤからインターフェイスファクトリを使って要求できる COM インターフェイスとして定義されています。

FireDAC を適切に動作させるには、IFDGUIxWaitCursor インターフェイスと IFDPhysDriver インターフェイスの実装をアプリケーションにリンクする必要があります。

NavigatorBindSourceDB1 を選択し、Align プロパティを Top に設定します。
StringGridBindSourceDB1 を選択し、Align プロパティを Client に設定します。
TFDGUIxWaitCursor コンポーネントと TFDPhysIBDriverLink コンポーネントを、フォームにドロップします。

アプリケーションを OS X に配置する

ここまでは、デスクトップで InterBase を使用してきました。つまり、実際のデータベースは、ローカルのハードディスクドライブ上にあります（たとえば、C:\Users\Public\Documents\Embarcadero\Studio\20.0\Samples\Data\EMPLOYEES.GDB）。アプリケーションを OS X に配置するには、データベースファイルを Mac OS ファイルシステム（/Users/<ユーザー名>/EMPLOYEE.GDB など）にコピーする必要があります。また、Interbase ToGo ファイルも OS X に配置しなければなりません。

Interbase ToGo を OS X に配置する

［プロジェクト｜配置］を選択して、配置マネージャを開きます。
配置マネージャの上部にあるターゲットプラットフォームのドロップダウンリストから［すべての構成 - OS X プラットフォーム］を選択します。
［機能ファイルの追加］（）を選択します。
Interbase ToGo のデータベースモジュールを選択し、［OK］をクリックして［機能ファイル］ダイアログボックスを閉じます。
Embarcadero から ToGo 用に reg_nnnnnnn.txt というパターンのライセンスファイルを受け取っているかもしれません（nnnnnnn は生成された数値）。
- このファイルを reg_ibtogo.txt（C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2020 にあります）上に保存している場合には、必要なライセンスを選択するだけで構いません。
- ファイルを元の名前で保存している場合には、［ファイルの追加］を選択し、アプリケーションと一緒に配置する必要のあるファイルのリストにライセンスファイルを追加してください。

OS X 上のデータベースファイルに接続するようコードを変更する

前のステップで説明したように、TFDConnection コンポーネントは Windows 上のデータベースに接続されています。そのため、データベースに接続する前にファイルの場所を置き換える必要があります。手順は以下のとおりです。

フォームデザイナで FDConnection1 コンポーネントを選択します。
［オブジェクトインスペクタ］で BeforeConnect イベントの値のフィールドをダブルクリックします。
このイベントハンドラに次のコードを追加します。

Delphi：

procedure TForm9.FDConnection1BeforeConnect(Sender: TObject);
begin
{$IFDEF MACOS}
  FDConnection1.Params.Values['Database']:= '$(DOC)/EMPLOYEE.GDB';
{$ENDIF}
end;

C++Builder：

void __fastcall TForm9::FDConnection1BeforeConnect(TObject *Sender) {
#ifdef __MACOS__
 FDConnection1->Params->Values["Database"] = "$(DOC)/EMPLOYEE.GDB";
#endif
}

この {{(DOC) はパス変数で、パス式を簡単に記述するために役立ちます。 OS X では、}}(DOC) はユーザーのホームディレクトリ（/Users/<ユーザー名>）を示します。

Windows および OS X 上でアプリケーションを実行する

これでアプリケーションを実行する準備が整いました。 IDE 内で実行したときと同様に、データを参照することができるはずです。また、TBindNavigator コンポーネントを使ってデータベースのレコードを変更することもできます。

アプリケーションを実行するには：

プロジェクトマネージャで、ターゲットプラットフォームを選択します。
次のいずれかのコマンドを選択します：
- ［実行｜実行］
- ［実行｜デバッガを使わずに実行］

チュートリアル：デスクトッププラットフォーム上のマルチデバイスアプリケーションから FireDAC を使用する

目次

FireDAC を使用してデータベースに接続する

ユーザーインターフェイスを設計しセットアップする