リリースノート

新機能への移動

このリリースノートには、主な製品ドキュメントに含まれていない可能性のある重要な情報が記載されています。このページのすべての内容に目を通されることをお勧めします。

1 RAD Studio のインストール、アンインストール、アップブレード
2 以前のバージョンと移行
3 GetIt インストーラ - オペレーションエラー
4 Linux
5 FireMonkey
- 5.1 フォームデザイナで新規ビューの作成前にすべてのコンポーネントに名前を割り当てる必要あり
- 5.2 デバイス上で iOS アプリケーションをデバッグなしで実行したあと正常に閉じる/開き直すことができないおそれあり
6 FireDAC
- 6.1 実行時パッケージと C++ FireDAC DataSnap ドライバの併用
- 6.2 FireDAC コンポーネントを使用する 64 ビット Windows C++ アプリケーションでエラーが発生するおそれあり
7 データベースデータベース
- 7.1 データセットの再設定
8 Android
- 8.1 JDK パスの問題
9 C++ ツールチェーン
10 IDE
11 InterBase
- 11.1 Appmethod RAD Studio 10.2 Tokyo の一部のエディションに InterBase XE7 エディションが付属している
  - 11.1.1 InterBase のライセンスエラーの回避策
12 外部ソフトウェア
13 関連項目

RAD Studio のインストール、アンインストール、アップブレード

本製品のインストール、アンインストール、アップグレードの前には、選択した言語の次のファイルをお読みください。

radstudio_install_xx.htm：インストールとアップグレードの手順に加えて、システム要件が記載されています。
radstudio_license_xx.rtf：ソフトウェア使用許諾およびサポート契約書が含まれています。
radstudio_deploy_xx.htm：配置に関する情報が含まれています。

radstudio_install_xx.htm ファイルの最新版は、以下の場所でお読みになれます。

インストールノート
インストールディレクトリ。デフォルトでは C:\Program Files (x86)\Embarcadero\Studio\19.0 にあります。

以前のバージョンと移行

以前のバージョンのライセンスが RAD Studio に同梱

10.2 Tokyo ライセンスには、次に示す以前の製品バージョンが含まれています。

Delphi 10.2 Tokyo は、Delphi Berlin、Seattle、XE8、XE7、XE6、XE5、XE4、XE3、XE2、XE、2010、2009、2007 および 7 の各ライセンスを含みます。
C++Builder 10.2 Tokyo は C++Builder Berlin、Seattle、XE8、XE7、XE6、XE5、XE4、XE3、XE2、XE、2010、2009、2007 および 6 の各ライセンスを含みます。

ライセンスについての詳細は、RAD Studio インストールディレクトリにある radstudio_license_xx.rtf ファイルを参照してください。

Opening Projects Upgrades Them

以前のバージョンの RAD Studio で作成されたプロジェクトを、RAD Studio 10.2 Tokyo で開くと、RAD Studio はそのプロジェクトをアップグレードさせます。アップグレードされたプロジェクトは、それ以降、以前のバージョンの RAD Studio では動作しません。

新しいバージョンの RAD Studio でプロジェクトを開く場合には、その前にプロジェクトのバックアップを常に作成してください。

Delphi 7 からのアップグレード

Delphi 7 などの初期リリースで作成されたプロジェクトをアップグレードしようとしていて、そのプロジェクトにカスタムファイル拡張子が付いている場合は、［プロジェクト｜オプション...｜アプリケーション］を選択し、［ターゲットファイル拡張子］をプロジェクトの種類（.exe、.dll、.bpl のいずれか）に合わせて設定する必要があります。

GetIt インストーラ - オペレーションエラー

10.2 Tokyo をインストールするために GetIt 機能インストーラを使用している際に、オペレーションエラーに陥った場合、C:\Users\Public\Documents\Embarcadero\Studio\19.0\CatalogRepository を、C:\Users\Public\Documents\Embarcadero\Studio\19.0\Old_CatalogRepository に名前変更してください。

Linux

Apache バージョンの要件

Delphi for Linux は Apache 2.4 をサポートしています。Version 2.2 はサポートされていません。

WebBroker Apache サポート

WebBroker ウィザードは、Windows に適用する Apache モジュールをインストールするための手引きと共にプロジェクトを生成しますが、これは、Linux インストールに対しては正しいものではありません。

生成される Windows での手順（Linux では正しくない点）

LoadModule webbroker_module modules/mod_webbroker.dll

<Location /xyz> 
SetHandler mod_webbroker-handler 
</Location>

Linux での手順

LoadModule webbroker_module modules/libmod_webbroker.so

<Location /xyz> 
SetHandler libmod_webbroker-handler 
</Location>

誤った PAServer エラーメッセージが Ubuntu Server 16.04 LTS で表示される

［実行｜パラメータ］ダイアログでの ［ランチャアプリケーションを使用する］ を使用して、xterm を、Linux がターゲットの場合の、デフォルトのランチャーアプリケーションとします。PAServer を Ubuntu Server 16.04 LS 上で実行する際、ファイルが作成できない旨を伝えるエラーメッセージが表示されます。xterm を希望する Ubuntu Server 16.04 LTS 上で起動できないのが問題であるため、このエラーメッセージは正しくありません。Xterm は別にインストールでき、Ubuntu のクライアントディストリビューションの一部です。

FireMonkey

フォームデザイナで新規ビューの作成前にすべてのコンポーネントに名前を割り当てる必要あり

古い FireMonkey アプリケーションを 10.2 Tokyo で開く場合、次のエラーメッセージが出力されるおそれがあります。

 Cannot inherit from form 'FormName".  It contains a component with a blank name property.

新しいビュー継承システムでは、フォームデザイナで新規ビューを作成するには、まず、すべてのコンポーネントに名前を割り当てる必要があります。

デバイス上で iOS アプリケーションをデバッグなしで実行したあと正常に閉じる/開き直すことができないおそれあり

デバイス上で iOS アプリケーションをデバッグなしで実行したあと、デバイス上でアプリケーションのプロセスを強制終了した場合は、IDE の外部でプロセスを実行するのであれば、PAServer のリセットコマンドを実行する必要があります。それには、PAServer のコマンドプロンプトで「r」と入力します。

FireDAC

実行時パッケージと C++ FireDAC DataSnap ドライバの併用

実行時パッケージを使ってビルドした 64 ビット C++ アプリケーションで FireDAC DataSnap ドライバを使用する場合は、実行時にエラーが発生するおそれがあります。このエラーを避けるには、以下の手順に従って、DataSnapClient を実行時パッケージに追加する必要があります。

［プロジェクト｜オプション...｜パッケージ｜実行時パッケージ］を選択します。
［実行時パッケージインポートライブラリ］フィールドで、DataSnapClient をリストに追加します。

この設定で問題は解決され、DataSnapClient.a ではなく DataSnapClient.bpi がリンク行に追加されます。

FireDAC コンポーネントを使用する 64 ビット Windows C++ アプリケーションでエラーが発生するおそれあり

静的リンクを使用する Windows x64 をプラットフォームとする場合は、FireDAC コンポーネントを 1 つ使用するアプリケーションをコンパイルしようとすると、以下のエラーが発生します。

c:\program files (x86)\embarcadero\studio\<n.n>\Bin\CodeGear.Cpp.Targets : warning : Warning: Out of memory
c:\program files (x86)\embarcadero\studio\<n.n>\Bin\CodeGear.Cpp.Targets(2751,5): error MSB6006: "ilink32" exited with code 2.

回避策は、FireDAC を Win64 C++ アプリケーションにおいて静的にリンクしないことです。

データベースデータベース

データセットの再設定

バインドした TClientDataSet や TFDMemTable を再設定することは、初期時より遅くなる可能性があります。この問題を回避するため、新しい EmptyDataLink メソッドを TBindSourceDB に追加しました。

Android

JDK パスの問題

Java 開発キット（JDK）のバグが原因で、Android ターゲットプラットフォーム向けプロジェクトの配置パスに非 ASCII 文字を含めることはできません。

C++ ツールチェーン

OS X アプリケーションにおける DWORD または ULONG の多重宣言の解消

OS X ターゲットプラットフォーム向けにコンパイルされるマルチデバイスアプリケーションの場合、E2238 エラーが発生するおそれがあるのは、OS X ヘッダー iodbcunix.h および sqltypes.h に DWORD と ULONG の typedef 文が宣言されているためと、C++Builder の sysmac.h ファイル（System.hpp でインクルードされている）にも同様の typedef 文が宣言されているためです。回避策については、E2238 を参照してください。

C++ パッケージ内のコンポーネントを使用する際の依存パッケージおよび必須パッケージの指定

C++ パッケージ内の既存コンポーネントを使用する際、IDE では、そのコンポーネントの依存（必須）パッケージを自動的には追加しません。このステップは手動で実行する必要があります。

関連する依存（必須）パッケージがなければ、そのコンポーネントの使用時に初期化する必要がある .obj ファイルをリンカが見つけられないため、C++ パッケージはリンクできないおそれがあります。このようなリンカエラーを避けるには、コンポーネントのパッケージとその依存パッケージを（［プロジェクトマネージャ］内の）C++ パッケージの［Requires］ノードに追加する必要があります。

次の例では、コンポーネントの必須パッケージを割り出し、そのコンポーネントを使用するダミーの VCL フォームアプリケーションを作成することにより "xxx.obj を開けません" というリンカエラーを解消する方法を示しています。

デフォルトでは、次のリンカコマンドライン（［表示｜メッセージ］でビューを表示）で指定されている *.bpi ファイルからもわかるように、新規に作成される C++ マルチデバイスアプリケーションでは .rtl パッケージおよび .fmx パッケージとリンクします。

ilink32 コマンドライン：

 c:\BDSLoc\bin\ilink32.exe ... -aa -V5.0 -Tpe  c0wfmx32w rtl.bpi fmx.bpi memmgr.lib sysinit.obj .\Win32\Debug\Project30.obj .\Win32\Debug\Unit26.obj , .\Win32\Debug\Project30.exe , .\Win32\Debug\Project30.map , import32.lib cp32mti.lib , , Project30.res

新しいコンポーネントを追加すると、IDE が依存パッケージを推定し、リンカコマンドラインを調整します。このことを確認するため、C++ パッケージ内の使用コンポーネントをマルチデバイスフォームに追加します。この例では、TFDSchemaAdapter コンポーネントを使用します。では、アプリケーションを再ビルドします。新しい .bpi ファイルがいくつかリンカコマンドラインに追加されたことがわかります。

ilink32 コマンドライン：

 c:\BDSLoc\bin\ilink32.exe ... -aa -V5.0 -Tpe  c0w32w rtl.bpi fmx.bpi FireDACCommonDriver.bpi FireDACCommon.bpi xmlrtl.bpi dbrtl.bpi FireDAC.bpi FireDACSqliteDriver.bpi memmgr.lib sysinit.obj .\Win32\Debug\Project30.obj .\Win32\Debug\Unit26.obj , .\Win32\Debug\Project30.exe , .\Win32\Debug\Project30.map , import32.lib cp32mti.lib , , Project30.res

これらの新しい .bpi ファイルが、お使いのコンポーネントの依存パッケージです。TFDSchemaAdapter の場合は、次の .bpi ファイルがそれに当たります。

   FireDACCommonDriver.bpi FireDACCommon.bpi xmlrtl.bpi dbrtl.bpi FireDAC.bpi FireDACSqliteDriver.bpi

そのため、C++ パッケージ内の TFDSchemaAdapter コンポーネントを使用するには、IDE でこれらの bpi ファイルをそれぞれ '必須' 参照として明示的に追加する必要があります（「パッケージ（Delphi）」を参照）。

DirectX ヘッダーファイルのダウンロード

Microsoft Windows Platform SDK 内の DirectX ヘッダーのみ付属しています。"d3d.h ファイルが見つかりません" などのエラーが発生した場合、その Delphi ユニット用に生成された HPP には #include <D3D*.hpp> が含まれています。以下のいずれかを行うことができます。

D3D ユニットを使用しているユニットに {$NOINCLUDE Winapi.D3DX9} 指令を追加し、そのユニットの HPP ファイルを生成し直します。再生成された HPP には #include <Winapi.D3DX9.hpp> が含まれていません。
D3D ヘッダーの基になっている DirectX SDK をダウンロードします。DirectX SDK は、Microsoft 社から無償でダウンロードできます。詳細については、「DirectX SDK の場所（Windows）」（英語版）を参照してください。

5～8 バイトの構造体またはセットをパラメータに取るイベントは BCC64 では無効

IDE で生成されるイベントのうち、5 ～ 8 バイトの構造体またはセットをパラメータに取るものは、32 ビット C++ では有効ですが、64 ビット C++ では無効です。これは、型が値で渡される場合にのみ影響します。型が参照で渡される場合は、Win32 と Win64 で違いはありません。

たとえば、OnContextPopup イベントの TPoint &MousePos パラメータにアクセスすると、アクセス違反が発生します。これは、Win64 プラットフォームでは TPoint &MousePos パラメータが無効だからです。__closure 型宣言に注目すると、Win32 と Win64 で違いがあることがわかります。TControl の PopupMenu イベントの __closure 宣言を以下に示します。

#ifndef _WIN64
typedef void __fastcall (__closure *TContextPopupEvent)(System::TObject* Sender, const System::Types::TPoint &MousePos, bool &Handled);
#else /* _WIN64 */
typedef void __fastcall (__closure *TContextPopupEvent)(System::TObject* Sender, System::Types::TPoint MousePos, bool &Handled);
#endif /* _WIN64 */

Win64 でも Win32 でもコードが動作するためには、IDE で生成されるハンドラを、以下のように条件指令を使って宣言する必要があります。

#ifndef _WIN64
void __fastcall TForm46::FormContextPopup(TObject *Sender, TPoint &MousePos, bool &Handled)
#else
void __fastcall TForm46::FormContextPopup(TObject *Sender, TPoint MousePos, bool &Handled)
#endif
{
  ShowMessage(System::String().sprintf(L"Mouse at (%d,%d)", MousePos.X, MousePos.Y));
}

IDE

マルチデバイスフォームデザイナではマスタビューからのみコンポーネントを削除可能

別のビュー（［マスタ］ビュー以外）からコンポーネント（たとえば TButton など）を削除しようとすると、次のエラーメッセージが表示されます。

 Selection contains a component, Button1, introduced in an ancestor and cannot be deleted

この問題を解決するには、コンポーネントの削除を［マスタ］ビューで行います。ビューの詳細については、「フォームデザイナ」を参照してください。

名前を変更した iOS プロジェクトは実行時またはデバッグ時に失敗するおそれあり

IDE でプロジェクトの名前を変更すると、iOS アプリケーションが実行時やデバッグ時に失敗するおそれがあります。この問題を解決するには、以下を行います。

［プロジェクト｜配置］を選択します。
配置マネージャで、［デフォルトに戻す］スピードボタンをクリックします。

バージョン情報設定の継承

Windows をターゲットとするプロジェクトにバージョン情報を組み込むには、［すべてのプラットフォーム］ターゲットでのキー値を変更するのではなく、代わりに各プラットフォーム（32 ビットおよび 64 ビット）向けに値を個別に変更します。個々のターゲットでは、［すべてのプラットフォーム］ターゲットから値を正しく継承しません。

InterBase

Appmethod RAD Studio 10.2 Tokyo の一部のエディションに InterBase XE7 エディションが付属している

この注意事項は、RAD Studio の旧バージョンと RAD Studio 10.2 Tokyo の両方が同じマシンにインストールされているユーザーを対象としたものです。この注意事項では RAD Studio に言及していますが、Delphi と C++Builder のエディションも言外に含まれています。

RAD Studio の各バージョンには、InterBase のバージョンのライセンスも含まれています。

製品	InterBase バージョン
RAD Studio XE3	InterBase XE3 Developer エディション
RAD Studio XE4	InterBase XE3 Developer エディション
RAD Studio XE5	InterBase XE3 Developer エディション
RAD Studio XE6	InterBase XE3 Developer エディション
RAD Studio XE7	InterBase XE3 Developer エディション
RAD Studio XE8	InterBase XE7
RAD Studio Seattle	InterBase XE7
RAD Studio Berlin	InterBase XE7
RAD Studio Tokyo	InterBase XE7

これらの RAD Studio ライセンススイートはすべてシステム全体で参照できるので、使用できる InterBase のライセンスは常に 1 つだけです。

たとえば、RAD Studio XE6 に付属していた "InterBase XE3 Developer エディション"を実行している場合は、RAD Studio XE7 に付属している "InterBase XE3 Developer エディション" のインスタンスを同時に起動することはできません。また、RAD Studio 10.2 Tokyo に付属している "InterBase XE7 エディション" のインスタンスを同時に起動することもできません。このインスタンスを起動しようとした場合は、"InterBase のライセンスエラー" であることを通知するエラーダイアログが表示されます。InterBase のログを調べれば、"Registration file error: License is in use by another instance of InterBase"（登録ファイルエラー: ライセンスは別の InterBase インスタンスで使用中）と記載されています。

InterBase の複数のインスタンス実行についての詳細は、http://docs.embarcadero.com/products/interbase/IBXE7/OpGuide.pdf の「マルチインスタンス」セクションを参照してください。

InterBase のライセンスエラーの回避策

InterBase のインスタンスをすべて停止します。
このインスタンスを Windows サービスとしてセットアップしてある場合は、それをシステムの［サービス］コントロールパネルでも無効にしてください。
使用したい InterBase のインスタンスを起動します。今度は、適切なライセンスで正常に起動します。

RAD Studio の上記の旧バージョンとそれらでビルドされたアプリケーションは、RAD Studio 10.2 Tokyo と一緒にインストールされる、InterBase XE7 の更新版とも連携できます。以前の IDE ツールおよびアプリケーションについては、この InterBase インスタンスへの TCP ループバックを通じて、お使いのデータベースに接続させます。例：

localhost/gds_db:<dbpath>

RAD Studio の以前のバージョンでは、［ツール｜オプション...｜環境オプション｜環境変数］を選択し、ローカルクライアント接続を行うための以下の［ユーザー定義環境変数］エントリを新しく追加してもよいでしょう。

変数	値
`IB_Protocol`	`gds_db`
`InterBase`	`C:\Program Files (x86)\Embarcadero\Studio\19.0\InterBaseXE7`

外部ソフトウェア

Yandex Punto Switcher などのサードパーティ製キーボード切り替えツールが組み込まれている環境でデバッグされたアプリケーションの場合、問題が発生する可能性があります。Windows によりアプリケーションが終了し、アプリケーションでアクセス違反エラーが発生した場合、このアクセス違反エラーは無視してください。

リリース ノート

目次