1.0 啟動工作台
1.1 進階啟動主題
1.2
在工作台的標題列中顯示工作區的位置
1.3 利用 Proxy 存取更新網站
1.4 利用 5.0 版工作區使用 WebSphere Studio 5.1 版
2.0 工作台已知的問題
2.1 當檔案在工作台之外修改時,需要以手動重新整理
2.2 使用者介面沒有回應
2.3 從「作業」清單複製項目
2.4 DBCS 字型問題
2.5 最小螢幕解析度
2.6 外部工具會自動將包含空格的路徑變數放在引號中
2.7 在多頁編輯器中更新工具列
2.8 某些快速鍵對阿拉伯文的鍵盤佈置沒有作用
2.9 如果開啟 NumLock,控制鍵會無法運作
2.10 請勿針對相同工作區目錄執行多個工作台
2.11 不支援的顏色深度錯誤
2.12 在唯讀組合框中,複製無法運作
2.13 如果您從另一個 WebSphere Studio 安裝架構中匯入喜好設定,就必須重設類別路徑變數
2.14 當您還原已移轉之工作區的視景時,可能會發生錯誤
2.15 在視窗檢視系統是 Motif 時移動視圖
2.16 建立簡式專案應該開啟「資源」視景
2.17 鏈結的資源和多個輸出資料夾
2.18 KDE 採用 Ctrl+Fn 鍵
2.19 無法停用 AbstractTextEditor 和子類別的改寫模式
2.20 使用大型專案和檔案
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 JAR
6.4 自訂 Ant 作業和 Ant 類型必須有別於外掛程式庫 JAR
6.5 不支援並行 Ant 建置
6.6 執行特定 Ant 作業會造成記憶體洩漏
6.7 需要輸入鎖定工作區的作業
6.8 以 Ant 1.5 為基礎的 Ant 編輯器程式碼完成項
7.0 Linux GTK 問題
7.1 遺漏特定 OS 對話框的翻譯
7.2 Linux GTK 中的 DBCS 支援
7.3 使用不同版本的 GTK
7.4 GTK 2.2.0 韓文翻譯問題
7.5 在呼叫候選視窗之後,日文輸入方法會停止運作
Eclipse(建置 WebSphere Studio 的平台)提供了許多執行選項,有助於使用者開發或除錯外掛程式。執行這些執行檔的一般格式如下:
平台 [平台選項] [-vmargs [Java VM 引數]]
其中,平台 是安裝目錄之最上層目錄中執行檔的名稱,且有效的平台選項如下:
-application <應用程式 ID> | 識別要執行的應用程式。如果未指定,則會執行工作台。應用程式是由提供延伸給 org.eclipse.core.runtime.applications 延伸點的外掛程式來宣告。 |
-boot <啟動程式碼路徑> | 定義啟動外掛程式程式碼(亦即,boot.jar)的路徑。 僅當您變更了 startup.jar 和 boot.jar 的相對位置時,才需要這個選項。 |
-consolelog | 將平台的錯誤日誌鏡映到用來執行平台的主控台。 |
-data <工作區路徑> | 定義執行平台之工作區的路徑。 |
-debug [選項檔路徑] | 將平台置於除錯模式,並將除錯選項載入指定的檔案中。如果未給定檔案路徑,平台會在平台安裝目錄以及工作區的 metadata 目錄中尋找名為 .options 的檔案。 |
-dev [類別路徑項目] | 將平台置於開發模式中, 選用性的類別路徑項目(一個以逗號區隔的清單)會加入每一個外掛程式的類別路徑中。比方說,當您在開發外掛程式時,您可使用 -dev bin 來新增每一個外掛程式之 JavaTM 工具開發的 bin 目錄。多餘或不存在的類別路徑項目會被刪除。 |
-nosplash | 執行平台但不顯示歡迎畫面。 |
-os <os-id> | 定義執行平台的作業系統。一般而言,平台可以偵測 OS,但某些狀況可能需要明確的規格。這裡指定的值和 Platform.getOS() 相關。 |
-vm <vm 路徑> | 指定用來執行平台的 Java VM。如果未指定,Java VM 的位置會和執行檔有關。 |
-ws <ws-id> | 定義執行平台的視窗系統。一般而言,平台可以偵測視窗系統,但某些狀況可能需要明確的規格。這裡指定的值和 Platform.getWS() 相關。 |
-vmargs 項目之後(不含該項目)的所有引數都會直接傳給指出的 Java VM,作為虛擬機器引數(亦即,在要執行的類別之前)。-vmargs 項目之前的所有引數(但 -vm 和 -nosplash 除外)都會直接傳給平台以供解譯。
如果您要在工作台的標題列中顯示工作區的位置,您必須利用以下指令啟動 WebSphere Studio:
WS_installdir\wssitedev50 -showlocation -data /workspace
其中,WS_installdir 是安裝 WebSphere Studio 的位置,/workspace 是工作區的位置。
您可以利用這個指令從指令提示啟動 WebSphere Studio,或變更桌面捷徑。
如果要利用 Proxy 來存取更新網站,您必須利用下列指令行選項來啟動工作台:
wssitedev50 -vmargs -DproxySet=true -DproxyHost=<proxy_name> -DproxyPort=<proxy_port>
目前不支援需要使用者鑑別的 Proxy。
當您第一次利用現有的 WebSphere Studio 5.0 版工作區來啟動 WebSphere Studio 5.1 版時,會出現一個對話框來提供從 5.0 版移轉至 5.1 版的方法。 請按一下確定,將 5.0 版工作區移轉至 5.1 版,或按一下取消來停止啟動 WebSphere Studio。
當工作區移轉至 5.1 版時,5.0 版仍可以使用這個工作區,因為 5.1 版新專案特性的 Meta 資料會被忽略, 5.0 版仍可以讀取它。 您不能在 5.0 版中進行會影響到 Meta 資料的工作區專案變更,或改寫 5.1 版專案之新專案特性的 Meta 資料。
如果需要 5.1 版中之新專案特性的詳細資訊,請參閱 WebSphere Studio 移轉手冊。
以下是本版本工作台 UI 已知的問題。
當專案內的檔案在 WebSphere Studio 之外新增或移除時,或者當您使用外部編輯器來修改專案內的檔案時,您必須執行手動重新整理,才能使變更顯示在工作台中。如果要執行這項作業, 請在「導覽器」視圖中選取專案,然後按一下其蹦現功能表中的重新整理。這僅會重新整理選取的專案。您可按 F5 重新整理所有的專案。
工作台使用者介面是由視圖和編輯器所組成。已定焦之視圖或編輯器的標籤會以藍色強調顯示。強調顯示的使用者介面元件具有控制權, 如果是編輯器,它也會判斷共用工作台功能表樹和動作圖示集的構成要素。 也就是說,當您啟動編輯器時,其他的功能表選項及動作圖示可能會出現在工作台使用者介面上。當您處理編輯器中的資源時, 您也可以和支援編輯器的視圖(例如,支援 Java 程式碼編輯器的「概要」視圖)互動。當您定焦於視圖時, 和編輯器相關聯的功能表選項與動作圖示可能會消失。如果要重新顯示這些功能表選項與動作圖示,請啟動編輯器。
您可以利用多種技術來啟動編輯器。所需的技術可能會根據您要使用的編輯器類型而定。
如果要啟動編輯器,您必須按一下標題標籤或編輯器本身可編輯的區域。
在某些情況下,雖然您遵循特定模式的按鍵動作,但即使您按一下別處(如另一個視圖中的項目), 編輯器還是會維持定焦(其標題標籤是藍色的)。比方說,當 DTD 編輯器已開啟並已顯示「概要」視圖時, 請執行下列動作:
這個行為會使得即使您和另一個視圖互動,編輯器功能表和動作圖示構成要素仍會保持在作用中。您仍然可以要求視圖中選取之項目的快速功能表。唯一的問題是,當藍色的標題顯示焦點仍在編輯器上時,這樣做似乎很奇怪。
有些編輯器會受另一個和焦點變更方式與時機相關的問題影響。僅當焦點移轉時,文字欄位中產生的項目才會登錄成是該欄位的變更。如果您在欄位(如 web.xml 編輯器中的「URI 對映」欄位)中輸入資料,且只是按一下編輯器頁面的灰色區域,則輸入的資料似乎並未成為該欄位的變更。如果您執行下列任何一項作業,輸入的資料就會登錄成變更:
編輯器會藉由在編輯器標籤中顯示的檔案名稱前加上一個星號 (*),讓您知道變更已登錄。
驗證警告和錯誤、編譯器錯誤以及訊息都會顯示在「作業」視圖中。如果要將文字貼至檔案,請選取相關作業的列,再將項目拖至適當的編輯器(如 Wordpad)中。您的作業會以整齊的報表形式呈現。
如果您在執行 DBCS 語言的機器上,於「喜好設定」對話框中將工作台字型變更為非 DBCS 的字型(例如:Arial),則 DBCS 字元會以問號呈現;這是預期的行為。可是,當您將字型變回 DBCS 支援的字型時, 請確定在設定字型的同時,於「字型」對話框中設定 Script 設定。如果您未同時設定這些項目,DBCS 字元還是會維持問號。這個問題的另一個解決方案是,按一下工作台字型「喜好設定」頁面上的使用系統字型按鈕。
建議 DBCS 的使用者變更使用的字型,以在 WebSphere Studio 中顯示文字。您可以在「喜好設定」視窗的「字型」(視窗 > 喜好設定 > 工作台> 字型)頁面中變更字型。
建議您使用下列字型:
WebSphere Studio 中的許多對話框(如「喜好設定」對話框)都需要至少 800 x 600 的螢幕解析度。
當您啟動外部工具時,如果展開後的路徑變數包含空格,它會自動括在雙引號 ( " " ) 中。Windows 程式處理包含空格之路徑的方式,通常是將它括在引號中,這已知會導致其他平台發生問題。解決方案是針對外部工具製作一個 Script,在以這些參數啟動程式之前,先取消這些引號。
動作列的用戶端可以在其 IToolBarManager
(例如:多頁編輯器)上建立許多 SubToolBarManagers
。用戶端通常會顯示一個 SubToolBarManager
,隱藏其餘的,並呼叫 updateActionBars
。這時項目的可見性可能不會正確地更新。
對用戶端而言,解決方案是明確地更新工具列:
actionBars.updateActionBars();
actionBars.getToolBarManager().update(false);
某些快速鍵對阿拉伯文的鍵盤佈置沒有作用。您可以將鍵盤佈置變更為英文鍵盤,來解決這個問題。
如果 Ctrl-s、Ctrl-space 或其他 Ctrl 按鍵組合無法運作,請按 NumLock 鍵來關閉 NumLock。
用相同工作區目錄來啟動工作台兩次無效。 這麼做會造成無法預期的結果。 工作區目錄的預設位置是 ~/workspace,您可以依照下列方式,設定 -data 旗標指定不同目錄來置換它:例如,wssitedev50 -data /home/username/newworkspace
當啟動工作區時,如果您收到不支援的顏色深度的相關錯誤,您必須將顯示器的顏色深度改成 15 或 32 bpp 以外的值。 這需要重新啟動 X 伺服器。 請參閱系統文件,以取得如何執行這個動作的指示。
目前在 Linux 中,無法從唯讀組合框中複製文字。
如果您將另一個 WebSphere Studio 安裝架構的喜好設定匯入 WebSphere Studio 中,可能會出現參照遺漏的程式庫的編譯錯誤。 如果要適當重設類別路徑變數,請關閉任何開啟的 XML 視景。 之後,關閉工作台,重新啟動它,再開啟 XML 視景。
第一次在 WebSphere Studio 現行版本中開啟舊版 WebSphere Studio 所建立的工作區時,還原視景時可能會發生錯誤。 如果有遭遇到錯誤,請從功能表列中選取視窗 > 重設視景來還原視景。 如果要避免這些錯誤,在移轉至現行版本之前,請先關閉舊版 WebSphere Studio 工作區中的所有視景。
如果您在 Linux 中使用 WebSphere Studio,且您的視窗檢視系統是 Motif,您必須利用滑鼠中鍵來選取視圖,才能夠移動它。 如果滑鼠只有兩鍵,在需要移動視圖時,請同時按住兩個滑鼠鍵選取該視圖,才可以加以移動。
當您在 WebSphere Studio 中建立簡式專案(檔案 > 新建 > 其他簡式 > 專案)時,應該會提示您切換至「資源」視景,但沒有出現這個提示。 如果要暫時解決這個問題,請在建立好簡式專案之後,手動切換至「資源」視景(視窗 > 開啟視景 > 其他 > 資源)。
在這個版本的 WebSphere Studio 中,不支援鏈結資源和多個輸出資料夾。
當在 Linux 系統中使用 KDE 桌面時,可使用 Ctrl+Fn 按鍵序列來切換虛擬桌面。 這表示連結這些按鍵序列的 WebSphere Studio 指令都不會啟動,其中包括 Ctrl+F1(說明)、Ctrl+F4 (檔案 > 關閉)和 Ctrl+F6(下一編輯器)。
您可以利用控制中心,在 KDE 中重新指派這些鍵。 請選取外觀和操作方式 > 捷徑 > 捷徑序列 > 捷徑序列 > 系統 > 桌面切換,將所有項目設為無,或設為不同的按鍵序列,如 Ctrl+Alt+Fn。 另一個替代方案是在 WebSphere Studio 中,利用視窗 > 喜好設定 > 工作台 > 按鍵喜好設定頁面來指派不同的按鍵序列。
當在工作台 > 按鍵喜好設定頁面中移除「切換改寫模式」指令的按鍵連結時,當按一下 Insert 鍵,仍會切換模式。 之後,編輯器狀態行中的模式指示就不再與實際模式同步。
當您使用大型專案和檔案時,如果發生 OutOfMemoryError 問題,您可以在啟動 WebSphere Studio 時,利用 -vmargs -Xmx500M 指令行選項來增加資料堆大小。 請將 500M (500 meg) 調整成適合您狀況的數量。
下列是編輯器已知的問題。
當您將標記加入未儲存的文字中時,如果編輯器關閉時未儲存這些文字變更,這些標記並不會適當地更新或移除。在您關閉編輯器之後,這些標記可能會指向不存在或不相關的文字區域。
預設 HTML 和 JSP 編輯器不支援雙向語言。如果您打算使用雙向語言,您應該設定 Page Designer "Classic" 作為 HTML 或 JSP 檔的預設編輯器。如果要執行這項作業,請選取視窗 > 喜好設定 > 工作台 > 檔案關聯,並變更這個頁面中的關聯項目。如需有關啟用 Page Designer Classic 以及變更關聯項目的詳細資訊,請參閱 Web 工具的 Readme 檔。
如果您是在 J9 上執行,建議您使用下列 VM 選項。請參閱 J9 VM 的文件與說明,以取得進一步資訊:
平台 [引數] -vm <j9w.exe 的路徑> -vmargs -ms:20 -jit -mo:32000 -mx:200000
其中,平台是安裝架構之最上層目錄中執行檔的名稱,而引數是傳給平台的那些引數。
附註:-vmargs 旗標和實際的 VM 引數必須放在字行的尾端。
如果您在 utc.dll 中收到程式錯誤,則您必須從其 .exe 檔啟動 WebSphere Studio。配置設定檔(和 .exe 檔位於相同的目錄中 - 它的名稱結尾是 .ini)也必須在 [Environment Variables] 區段中包含下列項目:
JITC_COMPILEOPT=SKIP{org/eclipse/ui/views/tasklist/TaskListContentProvider}
{resourceChanged}
如果您從「開始」功能表中建立的捷徑啟動 WebSphere Studio, 則該項目已加入。
如果 Ant Script 是當作外部工具或是利用執行 Ant 蹦現功能表來執行,
它會和 WebSphere Studio 在相同的 Java VM 上執行。如果執行中的 Script 執行了任何呼叫 System.exit(int)
的 Ant 作業,WebSphere Studio 會結束,且未儲存的工作也會遺失。這些 Ant 作業的解決方案是將 Ant 配置成外部工具。下列步驟顯示了如何執行這個作業:
- 從 http://jakarta.apache.org/ant 下載並安裝二進位版本的 Ant。
- 按一下執行 > 外部工具 > 配置。
- 按一下新建。
- 輸入外部工具的名稱(例如:External Ant)。
- 按一下瀏覽檔案系統。
- 找出並選取名為
ant.bat
的檔案(它應該位於 Ant 安裝架構的 bin/ 資料夾中)。- 在工具引數欄位中輸入 Script 的引數,這是您在工作台之外執行 Script 時,通常會輸入的引數。
- 在工作目錄欄位中輸入 Script 的目錄。
- 按一下確定以結束精靈。
- 如果要執行 Script,請按一下執行 > 外部工具 > 外部 Ant。
在視窗 > 喜好設定 > 外部工具中,標題偏好的輸出層次下有一組圓鈕 - 資訊、贅述和除錯。變更這些值不會對 WebSphere Studio 有任何影響。
當您執行 Ant Script 時,您可使用 Ant 指令行引數 -verbose
或 -debug
來取得預設值(資訊)以外的輸出層次。
如果 URI 型的系統值指定了 "file:"
通訊協定,WebSphere Studio 的 Ant UI 會正確地解析實體。其他格式與通訊協定(如相對路徑、"http:"
URI 等等)會由使用者的預設 XML 剖析器來解析,這個剖析器會因 JRE、使用者設定等等而有所不同。比方說,如 org.apache.crimson.parser
的剖析器僅接受有效的 URI,
且對如下的實體參照會失敗:
<!ENTITY custom SYSTEM "../../custom.xml">
這個問題的解決方案是,確定將 "file:"
通訊協定指定元加入相對路徑中,如下所示:
<!ENTITY custom SYSTEM "file:../../custom.xml">
這個問題僅會發生在 UI 中,原因是 WebSphere Studio 的 Ant 執行引擎會使用 SAXParser
正確地解析如相對路徑的格式。
現在已不需要在執行時期 Ant 類別路徑中特別加入 Xerces JAR,它可能會造成問題。
Xerces 類別是從 Eclipse 所提供的 org.apache.xerces
外掛程式載入的。
對大部分 Ant 程式模組散布而言,Xerces JAR 甚至不能在與 ant.jar
和 optional.jar
相同的實體位置。
這是因為 Ant JAR 含有 manifest 檔,而 manifest 檔又含有指向 Xerces JAR 的類別路徑項目。
在外掛程式的正規程式碼 JAR 中併入自訂 Ant 作業或 Ant 類型的類別檔會發生問題。
這些類別檔必須位在產生 org.eclipse.ant.core.antTasks
或 antTypes
延伸點的個別 JAR 中(而不是在外掛程式的 Manifest 中宣告成程式庫)。
這可以確保 Ant 作業和類型是由特殊 Ant 類別載入器載入的,而不是由外掛程式類別載入器載入。
Eclipse 是在與 WebSphere Studio 其他部分相同的 JVM 中執行 Ant。 Ant 的若干情況及其廣域 Java 資源的運用(如 System.out 和 System.err),會在並行執行多個 Ant 建置時對安全性有所影響。
已知某些 Ant 作業會造成記憶體洩漏。
如同從指令行使用 Ant,主控台的輸入提示也不會獲得處理。 這與使用在 WebSphere Studio 能正確運作的 <input> 作業不同。
Ant 編輯器所提供的程式碼完成項不遵循使用者定義的 org.eclipse.ant.core
外掛程式版本或 ANT_HOME。
程式碼完成項的提議一律以 Ant 1.5 為基礎。
以下是 Linux GTK 問題。
在 GTK 2.0.6 或 GTK 2.2 中,選取檔案或資料夾的作業系統對話框只翻譯了一部分。 這些對話框和未翻譯的訊息是來自 GTK,而不是 WebSphere Studio。
Red Hat Linux 8.0 和 SuSE Linux 8.1 所包括的 GTK 版本支援 Latin-1 語言環境,不支援 DBCS。 GTK 2.2 中的 DBCS 支援應該夠用,原則上,WebSphere Studio 能夠在任何含有 GTK 2.2 的最新 Linux 版本中運作。
下載和編譯新版 GTK 的使用者,比方說,為了取得 RedHat 8.0 中之 GTK 2.2.0 DBCS 支援,必須確定 LD_LIBRARY_PATH 環境變數中列出了正確的 GTK 程式庫。 依預設,編譯的 GTK 程式庫放在 /user/local/lib/ 中,因此,在啟動 WebSphere Studio 之前,必須先執行下列動作。
export LD_LIBRARY_PATH=/usr/local/lib/
附註:每個新的終端機階段作業都必須執行這個動作。
下載和編譯新版 GTK 的使用者(比方說,為了取得 GTK 2.2.0 的 DBCS 支援)在使用韓文翻譯時,可能會發生下列問題:
建議您將對話框字型和旗標字型設為黑體字型。 您可以利用工作台 > 字型喜好設定頁面來變更字型。
如果要暫時解決調整視窗大小的問題,建議您設定高螢幕解析度(如 1280x1024)
如果要暫時解決「內容」視圖問題,請改用方向鍵。請利用左移鍵來收合項目,利用右移鍵來展開它們。
如果您在 GTK 版本的日文漢字輸入中使用 kinput2 和 canna,日文輸入方法有時會停止運作。
這是在開啟「候選選項視窗」之後發生的。
當發生這個問題時,您必須關閉編輯器或視圖,再重新開啟它,以重新啟用輸入方法。
如果要避免這個問題,您必須使用另一個輸入方法,如 wnn。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.