RAD Studio / Delphi / C++Builder 11 Alexandria スタートアップ FAQ

Last updated at 2023-12-12Posted at 2021-09-10

はじめに

・2021 年 9 月 10 日に RAD Studio / Delphi / C++Builder 11.0 Alexandria がリリースされました。
・2022 年 3 月 16 日に RAD Studio / Delphi / C++Builder 11.1 Alexandria がリリースされました。
・2022 年 7 月 15 日に RAD Studio / Delphi / C++Builder 11.1.5 Alexandria がリリースされました。
・2022 年 9 月 8 日に RAD Studio / Delphi / C++Builder 11.2 Alexandria がリリースされました。
・2023 年 2 月 28 日に RAD Studio / Delphi / C++Builder 11.3 Alexandria がリリースされました。
・2023 年 4 月 27 日に Delphi / C++Builder 11.3 Alexandria Community Edition がリリースされました。

インストール時のトラブルも出てきたようなのでまとめてみました。

※前バージョン (10.4 Sydney) のスタートアップ FAQ はこちらになります。

RAD Studio / Delphi / C++Builder 10.4 Sydney スタートアップ FAQ (Qiita)

FAQ

Q1: インストーラはどこから入手するの？

A1: アップデートサブスクリプション加入者はエンバカデロの登録製品ポータルから入手できます。

エンバカデロの 登録製品ポータル (Registered Products Portal) はこちらです。

■ アップデートサブスクリプション加入者

登録製品ポータルにログインしたら、左側の雲のアイコンをクリックすると My Downloads ページが開き、有効なライセンスの製品をダウンロードする事ができます。

■ Community Edition ユーザー

Community Edition をお使いの方は、Community Edition ダウンロードページへ行き、ダウンロードを行って新しいプロダクトキーを取得する必要があります。

何らかの障害でインストーラをダウンロードできなかった場合には、プロダクトキーが送られてきたメールに書かれているダウンロードリンク から Web インストーラ (ESD インストーラ) を再ダウンロードできます。

Community Edition ユーザーも登録製品ポータルを利用可能ですが、登録製品ポータルからダウンロードできるのはパッチ類のみとなります。

Community Edition は最終マイナーバージョン状態のものがリリースされるため、RTM 時に最新バージョンの Community Edition を入手する事はできません。

Q2: Web インストーラ (ESD インストーラ) とオフラインインストーラ (ISO) のどちらでインストールすべき？

A2: 回線状況がいいのなら Web インストーラが簡単です。

10.4 Sydney において、インストーラは統合されており、基本的にはどちらも同じインストーラ (ESD インストーラ) となっています。

但し、オフラインインストーラの場合、インストール後に以下の設定を行う必要があります。

■ Delphi (Enterprise 以上の SKU):

［ツール｜オプション｜Delphi オプション｜ライブラリ］で［64-bit Linux］を選択し、"参照パス" に以下を貼り付け。

$(BDS)\source\rtl\common;$(BDS)\source\rtl\sys;$(BDS)\source\rtl\linux;$(BDS)\source\ToolsAPI;$(BDS)\source\IBX;$(BDS)\source\Internet;$(BDS)\source\Property Editors;$(BDS)\source\soap;$(BDS)\source\xml;$(BDS)\source\Indy10\Core;$(BDS)\source\Indy10\system;$(BDS)\source\Indy10\Protocols;$(BDS)\source\fmx;$(BDS)\source\databinding\components;$(BDS)\source\databinding\engine;$(BDS)\source\databinding\graph;$(BDS)\source\data;$(BDS)\source\data\ado;$(BDS)\source\data\cloud;$(BDS)\source\data\datasnap;$(BDS)\source\data\dbx;$(BDS)\source\data\dsnap;$(BDS)\source\data\Test;$(BDS)\source\data\vclctrls;$(BDS)\source\rtl\posix;$(BDS)\source\rtl\posix\linux;$(BDS)\source\data\datasnap\connectors;$(BDS)\source\data\datasnap\proxygen;$(BDS)\source\DataExplorer;$(BDS)\source\Experts;$(BDS)\source\indy\abstraction;$(BDS)\source\indy\implementation;$(BDS)\source\indyimpl;$(BDS)\source\Property Editors\Indy10;$(BDS)\source\soap\wsdlimporter;$(BDS)\source\Visualizers;;$(BDS)\source\data\rest;$(BDS)\source\data\firedac;$(BDS)\source\tethering;$(BDS)\source\DUnitX;$(BDS)\source\data\ems;$(BDS)\source\rtl\net

■ C++Builder:

［ツール｜オプション｜C++ オプション｜パスとディレクトリ｜32 ビット Windows］の［コンパイラ］タブにある "システムインクルードパス" に以下を貼り付け。

$(BDSINCLUDE);$(BDSINCLUDE)\dinkumware64;$(BDSINCLUDE)\windows\crtl;$(BDSINCLUDE)\windows\sdk;$(BDSINCLUDE)\windows\rtl;$(BDSINCLUDE)\windows\vcl;$(BDSINCLUDE)\windows\fmx;$(BDSCOMMONDIR)\hpp\$(Platform)

Q3: インストールできる Windows は？

A3: 11 Alexandria がインストールできるのは Windows 10 以降です。

インストール時の警告を無視すれば Windows 7 / 8.x にも強制的にインストールする事はできますが、IDE の機能の幾つかに不具合が出るそうです。

32bit Windows 10 もサポート外です。

GetIt が動作しないため、パッチ等は手動でインストールする必要があります。

See also:

Q4: インストール先って変更できないの？以前のオフラインインストーラにはあったけど...

A4: インストール先は変更できますが、わかりづらいです。

インストーラの次の画面にある [オプション] ボタンを押します。

初期状態ではインストール先が C:\Program Files (x86)\Embarcadero\Studio\22.0 になっている (64bit OS の場合) ので、任意の場所に変更します。

ちょっとわかりづらいですね。

See also:

Q5: ISO からインストールすると GetIt に接続できないんだけど？

A5: パッケージマネージャをオンラインモードに切り替える必要があります？？？

以前のバージョンでは ISO からインストールした場合、GetIt で何かをインストールしようとするとエラーが発生するため、手動でオンラインモードに変更する必要がありました。

試した限り 11 Alexandria ではエラーが発生せず、モード変更の必要はなさそうなのですが、リリースノートにはこの一文が残っています。

オフラインインストーラを使用する場合、RAD Studio は、ユーザーが「オンラインモード」に手動で切り替えるまで、GetIt パッケージマネージャにアクセスすることができません。これを行うには、GetItCmd.exe ツールを使用することが推奨されます。

オンラインモードにするには次のコマンドを実行します。

GetItCmd.exe -c=useonline

オフラインモードにするには次のコマンドを実行します。

GetItCmd.exe -c=useoffline

GetItCmd.exe は <インストールフォルダ>\bin にあります。

気になる方はオンラインモード切替コマンドを実行しておきましょう。

See also:

Q6: インストール後にオプションで機能を追加したくなった。

A6: ［ツール｜プラットフォームの管理...］から[機能マネージャ] を呼び出します。

［ツール｜プラットフォームの管理...］から 機能マネージャ を開きます。

[追加オプション] タブがあるのをお忘れなく。

機能マネージャ (DocWiki)

Q7: ビルドすると Invalid PLATFORM variable ってエラーが出る。

A7: HP 製の PC で発生する事があります。

以下の記事に従って問題を解決してください。

特定のPC環境でビルドを行うと「Invalid PLATFORM variable ..」のエラーが発生する (Support Wiki)

Q8: 11 Alexandria をインストールしたら 10.4 Sydney の挙動がおかしい...というか OS の挙動がおかしい？

A8: 環境変数 PATH が長くなりすぎてはいませんか？

短くしましょう。

Q9: 以前のバージョンが ISO インストールできた環境に 11 Alexandria を ISO インストールしようとするとエラーになる。

A9: 要求されるストレージ量が大きくなっています。

一時的に倍近くのストレージ量を必要とします。このため、インストーラの容量チェックはパスするものの、実際にインストールしてみるとエラーになる事があります。製品やエディションにもよりますが、インストール前に 60GB 以上の空き容量を確保した方が無難でしょう。

Q10: ISO からインストールするとオンラインヘルプ (CHM) が古いのだけれど？

A10: オンラインヘルプが更新されていません。

機能マネージャを使って日本語オンラインヘルプを取得できます。［ツール｜プラットフォームの管理...］から 機能マネージャ を開き、

[追加オプション] タブで Help のチェックが入っている事を確認して [適用] ボタンを押します。

すると日本語のヘルプを取得します...が、10.4 Sydney のヘルプです。

日本語ヘルプが不要な方であっても、一度 [適用] ボタンを押してみるべきです。ESD のほうが新しいファイルになっている場合、新しいファイルを持ってくるからです。

■ 暫定的な解決方法

docs.embarcadero.com から必要なファイルをダウンロードします。

・メインヘルプ

アーカイブファイルを解凍し、次の場所に配置します。

アーカイブファイル	場所
Alexandria-CHM-en.zip	$(BDS)\Help\Doc
Alexandria-CHM-de.zip	$(BDS)\Help\Doc\de
Alexandria-CHM-fr.zip	$(BDS)\Help\Doc\fr
Alexandria-CHM-ja.zip	$(BDS)\Help\Doc\ja

アーカイブには

Alexandria-CHM-xx.chm (xx は en/de/fr/ja のいずれか)

が含まれていますので、topics.chm にリネームして各フォルダに上書きします。

・ライブラリヘルプ

アーカイブファイルを解凍し、次の場所に配置します。

アーカイブファイル	場所
Alexandria-Lib-en.zip	$(BDS)\Help\Doc
Alexandria-Lib-de.zip	$(BDS)\Help\Doc\de
Alexandria-Lib-fr.zip	$(BDS)\Help\Doc\fr
Alexandria-Lib-ja.zip	$(BDS)\Help\Doc\ja

アーカイブには

data.chm
fmx.chm
libraries.chm
system.chm
vcl.chm

が含まれていますので、各フォルダにそのまま上書きします。

レジストリ HKEY_CURRENT_USER\SOFTWARE\Embarcadero\BDS\22.0\Help\HtmlHelp1Files の内容とファイル名が一致しているか確認してください。値はデフォルトの場所にインストールされた場合です。

レジストリ名	値
IDE Topics Help	c:\Program Files (x86)\embarcadero\studio\22.0\help\Doc\topics.chm
IDE Data Help	c:\Program Files (x86)\embarcadero\studio\22.0\help\Doc\data.chm
IDE FireMonkey Help	c:\Program Files (x86)\embarcadero\studio\22.0\help\Doc\fmx.chm
IDE Libraries Help	c:\Program Files (x86)\embarcadero\studio\22.0\help\Doc\libraries.chm
IDE System Help	c:\Program Files (x86)\embarcadero\studio\22.0\help\Doc\system.chm
IDE Vcl Help	c:\Program Files (x86)\embarcadero\studio\22.0\help\Doc\vcl.chm

RAD Studio IDE の [ヘルプ | RAD Studio ヘルプ] から任意のヘルプを開きます。

BDSSetLang.exe で UI の言語を切り替えると、その言語のヘルプが表示されます。

これは不完全なヘルプファイルです。

この問題は 11.1 Alexandria で解決されています。

See also:

RSP-35355: An older version of the help file is provided (Quality Portal)

Q11: リボンコントロール (VCL) ってどこいったの？インストールオプションにもないんだけど？

A11: GetIt で取得できます。

ありますヨ！

See also:

Q12: Windows 7 にインストールした 11.0 Alexandria で GetIt パッケージマネージャが接続エラーになる。

A12: SSL/TLS 絡みです。回避方法があります (11.0 のみ)。

Windows 7 は最低でも SP1 が適用されている必要があります。大前提ですが、11 Alexandria IDE の動作環境は Windows 10 のみかつ 32bit OS もサポート外です。

オペレーティングシステムの要件 (DocWiki)

問題解決方法の詳細はこちらにあります。

Update to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows (microsoft)

■ 簡単な解決方法
上記ページの [Download] から MicrosoftEasyFix51044.msi をダウンロードして実行します。

ブラウザによってはダウンロードできないかもしれません。うまくダウンロードできない場合には他のブラウザを試してみてください (IE や Edge 等)。

■ レジストリエントリによる解決方法
次のファイルをダウンロードし、Explorer からダブルクリックして実行します。

Win7GetItFix.reg

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp]
"DefaultSecureProtocols"=dword:00000a80

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp]
"DefaultSecureProtocols"=dword:00000a80

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.1\Client]
"DisabledByDefault"=dword:00000000

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client]
"DisabledByDefault"=dword:00000000

Windows 7 が 32 bit の場合には WOW6432Node へのレジストリの追加は不要です。

Alexandria 11.1 の GetIt は TLS 1.3 を必要とするため、上記の解決方法は利用できないようです。Windows 7 / 8.x は TLS 1.3 をサポートしていません。

See also:

RSP-37822: Installation RAD Studio 11.1 does not work (Quality Portal)

Q13: 11 Alexandria のライセンスがないって言われるのだけれど？

A13: ライセンスマネージャで [更新] ボタンを押してみましょう。

XE8 以降の IDE をインストールされている方は、アンインストール前に付属のライセンスマネージャで [更新] ボタンを押してみましょう。

11 Alexandria のライセンスが追加されます。

それでもライセンスが追加されず、11 Alexandria がインストールできない事があるようです。

See also:

Q14: インストールが一向に進まないのだけれど？

A15: タスクバーに何かいませんか？

〔Alt〕+〔Tab〕でウィンドウを切り替えてみてください。インストーラー画面の裏にダイアログが回り込んでいる事があります。タスクバーに何かいたらポチポチと押して切り替えてみてください。

See also:

RSP-35311: Embarcadero Product Registration page displayed behind Setup RAD Studio 11 page (Quality Portal)

Q15: Visual Studio Code 連携でコード補完を使おうとするとライセンスがないって言われるのだけれど？

A15: ライセンスマネージャでもう一度 [更新] ボタンを押してみましょう。

これで問題が解決するハズです...が。

それでもライセンスがないって言われる事があるようです。

See also:

Q16: 11 Alexandria で生成された EXE が Windows XP で動作しないのですが？

A16: EXE の動作要件が Windows Vista 以降になっています。

PE ヘッダーの OS バージョンとサブシステムバージョンは Delphi / C++Builder 2009 以降、ずっと 5.0 (Windows 2000) のままだったのですが、Delphi / C++Builder 11 Alexandria において 6.0 (Windows Vista) に変更されました。これにより生成された EXE が Windows XP で動作しなくなっています。

11 Alexandria においてサポートされているターゲットプラットフォーム (Windows) は Windows 7 SP1 以降です。

Windows XP での動作が保証される最後のバージョンは Delphi XE2 です。

11.0 Alexandria Patch 1 において TThread.GetTickCount64 の処理が変更になったため、プロジェクトオプションで PE ヘッダーのバージョンを 5.0 に変更すれば XP / 2000 環境で動作させる事が可能になりました。

古いプログラムを最新の Delphi / C++Builder で継続的にメンテナンスしている場合には注意が必要です。

See also:

Q17: GetIt にある FastReport はインストールできないと聞きましたが？

A17: インストールしても特に問題はないようです。

以前はインストールするとエラーが出ていたようですが、現在では GetIt からインストールしても特に問題はなさそうです (VCL / FMX)。

See also:

Q18: 移行ツールで 11.0 の環境を 11.1 へ移行したら起動時にエラーが出るんですけど？

A18: ウェルカムページのレイアウトを変更していませんでしたか？

11.0 でウェルカムページのレイアウトを変更していた場合、移行ツールで移行する事で 「拡張スタイルが固定の場合、列や行は追加できません。」というエラーが IDE 起動時に発生します。

移行する際に、[WelcomePage] を除外する事でこの問題を回避できます。

もうすでにやらかしてしまった場合には、ウェルカムページ左下の [レイアウトを編集] をクリックし、

レイアウトエディタの左下にある [デフォルトレイアウトに戻す] を押してください。

このまま IDE を閉じて、再度 IDE を開いてみてください。レイアウトが若干おかしいかもしれませんが、起動時のエラーはなくなったハズです。エラーが出ないことを確認できたら、もう一度ウェルカムページのレイアウトエディタでお好きなレイアウトに変更してみてください。

Q19: Windows 64bit ビルドを実行すると、例外処理で捕捉できないランタイムエラーが発生するのだけれど？

A19: 高エントロピー 64 ビットアドレス空間レイアウトのランダム化 (ASLR) のサポートをオフにしてビルドしてみてください。

11.2 以降で比較的大きな 64bit アプリケーションをビルドすると、例外処理で捕捉できないランタイムエラーが発生する事があります。詳細は不明ですが、回避方法はあります。

[プロジェクトオプション] を開き、[ビルド > Delphi コンパイラ > リンク] と辿り、[ターゲット] で すべての構成 - Windows 64 ビットプラットフォーム を選択します。高エントロピー 64 ビットアドレス空間レイアウトのランダム化 (ASLR) のサポート のチェックが入っていると思うので、チェックを外して False にします。

念のため、[ターゲット] で Debug / Release の Windows 64bit も確認してください。チェックを外し終わったら、ビルドして動作確認を行います。

See also:

RSP-39467 Access violations with 64bit builds (Quality Portal)

Q20: RDP (Remote Deesktop) 環境で IDE が落ちる！

A20: デスクトップの配置を "デフォルトレイアウト" に戻してみてください。

[表示 | デスクトップの配置 | デフォルトレイアウト] で戻せます。

デフォルトレイアウトを上書きしてしまった場合には、IDE を閉じた状態で <インストールフォルダ>\bin にある Default Layout.dst を %APPDATA%\Embarcadero\BDS\22.0 に上書きコピーしてください。

(RDP 環境に限らず) IDE が落ちて困っている方は "デフォルトレイアウト" の使用を試みてください。

See also:

Q21: IDE 起動時に "パーソナリティ 'Default.Personality' はサポートされていません." が出て何もできなくなる

A21: ウェルカムページが破損している可能性があります。

IDE を起動すると、"パーソナリティ 'Default.Personality' はサポートされていません." が出て何もできなくなる事があります。

タスクマネージャで BDS.EXE を終了させ、もう一度 IDE を起動してみます。

引き続きエラーが出るようなら、ショートカットに -np を付けて起動します。こうする事で起動時のウェルカムページを表示させなくする事ができます。

起動後に [表示 | ウェルカムページ] でウェルカムページを表示させます。

ウェルカムページ左下の レイアウトを編集 を押してレイアウトエディタを開き、

[デフォルトレイアウトに戻す] ボタンを押すか、GetIt 関連のプラグインを削除してみてください。

[GetIt での新情報] の左にある ⊖ ボタンを押すと行を削除できます。

Q18 に注意してください。

See also:

RSP-37975 Default.Personality is not supported (Quality Portal)

おわりに

とにかくまずはインストールノートとリリースノートをよく読んでください。

その上でなのですが、英語版のリリースノートには日本語版に書かれていない重要な情報がありますので、こちらにもちゃんと目を通すことをオススメします。

情報入手元

FAQ の主な情報入手元です。

サイト	説明
Embarcadero Technologies Home	製品情報があります。
無料版	Community Edition がダウンロードできます。
メンバーサービス	アカウントを管理します。
登録製品ポータル	登録されている製品を管理します。
メンテナンスデリバリーポータル	アップデートサブスクリプションを管理します。
Embarcadero ブログ	ブログです。
開発ツールコミュニティ	フォーラムです。
品質ポータル	バグトラッカーです。
Embarcadero DocWiki	製品のオンラインドキュメントです。
Embarcadero Support Wiki	製品のサポートドキュメントです。

See also:

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up