1.0 ワークベンチの起動
1.1 拡張起動トピック
1.2 ワークスペースのロケーションをワークベンチのタイトル・バーに表示する
1.3 バージョン 5.0 ワークスペースで WebSphere Studio バージョン 5.1 を使用する
2.0 ワークベンチに関する既知の問題
2.1 ワークベンチの外部でファイルを変更した場合には手作業による最新表示が必要
2.2 Windows における問題: OLE 文書の使用
2.2.1 OLE 文書でダーティー状態が適切に追跡されない
2.2.2 OLE 文書が
破壊されると WebSphereR Studio が突然終了する
2.3 ユーザー・インターフェースが応答しない
2.4 タスク・リストからの項目のコピー
2.5 DBCS フォントの問題
2.6 マイグレーション済みワークスペースのパースペクティブを復元すると、エラーになることがある
2.7 最小の表示解像度
2.8 外部ツールが、スペースを含むパス変数に自動的に引用符を付ける
2.9 デフォルトのテキスト・ファイル・エンコードが間違って検出されることがある (Windows XP/2000 のみ)
2.10 複数ページ・エディターでのツールバーの更新
2.11 アラビア語キーボード・レイアウトで、いくつかのショートカット・キーが機能しない
2.12 別の WebSphere Studio システムから設定をインポートする場合は、クラスパス変数をリセットする必要がある
2.13 単純プロジェクト作成はリソース・パースペクティブをオープンする必要がある
2.14 リンクされたリソースおよび複数の出力フォルダー
2.15 AbstractTextEditor およびサブクラスに対して上書きモードを使用不可にできない
2.16 大規模なプロジェクトとファイルの処理
3.0 エディターに関する既知の問題
3.1 マーカーが適切に除去されない
3.2 デフォルトの HTML および JSP エディターが双方向言語をサポートしていない
4.0 異なる VM 上での実行
4.1 J9 上での実行
5.0 utc.dll が原因のプログラム・エラー
6.0 Ant
6.1
外部ツール設定ページ上の「優先出力レベル」が Ant に対して有効にならない
6.2
外部ツールの Ant UI がどのような場合でも ENTITY 項目を処理しない
6.3
ランタイム Ant クラスパスで Xerces JARs が不要になった
6.4 カスタム Ant タスクと Ant 型をプラグイン・ライブラリー JAR から分離する必要がある
6.5 並行 Ant ビルドはサポートされない
6.6 特定の Ant タスクを実行するとメモリー・リークが発生する
6.7 入力が必要なタスクがワークスペースをロックする
6.8 Ant 1.5 に基づく Ant エディターの完了
インストール後、インストール・ディレクトリーの最上位にある実行可能プログラムを実行するとワークベンチが開始されます。
デフォルトで、ワークベンチは workspace と呼ばれるディレクトリーを作成します。 このディレクトリーは、プロジェクトのデフォルトのコンテンツ領域、 および必要とされるメタデータを保持するデフォルトのコンテンツ領域として使われます。 共有のまたは複数ワークスペースのシステムについては、 デフォルトを使うのではなく、ワークスペースの場所を明示的に指示すべきです。 ワークスペースの場所を制御するには 2 つの方法があり、現行の作業ディレクトリーを使うか、または -data コマンド行引き数を使います。
現行の作業ディレクトリーを使う一番簡単な方法は、以下のステップに従ってショートカットを作成することです。
他の方法としては、-data 引き数 (例: -data c:\myworkspace) をショートカットの「リンク先 (Target)」行に追加したり、コマンド・プロンプトからプログラムを開始して -data 引き数を指定したりする方法があります。
WebSphere Studio は、%#<>"!. などの無効な文字を含むパスを持つディレクトリーにインストールされた場合、起動に失敗します。
Eclipse (WebSphere Studio がビルドされているプラットフォーム) は、プラグインの開発やデバッグをする人のため、数多くの興味深い実行可能オプションを提供しています。実行可能プログラムの一般的な書式は以下のとおりです。
platform [platform options] [-vmargs [Java VM arguments]]
ここで、platform は、 インストール・ディレクトリーのトップレベルのディレクトリーにある実行可能ファイルの名前であり、 有効なプラットフォーム・オプションは次のとおりです。
-application <app id> | 実行するアプリケーションを識別します。 指定がないと、ワークベンチが実行されます。 アプリケーションは、org.eclipse.core.runtime.applications 拡張ポイントに 拡張機能を提供しているプラグインによって宣言されます。 |
-boot <boot code path> | ブート・プラグイン・コード (boot.jar) へのパスを定義します。 startup.jar および boot.jar の相対ロケーションを変更する場合にのみ必要です。 |
-consolelog | プラットフォームのエラー・ログを、 プラットフォームの実行に使用されるコンソールにミラーリングします。 |
-data <workspace path> | プラットフォームが実行されるワークスペースのパスを定義します。 |
-debug [options file path] | プラットフォームをデバッグ・モードにし、 指定されたファイル内のデバッグ・オプションをロードします。 ファイル・パスが指定されていない場合、 プラットフォームは、プラットフォームのインストール・ディレクトリーとワークスペースの メタデータ・ディレクトリー内で、.options というファイルを探します。 |
-dev [classpath entries] | プラットフォームを開発モードにします。 オプションのクラスパス項目 (コンマで区切られたリスト) が各プラグインのクラスパスに追加されます。 たとえば、プラグインを開発するとき、各プラグインごとに -dev bin を使用して JavaTM ツールの bin ディレクトリーを追加します。 冗長なクラスパス項目または存在しないクラスパス項目が除去されます。 |
-nosplash | スプラッシュ・スクリーンを表示せずにプラットフォームを実行します。 |
-os <os-id> | プラットフォームを実行するオペレーティング・システムを定義します。 通常、プラットフォームは OS を検出できますが、状態によっては明示的な指定が必要な場合もあります。 ここで指定する値は Platform.getOS() に関連したものです。 |
-vm <vm path> | プラットフォームの実行に使用する Java VM を指定します。 指定されなかった場合、Java VM は実行可能ファイルから相対的に位置指定されます。 |
-ws <ws-id> | プラットフォームを実行するウィンドウ・システムを定義します。 多くの場合、プラットフォームはウィンドウ・システムを検出できますが、状態によっては明示的な指定が必要な場合もあります。 ここで指定する値は Platform.getWS() に関連したものです。 |
すべての -vmargs 項目に続く引き数 (この引き数自体は含まれない) は、 指定された Java VM に仮想マシン引き数として (クラスが実行する前に) 直接渡されます。 すべての -vmargs 項目に先行する引き数 (-vm と -nosplash を除く) は、解釈のためプラットフォームに直接渡されます。
ワークスペースのロケーションをワークベンチのタイトル・バーに表示したいときは、以下のコマンドを使って WebSphere Studio を開始してください。
WS_installdir\wasexpress.exe -showlocation -data c:\workspaceここで、 WS_installdir は WebSphere Studio をインストールしたロケーションで、c:\workspace はワークスペースのロケーションです。
ユーザーはこのコマンドを使用してコマンド・プロンプトから WebSphere Studio を開始するか、デスクトップ・ショートカットを変更することができます。
既存の WebSphere Studio バージョン 5.0 ワークスペースを使用して WebSphere Studio バージョン 5.1 を初めて開始すると、ダイアログ・ボックスが表示されて、バージョン 5.0 からバージョン 5.1 へマイグレーションする 1 つの方法が示されます。 「OK」をクリックしてバージョン 5.0 ワークスペースからバージョン 5.1 へマイグレーションするか、または「取り消し (Cancel)」をクリックして WebSphere Studio の開始を停止します。
ワークスペースをバージョン 5.1 にマイグレーションすると、引き続きワークスペースをバージョン 5.0 で使用することができ、バージョン 5.1 の新規プロジェクト・フィーチャーのメタデータは無視され、バージョン 5.0 による読み取りが可能です。 バージョン 5.0 では、メタデータに影響を与えたり、バージョン 5.1 プロジェクトの新規プロジェクト・フィーチャーのメタデータを上書きしたりするような変更を、ワークスペースのプロジェクトに対して行うことはできません。
バージョン 5.1 の新規プロジェクト・フィーチャーについて詳しくは、WebSphere Studio Migration Guide を参照してください。
以下に、このリリースにおけるワークベンチの UI に関する既知の問題を示します。
プロジェクト内のファイルが WebSphere Studio の外部で追加または除去された場合や、 外部エディターを使用してプロジェクト内のファイルが変更された場合は、 変更をワークベンチに反映させるために、手動で最新表示を行う必要があります。これを行うには、ナビゲーター・ビューでプロジェクトを選び、ポップアップ・メニューから「最新表示」を選んでください。 これは選択されたプロジェクトのみを最新表示します。 すべてのプロジェクトを最新表示するには、F5 をクリックしてください。
ワークベンチで OLE 文書を使用した場合は (例: Word またはワード・パッドで .doc ファイルを編集する場合)、 次の問題が起こることが確認されています。
OLE 文書のダーティー状態は正しく更新されません。このため、ワークベンチは 文書をクローズするときに、文書の内容がすでに保管されている場合でも、 内容を保管するよう指示するプロンプトを表示します。
OLE 文書が破壊された場合、ワークベンチ・メニューが不整合になるか、WebSphere Studio が突然終了することがあります。
ワークベンチのユーザー・インターフェースはビューとエディターで構成されています。 フォーカスされているビューまたはエディターは、そのタブが青色で強調表示されます。 強調表示されているユーザー・インターフェース・コンポーネントにはコントロールがあり、 エディターの場合は、共通のワークベンチ・メニュー・ツリーおよびアクション・アイコン・セットを作成する機能を決定します。 つまり、エディターがアクティブにされると、 追加のメニュー選択項目とアクション・アイコンがワークベンチのユーザー・インターフェースに表示されます。エディターでリソースを操作していると、ユーザーはエディターをサポートするビュー (たとえば、Java ソース・エディターをサポートするアウトライン表示) と対話することになります。ビューにフォーカスがあるときは、 エディターに関連付けられたメニュー選択項目とアクション・アイコンは表示されない場合があります。このメニュー選択と アクション・アイコンを元に戻すには、エディターをアクティブにしてください。
エディターをアクティブにするには、さまざまな手法があります。 必要な手法はユーザーの使用するエディターのタイプによって決まります。
エディターをアクティブにするには、 エディター自体のタイトル・タブまたは編集可能領域のいずれかをクリックしてください。
特定のパターンに従って順番にクリックした場合、 別のビューの項目など、別の場所をクリックしてもエディターがフォーカスを保持した状態 (エディターのタイトル・タブが青の状態) のままとなる場合があります。 たとえば、DTD エディターがオープンされ、アウトライン・ビューが可視の場合、次のように操作してください。
この動作では、別のビューと対話をしている間も、 エディターのメニューとアクション・アイコンの活動化を維持できます。ビューで選択した項目のコンテキスト・メニューを要求することができます。 唯一の問題は、青いタイトルにより、フォーカスがまだエディターにあることが示されるときに、これが奇妙に見えるという点です。
一部のエディターは、フォーカスを移動する方法とタイミングに関連した、別の問題による影響を受けます。テキスト・フィールドへの入力は、 フォーカスがなくなったときに、フィールドに対する変更として登録されます。 web.xml エディターで URI マッピング・フィールドなどのフィールドにデータを入力し、 そのエディター・ページのグレー領域を単にクリックしても、 入力されたデータはフィールドに対する変更としては表示されません。 入力したデータは、以下のいずれかを行うと変更として登録されます。
アスタリスク (*) をエディター・タブのファイル名の前に追加することによって、エディターからユーザーに変更を登録したことが示されます。
タスク・ビューには、妥当性検査による警告およびエラー、コンパイラー・エラー、およびメッセージが表示されます。 テキストをファイルに貼り付けるには、関係のあるタスクの行を選択し、項目を適切なエディター (例: ワードパッド) にドラッグしてください。 タスクが見やすい報告書形式で表示されます。
DBCS 言語を実行中のマシン上の設定ダイアログで、ワークベンチ・フォントを非 DBCS フォント (例: Arial) に変更すると、DBCS 文字が疑問符で表示されます。これは予期されている動作です。 しかし、フォントを DBCS サポート言語に戻すときには、フォント設定と同時にフォント・ダイアログのスクリプト設定を確実に行うようにしてください。 この両方を同時に設定しないと、DBCS 文字は疑問符 (?) のまま表示されます。この問題は、「ワークベンチ・フォント (Workbench Font)」設定ページの「システム・フォントを使用 (Use System Font)」ボタンをクリックすることでも解決できます。
DBCS ユーザーが WebSphere Studio でテキストの表示に使用するフォントを変更することを推奨します。 設定ウィンドウのフォント (「ウィンドウ」>「設定」>「ワークベンチ」>「フォント」) ページでフォントを変更できます。
以下のフォントの使用をお勧めします。
前バージョンの WebSphere Studio で作成したワークスペースを現行バージョンの WebSphere Studio で初めてオープンすると、パースペクティブを復元するときにエラーになることがあります。 エラーになった場合は、メニュー・バーから「ウィンドウ (Window)」>「パースペクティブのリセット (Reset Perspective)」を選択してパースペクティブを復元してください。 これらのエラーを回避するには、前バージョンの WebSphere Studio のワークスペースに入っているすべてのパースペクティブをクローズしてから現行バージョンへマイグレーションしてください。
設定ダイアログ・ボックスなど、多くの WebSphere Studio のダイアログ・ボックスはでは、少なくとも 800 x 600 の最小ディスプレイ解像度が必要です。
外部ツールを起動すると、スペースを含む拡張パス変数は自動的に二重引用符 (" ") で囲まれます。 Windows プログラムがスペースを含むパスを引用符内で処理するのは一般的ですが、他のプラットフォームでは問題が発生することが分かっています。 対応策として、外部ツールにスクリプトを作成して、プログラムを起動する前に引用符を取ってしまう方法があります。
「ワークベンチ」 > 「エディター」の「設定」ダイアログ・ボックスに表示された「テキスト・ファイル・エンコード」値は、ユーザー・ロケールとシステム・ロケールが異なるときには、Windows XP (または 2000) を実行しているプラットフォームでは間違っている可能性があります。
たとえば、ユーザーが Windows 2000 日本語版を米国で使用中の場合を想定します。ユーザーはユーザー・ロケールとして「English (United States)」を選びます。 WebSphere Studio で表示される「テキスト・ファイル・エンコード」値「Cp1252 (English)」は間違っています。 表示されるシステム・ロケールは「MS932 (日本語)」でなければなりません。
この問題に対処するには、ユーザー・ロケールを変えてユーザー・ロケールとシステム・ロケールを同一にします。上の例では、 ユーザー・ロケールに「Japanese」を設定してから WebSphere Studio を再始動します。 「テキスト・ファイル・エンコード」値は、正しい「MS932 (Japanese)」になります。
Windows XP の場合:
Windows 2000 の場合:
アクション・バーのクライアントでは、多数の SubToolBarManagers
を
IToolBarManager
(例: 複数ページ・エディター) 上で作成することがあります。
クライアントは通常
1 つの SubToolBarManager
を見えるようにして、他は見えなくした上で、
updateActionBars
を呼び出します。 項目の可視性は正しく更新されない可能性があります。
対応策は、クライアントで明示的にツールバーを更新することです。
actionBars.updateActionBars();
actionBars.getToolBarManager().update(false);
アラビア語キーボード・レイアウトでは、いくつかのショートカット・キーが機能しません。
キーボードのレイアウトを英語に変更することで問題に対処できます。
別の WebSphere Studio システムから WebSphere Studio に設定をインポートするとき、不明のライブラリーを参照するコンパイル・エラーを受け取る場合があります。 クラスパス変数を適切にリセットするには、オープンされているすべての XML パースペクティブをクローズする必要があります。次に、ワークベンチをクローズし、再始動してから XML パースペクティブをオープンしてください。
単純プロジェクトを WebSphere Studio で作成する (「ファイル (File)」>「新規 (New)」>「その他の単純 (Other Simple)」>「プロジェクト (Project)」) ときは、リソース・パースペクティブに切り替えるようプロンプトが出なければならないはずですが、それが出されません。 これに対処するには、単純プロジェクトを作成した後で、手動でリソース・パースペクティブに切り替えます (「ウィンドウ (Window)」>「オープン・パースペクティブ (Open Perspective)」>「その他 (Other)」>「リソース (Resource)」)。
リンクされたリソースと複数の出力フォルダーはこのバージョンの Websphere Studio ではサポートされません。
「ワークベンチ (Workbench)」>「キー (Keys)」設定ページで "Toggle Overwrite Mode" コマンドのキー・バインディングを除去するときに、Insert キーをクリックすると、モードが引き続き切り替えられます。 このため、エディターの状況表示行のモード指示は、実際のモードと同期していません。
大規模なプロジェクトとファイルを処理しているときに OutOfMemoryError の問題が発生した場合、 WebSphere Studio を開始するときに、 -vmargs -Xmx500M コマンド行オプションを使用してヒープ・サイズを大きくすることができます。 500MB は、状況に応じて適切な量に調整してください。
以下に、エディターに関する既知の問題を示します。
保管していないテキストにマーカーを追加した場合、テキスト変更を保管せずにエディターをクローズすると、 これらのマーカーは正しく更新または除去されません。 エディターをクローズすると、マーカーは存在しない領域や関係のない領域をポイントする場合があります。
デフォルトの HTML および JSP エディターは双方向言語をサポートしていません。ユーザーが双方向言語を使用中の場合、HTML または JSP ファイルのデフォルト・エディターとして Page Designer「Classic」をセットアップすべきです。 このためには、「ウィンドウ」 > 「設定」 > 「ワークベンチ」 > 「ファイルの関連」を選択し、このページで関連を変更します。 Page Designer classic の使用可能化と関連付けの変更について詳しくは、Web ツールの README を参照してください。
J9 上で実行する場合は、以下の VM オプションを使用することをお勧めします。 詳細については、J9 VM の文書およびヘルプを参照してください。
platform [arguments] -vm <path to j9w.exe> -vmargs -ms:20 -jit -mo:32000 -mx:200000
ここで、platform は、インストール・ディレクトリーの最上位にある実行可能ファイル名であり、arguments は、 プラットフォームに渡される引き数です。
注: -vmargs フラグおよび実際の VM の引き数は、行の最後に指定する必要があります。
utc.dll でプログラム・エラーを受け取った場合は、 WebSphere Studio をその .exe ファイルから起動する必要があります。構成設定ファイル (.exe ファイルと同じディレクトリー内にあり、.ini で終わる) は、以下の項目を [Environment Variables] セクションに含まなければなりません。
JITC_COMPILEOPT=SKIP{org/eclipse/ui/views/tasklist/TaskListContentProvider}{resourceChanged}
WebSphere Studio を「スタート (Start)」メニューに作成されたショートカットから起動する場合、項目はすでにメニューに追加されています。
Ant スクリプトが外部ツールとして、または「Run Ant」ポップアップ・メニューから実行される場合、
WebSphere Studio と同じ Java VM 上で実行されます。
実行中のスクリプトが System.exit(int)
を呼び出す Ant タスクのいずれかを実行した場合、WebSphere
Studio は終了し、保管していない作業は失われます。
これらの Ant タスクの問題の対応策は、Ant を外部ツールとして構成することです。
この方法を以下に示します。
- http://jakarta.apache.org/ant から Ant のバイナリー・バージョンをダウンロードしてインストールする。
- 「実行 (Run)」>「外部ツール (External Tools)」>「構成 (Configure)」 とクリックする。
- 「新規 (New)」をクリックする。
- 外部ツールの名前 (例: External Ant) を入力する。
- 「ファイル・システムのブラウズ (Browse File System)」をクリックする。
ant.bat
ファイルを探して選択する (場所はユーザーの Ant システムの bin/ フォルダー)。- 「ツール引き数 (Tool Arguments)」フィールドに、 ワークベンチの外部でスクリプトを実行するときに通常入力するスクリプトの引き数を入力する。
- 「作業ディレクトリー (Working directory)」フィールドに スクリプトのディレクトリーを入力する。
- 「OK」クリックしてウィザードを終了する。
- スクリプトを実行するには、「実行」 > 「外部ツール」 > 「外部 Ant」をクリックする。
「ウィンドウ」>「設定」>「外部ツール」には、「優先出力レベル」-「情報」、「Verbose」、および「デバッグ」の見出しの下にラジオ・ボタンのグループがあります。 これらの値を変更しても WebSphere Studio に影響を与えることはありません。
Ant スクリプトを実行するときに、Ant コマンド行引き数 -verbose
または -debug
を使用して、デフォルト以外の出力レベルを取得してください (Information)。
WebSphere Studio の Ant UI は、URI ベースのシステム値を持つエンティティーを、
"file:"
プロトコルを指定して、正しく解決します。相対パス、"http:"
URI、などの他の書式やプロトコルはユーザーのデフォルト XML parser で解決されますが、これらは JRE、ユーザー設定などで変わることがあります。
たとえば、org.apache.crimson.parser
などのパーサーは、有効な URI のみを期待し、以下のようなエンティティー参照では失敗します。
<!ENTITY custom SYSTEM "../../custom.xml">
この問題の対応策は、"file:"
プロトコル指定子を以下のように相対パスに確実に追加することです。
<!ENTITY custom SYSTEM "file:../../custom.xml">
この問題は UI でのみ起こります。WebSphere Studio の Ant 実行エンジンは SAXParser
を使用しており、
これは、相対パスのような書式を正しく解決するためです。
Xerces JAR を明示的にランタイム Ant クラスパスに追加することは必要でなくなりましたが、問題を発生させることがあります。
Xerces クラスは、Eclipse によって提供される org.apache.xerces
プラグインからロードされます。
ほとんどの Ant 配布物の場合、Xerces JAR を ant.jar
および optional.jar
と同じ物理ロケーションに入れることもできません。
この制限は、Xerces JAR を指し示すクラスパス項目が入っているマニフェスト・ファイルが
Ant JAR に含まれていることからきています。
カスタム Ant タスクまたは Ant 型のクラス・ファイルをプラグインの正規コード JAR に組み込むと、問題が発生します。
これらのクラス・ファイルは、org.eclipse.ant.core.antTasks
または
antTypes
拡張ポイントに提供された (および、プラグインのマニフェストにライブラリーとして宣言されていない) 別個の
JAR に提供する必要があります。
こうすることにより、Ant タスクおよび型が、プラグイン classloader によってではなく、特殊
Ant クラス・ローダーによってロードされます。
Eclipse は、WebSphere Studio の残りのマシンと同じ JVM で Ant を実行します。 Ant が持ついくつかの性質により、またそれがグローバル Java リソース (たとえば、System.out および System.err) を使用しているため、複数の Ant ビルドを並行実行するのは危険です。
特定の Ant タスクはメモリー・リークすることが分かっています。
Ant をコマンド行から使用する場合と同様に、コンソールから入力を要求するプロンプトは処理されません。 これは <input> タスクを使用するのと同じではありません。このタスク場合は、WebSphere Studio で正しく機能します。
Ant エディターによって提供されるコード完了では、ユーザー指定バージョンの
org.eclipse.ant.core
プラグインまたは ANT_HOME は考慮されません。
コード完了の提案は、常に Ant 1.5 に基づいて行われます。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.