モバイルチュートリアル：FireDAC で InterBase ToGo を使用する（iOS および Android）

モバイルチュートリアル：モバイルアプリケーション開発（iOS および Android）への移動

1 FireDAC を使用したデータベースへの接続
2 ユーザーインターフェイスの設計とセットアップ
3 データへの接続
4 アプリケーションのモバイルへの配置
- 4.1 InterBase ToGo に必要なファイルとデータベースファイルをモバイルに配置する
5 シミュレータまたはモバイルデバイス上でのアプリケーションの実行
6 トラブルシューティング
- 6.1 InterBase の問題
- 6.2 例外処理の問題
7 関連項目
- 7.1 サンプル

このチュートリアルを開始する前に、次のチュートリアルを読んで実行してください。

モバイルチュートリアル：LiveBinding を使用してリストビューの内容を設定する（iOS および Android）

ヒント： このチュートリアルを実行するには、IBToGo または IBLite のライセンスが必要です。

RAD Studio の以下のバージョンのいずれかを購入した場合は、IBLite の無制限開発および配置ライセンスのキーを電子メールで受け取っているはずです。
RAD Studio Sydney Professional 以上のすべてのエディション

Delphi Sydney Professional with Mobile 以上

評価ユーザーの場合、インストールファイルには、IBToGo のトライアルライセンスが含まれています。開発作業の中でテストライセンスを選択することで（このチュートリアルで説明します）、iOS および Android 上で InterBase をテストすることができます。トライアルライセンスは、トライアル製品と一緒に、C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2020 にインストールされます。

「IBLite および IBToGo のテスト配置ライセンス」の手順に従って、ライセンスファイルを取得し、インストールします。

メモ: Android デバイスでは、InterBase ToGo アプリケーションは特定の権限が設定される必要があります。特に下記です：

［外部ストレージの読み取り］（データベースが外部メモリに配置されている場合）
［外部ストレージへの書き込み］（データベースが外部メモリに配置されている場合）
［インターネット］（リモートサーバーに接続する必要がある場合）

このチュートリアルでは、FireDAC フレームワークを使って iOS および Android デバイス上で InterBase ToGo の管理するデータを参照する基本手順を説明します。

iOS	Android

メモ： FireDAC、dbExpress、Interbase Express（IBX）の各コンポーネントを使用して、Interbase ToGo アプリケーションをビルドすることができます。Delphi アプリケーションで Interbase Express コンポーネントを使用する方法の詳細は、「InterBase Express 入門」のトピックを参照してください。このチュートリアルでは、dbExpress フレームワークを使用して Interbase ToGo に接続します。

FireDAC を使用したデータベースへの接続

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

モバイルプラットフォームの場合、FireDAC では InterBase ToGo および SQLite をサポートしています。これらのデータベース製品は iOS および Android デバイス上で動かすことができます。

それ以外の Oracle などのデータベースでは、少なくともクライアントライブラリが必要です。Windows プラットフォームでは、クライアントライブラリは DLL として提供されていて、それに対して接続します。そのため、モバイルデバイスからこれらのデータベース製品に接続するには、DataSnap などの中間層技術を使ってアプリケーションを開発する必要があります。

モバイルデバイス上でクライアントライブラリを使用せずにエンタープライズデータベースに接続する方法は、別のチュートリアルで説明しています。「モバイルチュートリアル：モバイルクライアントからエンタープライズデータベースに接続する（iOS および Android）」を参照してください。

ユーザーインターフェイスの設計とセットアップ

このチュートリアルでは、TListView コンポーネントと TPanel コンポーネントを UI 要素として使用します。

以下の手順で ListView コンポーネントと Panel コンポーネントをセットアップします。

次のいずれかを選択して HD マルチデバイスアプリケーションを作成します。
- ［ファイル｜新規作成｜マルチデバイスアプリケーション - Delphi｜空のアプリケーション］
- ［ファイル｜新規作成｜マルチデバイスアプリケーション - C++Builder｜空のアプリケーション］
フォームに TListView コンポーネントをドロップします。
［オブジェクトインスペクタ］で、ListView の次のプロパティを設定します。
- Align プロパティを Client に設定して、リストビューコンポーネントがフォーム全体を占めるようにします。
- ItemAppearance を ListItemRightDetail に設定します。
- SearchVisible を true に設定します。
TPanel コンポーネントをフォームに追加し、［オブジェクトインスペクタ］で次のプロパティを設定します。
- TPanel コンポーネントの Align プロパティを Top に設定します。
TLabel コンポーネントをパネルに追加し、［オブジェクトインスペクタ］で次のプロパティを設定します。
- TLabel コンポーネントの Align プロパティを Client に設定します。
- Views を、iOS か Android に設定します。
- StyleLookup プロパティを listboxitemlabel に設定します。
- Views を Master に戻します。
- TextSettings の HorzAlign プロパティを Center に設定します。
- Text プロパティを「DB DEMO」に設定します。

データへの接続

FireDAC を使ってデータベース内のデータに接続する基本手順は以下のとおりです。

［ツールパレット］で TFDConnection コンポーネントをダブルクリックします。
TFDConnection コンポーネントを右クリックし、［接続エディタ...］を選択します。
［FireDAC 接続エディタ］で、TFDConnection のパラメータを次のように設定します。
1. ［ドライバ ID］プロパティを IB に設定します。
2. ［Database］パラメータを次のように設定します。
  C:\Users\Public\Documents\Embarcadero\Studio\21.0\Samples\Data\dbdemos.gdb（データベースの場所）
  
  ［開く］ダイアログボックスで目的のフォルダに移動し、［開く］をクリックします。
3. ［User_Name］パラメータを sysdba に設定します。
4. ［Password］パラメータを masterkey に設定します。
5. ［Protocol］パラメータを TCPIP に設定します。
6. ［テスト］ボタンをクリックして、接続をテストします。
7. ［OK］をクリックして、［FireDAC 接続エディタ］を閉じます。
［オブジェクトインスペクタ］で、TFDConnection のプロパティを次のように設定します。
1. LoginPrompt プロパティを False に設定して、ユーザーにログインを求めるプロンプトを表示しないようにします。
2. Connected プロパティを True に設定します。
  メモ： 開発環境でエラー（［unavailable database.］）が発生したら、それは現在 InterBase のライセンスがないことを示しています。一部の製品エディションでは、InterBase Developer Edition のライセンスが製品に含まれています。詳細は、「トラブルシューティング」を参照してください。
TFDQuery コンポーネントをフォームに追加します。
TFDQuery コンポーネントを右クリックし、［FireDAC クエリエディタ...］を選択します。
1. ［SQL コマンド］テキストエディタに「select COMMON_NAME, SPECIES_NAME from BIOLIFE order by COMMON_NAME」と記述します。
2. ［実行］ボタンをクリックして、コマンドの結果を確認します。
3. ［OK］をクリックして、［FireDAC クエリエディタ］を閉じます。
［オブジェクトインスペクタ］で、TFDQuery コンポーネントの Active プロパティを True に設定します。
［LiveBinding デザイナ］を開き、データとユーザーインターフェイスを次のように接続します。
1. FDQuery1 の COMMON_NAME をクリックし、マウスカーソルを ListView1 の Item.Text へとドラッグします。
  
  この時点で、TBindSourceDB コンポーネントと TBindingsList コンポーネントがフォームに追加されています。
2. BindSourceDB1 の SPECIES_NAME をクリックし、マウスカーソルを ListView1 の Item.Detail へとドラッグします。
TFDPhysIBDriverLink コンポーネントをフォームに追加します。
TFDGUIxWaitCursor コンポーネントをフォームに追加します。

メモ： 「FireDAC アプリケーションを実行時用に準備する」トピックでは、FireDAC アプリケーションにおける TFDGUIxWaitCursor コンポーネントと TFDPhysIBDriverLink コンポーネントの使用について説明しています。

アプリケーションのモバイルへの配置

ここまでは、デスクトップで InterBase を使用してきました。つまり、実際のデータベースは、ローカルのハードディスクドライブ上（ C:\Users\Public\Documents\Embarcadero\Studio\21.0\Samples\Data\dbdemos.gdb など）にあります。モバイルデバイスでは、アプリケーションはサンドボックス化されるため、通常はアプリケーションフォルダ下の Documents フォルダ（iOS デバイスの場合）および internal 記憶域（Android デバイスの場合）にあるデータしか読み書きできません。

モバイル上でローカルデータベースに接続するには、以下の作業を実施する必要があります。

データベースをモバイルデバイスに配置する。
（データベースファイルに接続するための）構成を、Documents フォルダ（iOS デバイスの場合）または internal 記憶域（Android デバイスの場合）のローカルファイルに変更する。

InterBase ToGo に必要なファイルとデータベースファイルをモバイルに配置する

モバイル上でアプリケーションを実行するには、以下のファイルを配置する必要があります。

Interbase ToGo に必要なファイル（ライセンスファイルとその他の構成ファイル）
データベースファイル（dbdemos.gdb）

次のようにして、これらのファイルをアプリケーションに配置します。

データベースは、次の 2 つの方法のいずれかでプロジェクトに追加することができます。
- ［プロジェクトマネージャ］でプロジェクト名を右クリックし、コンテキストメニューの［追加...］（または［プロジェクト｜プロジェクトに追加...］）を選択して、［プロジェクトに追加］ダイアログボックスを開きます。データベースのある場所 C:\Users\Public\Documents\Embarcadero\Studio\21.0\Samples\Data に移動し、データベース dbdemos.gdb を選択して、［開く］をクリックします。
- データベースのある場所 C:\Users\Public\Documents\Embarcadero\Studio\21.0\Samples\Data に移動し、データベース dbdemos.gdb を［プロジェクトマネージャ］内のプロジェクトにドラッグアンドドロップします。ファイルをプロジェクトに追加するかどうかを確認するダイアログボックスで［はい］をクリックします。
データベースファイルを追加すると、［機能ファイル］ウィンドウが開きます。［機能ファイル］で［InterBase ToGo］を選択し、［OK］をクリックして、［機能ファイル］ダイアログボックスを閉じます。
- ［InterBase ToGo］下のノードで、アプリケーションをデバイスに配置するときに使用するライセンスを選択する必要があります。
  - このチュートリアルの冒頭にあるヒントで、InterBase ライセンスを認証する方法について説明しています。
  - 使用可能なライセンスファイルの名前は、［機能ファイル］ダイアログに reg_*.txt というパターンの名前で一覧として提示されます。
    下の画像に示すように、このチュートリアルでは reg_ibtogo.txt というライセンスファイルを選択します。
  - Embarcadero から IBToGo または IBLite 用に reg_nnnnnnn.txt というパターンのライセンスファイルを受け取っているかもしれません（nnnnnnn は生成された数値）。
    - そのファイルを、reg_ibtogo.txt または reg_iblite.txt として、次の場所（例、C:\Users\Public\Documents\Embarcadero\InterBase\redist\InterBase2020）に保存している場合には、必要なライセンスを選択するだけで構いません。
    - ファイルを元の名前で保存している場合には、［ファイルの追加］を選択し（次のステップで説明します）、アプリケーションと一緒に配置する必要のあるファイルのリストにライセンスファイルを追加してください。
［プロジェクト｜配置］を選択して配置マネージャを開きます。
配置マネージャ上部のターゲットプラットフォームのドロップダウンリストで［Debug 構成 - iOS デバイス - 32 ビットプラットフォーム］、［Debug 構成 - iOS デバイス - 64 ビットプラットフォーム］、または［Debug 構成 - Android プラットフォーム］を選択し、データベース dbdemos.gdb がプラットフォームに追加されていることを確認します。
iOS プラットフォームと Android プラットフォームで、dbdemos.gdb の［リモートパス］がどのように設定されているかを確認します。
- iOS デバイスプラットフォームの［リモートパス］： StartUp\Documents\
- Android プラットフォームの［リモートパス］： assets\internal\

このように構成すると、モバイルデバイス上でアプリケーションを実行したときに、マルチデバイスアプリケーションのサンドボックス領域の Documents フォルダ（iOS プラットフォームの場合）または internal 記憶域（Android プラットフォームの場合）にデータベースファイル（dbdemos.gdb）を配置するよう、設定されます。

TFDConnection の場合、次のように BeforeConnect イベントハンドラを作成します。

フォームデザイナで TFDConnection コンポーネントを選択します。
［オブジェクトインスペクタ］で［イベント］タブに移動し、BeforeConnect イベントをダブルクリックします。

次のコードを追加して、BeforeConnect イベントのイベントハンドラを実装します。

Delphi の場合：

procedure TForm1.FDConnection1BeforeConnect(Sender: TObject);
begin
  {$IF DEFINED(iOS) or DEFINED(ANDROID)}
   FDConnection1.Params.Values['Protocol'] := 'Local';
   FDConnection1.Params.Values['Database'] :=  TPath.Combine(TPath.GetDocumentsPath, 'dbdemos.gdb');
  {$ENDIF}
end;

TPath レコードは System.IOUtils ユニットで宣言されているため、以下のコードのように uses 句に System.IOUtils を追加する必要があります。

implementation

{$R *.fmx}
{$R *.NmXhdpiPh.fmx ANDROID}
{$R *.iPhone4in.fmx IOS}

uses System.IOUtils;

procedure TForm1.FDConnection1BeforeConnect(Sender: TObject);
//  previous code goes here

C++ の場合：

void __fastcall TForm1::SQLConnection1BeforeConnect(TObject *Sender)
{
  #if defined(_PLAT_IOS) || defined(_PLAT_ANDROID)
      FDConnection1->Params->Values["Protocol"] = "Local";
      FDConnection1->Params->Values["Database"] = System::Ioutils::TPath::Combine(System::Ioutils::TPath::GetDocumentsPath(), "dbdemos.gdb");
  #endif
}

ユニット（.cpp ファイル）に #include <System.IOUtils.hpp> を追加する必要があります。

シミュレータまたはモバイルデバイス上でのアプリケーションの実行

これでアプリケーションを実行する準備が整いました（［実行｜実行］または F9 キーを押す）。IDE 内で実行したときと同様に、データを閲覧することができるはずです。検索ボックスを使用してリストを絞り込むこともできます。

iOS	Android

トラブルシューティング

InterBase の問題

InterBase ライセンスの問題の詳細については、次のセクションを参照してください。

メモ：「IBLite および IBToGo のテスト配置ライセンス」の手順で、有効なライセンスファイルを入手することができます。

例外処理の問題

アプリケーションで例外が発生して適切な例外処理コードがない場合、マルチデバイスアプリケーションは実行時にそのままクラッシュします（消えてしまいます）。

クラッシュが発生した場合、問題のトラブルシューティング時に手動でデータベースに接続することができます。手順は以下のとおりです。

FDConnection1 コンポーネントを選択し、Connected プロパティを False に変更します。

ボタンをフォームにドロップし、データベースに手動で接続するための次のようなイベントハンドラを作成します。

Delphi の場合：

procedure TForm1.Button1Click(Sender: TObject);
begin
  try
    FDConnection1.Connected := True;
    FDQuery1.Active := True;
  except
    on e: Exception do
    begin
      ShowMessage(e.Message);
    end;
  end;
end;

C++ の場合：

void __fastcall TForm1::Button1Click(TObject *Sender) {
    try {
        FDConnection1->Connected = true;
        FDQuery1->Active = true;
    }
    catch(Exception &e) {
        ShowMessage(e.Message);
    }
}

エラーメッセージをチェックします。

モバイルチュートリアル：FireDAC で InterBase ToGo を使用する（iOS および Android）

目次

FireDAC を使用したデータベースへの接続

ユーザーインターフェイスの設計とセットアップ

データへの接続

アプリケーションのモバイルへの配置

InterBase ToGo に必要なファイルとデータベースファイルをモバイルに配置する

シミュレータまたはモバイルデバイス上でのアプリケーションの実行

トラブルシューティング

InterBase の問題

例外処理の問題

関連項目

サンプル

案内メニュー

個人用ツール

名前空間

変種

表示

その他

検索

RAD Studio 10.4 Sydney

RAD Studio 10.4 トピック

他言語版

以前のバージョン

Assistance

ツール

モバイル チュートリアル：FireDAC で InterBase ToGo を使用する（iOS および Android）

目次

FireDAC を使用したデータベースへの接続

ユーザー インターフェイスの設計とセットアップ

データへの接続

アプリケーションのモバイルへの配置

InterBase ToGo に必要なファイルとデータベース ファイルをモバイルに配置する

シミュレータまたはモバイル デバイス上でのアプリケーションの実行

トラブルシューティング

InterBase の問題

例外処理の問題

関連項目

サンプル

案内メニュー

検索

モバイルチュートリアル：FireDAC で InterBase ToGo を使用する（iOS および Android）

ユーザーインターフェイスの設計とセットアップ

InterBase ToGo に必要なファイルとデータベースファイルをモバイルに配置する

シミュレータまたはモバイルデバイス上でのアプリケーションの実行