1.0 啟動工作台
1.1 進階啟動主題
1.2
在工作台的標題列中顯示工作區的位置
1.3 利用 Proxy 存取更新網站
1.4 利用 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 在使用第 5 版測試版工作區時,可能會發生和 JRE_LIB 相關的建置錯誤
2.13 如果您從另一個 WebSphere Studio 安裝架構中匯入喜好設定,就必須重設類別路徑變數
2.14 建立簡式專案應該開啟「資源」視景
2.15 鏈結的資源和多個輸出資料夾
2.16 無法停用 AbstractTextEditor 和子類別的改寫模式
2.17 使用大型專案和檔案
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 編輯器程式碼完成項
在安裝之後,您可以執行最上層安裝目錄中的可執行程式來啟動工作台。
依預設,工作台會建立名為 workspace 的目錄。這個目錄會當作專案的預設內容區, 並用來保存任何所需的 Meta 資料。針對共用或多工作區的安裝架構,您應該明確地描述工作區的位置,而非使用預設值。控制工作區位置有兩種方式:使用現行的工作目錄或使用 -data 指令行引數。
使用現行工作目錄最簡單的方式是,利用下列步驟建立捷徑:
其他選項會將 -data 引數(例如: -data c:\myworkspace)加入捷徑的目標行中,或是從指令提示啟動程式並併入 -data 引數。
WebSphere Studio 如果安裝在路徑包含某些無效字元(包括:%#<>"!)的目錄中,會無法啟動。
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\wssitedev.exe -showlocation -data c:\workspace
其中,WS_installdir 是安裝 WebSphere Studio 的位置,而 c:\workspace 則是工作區的位置。
您可以利用這個指令從指令提示啟動 WebSphere Studio,或變更桌面捷徑。
如果要利用 Proxy 來存取更新網站,您必須利用下列指令行選項來啟動工作台:
wssitedev.exe -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 重新整理所有的專案。
當您在工作台中使用 OLE 文件(比方說,在 Word 或 WordPad 中編輯 .doc 檔)時,會發生下列已知的問題。
系統不會適當地更新 OLE 文件已用過的狀態。這會導致工作台在關閉文件時,即使內容已儲存,工作台還是會提示您儲存文件的內容。
如果 OLE 文件損毀,工作台功能表可能會變得不一致,或者 WebSphere Studio 可能會突然結束。
工作台使用者介面是由視圖和編輯器所組成。已定焦之視圖或編輯器的標籤會以藍色強調顯示。強調顯示的使用者介面元件具有控制權, 如果是編輯器,它也會判斷共用工作台功能表樹和動作圖示集的構成要素。 也就是說,當您啟動編輯器時,其他的功能表選項及動作圖示可能會出現在工作台使用者介面上。當您處理編輯器中的資源時, 您也可以和支援編輯器的視圖(例如,支援 Java 程式碼編輯器的「概要」視圖)互動。當您定焦於視圖時, 和編輯器相關聯的功能表選項與動作圖示可能會消失。如果要重新顯示這些功能表選項與動作圖示,請啟動編輯器。
您可以利用多種技術來啟動編輯器。所需的技術可能會根據您要使用的編輯器類型而定。
如果要啟動編輯器,您必須按一下標題標籤或編輯器本身可編輯的區域。
在某些情況下,雖然您遵循特定模式的按鍵動作,但即使您按一下別處(如另一個視圖中的項目), 編輯器還是會維持定焦(其標題標籤是藍色的)。比方說,當 DTD 編輯器已開啟並已顯示「概要」視圖時, 請執行下列動作:
這個行為會使得即使您和另一個視圖互動,編輯器功能表和動作圖示構成要素仍會保持在作用中。您仍然可以要求視圖中選取之項目的快速功能表。唯一的問題是,當藍色的標題顯示焦點仍在編輯器上時,這樣做似乎很奇怪。
有些編輯器會受另一個和焦點變更方式與時機相關的問題影響。僅當焦點移轉時,文字欄位中產生的項目才會登錄成是該欄位的變更。如果您在欄位(如 web.xml 編輯器中的「URI 對映」欄位)中輸入資料,且只是按一下編輯器頁面的灰色區域,則輸入的資料似乎並未成為該欄位的變更。如果您執行下列任何一項作業,輸入的資料就會登錄成變更:
編輯器會藉由在編輯器標籤中顯示的檔案名稱前加上一個星號 (*),讓您知道變更已登錄。
驗證警告和錯誤、編譯器錯誤以及訊息都會顯示在「作業」視圖中。如果要將文字貼至檔案,請選取相關作業的列,再將項目拖至適當的編輯器(如 Wordpad)中。您的作業會以整齊的報表形式呈現。
如果您在執行 DBCS 語言的機器上,於「喜好設定」對話框中將工作台字型變更為非 DBCS 的字型(例如:Arial),則 DBCS 字元會以問號呈現;這是預期的行為。可是,當您將字型變回 DBCS 支援的字型時, 請確定在設定字型的同時,於「字型」對話框中設定 Script 設定。如果您未同時設定這些項目,DBCS 字元還是會維持問號。這個問題的另一個解決方案是,按一下工作台字型「喜好設定」頁面上的使用系統字型按鈕。
建議 DBCS 的使用者變更使用的字型,以在 WebSphere Studio 中顯示文字。您可以在「喜好設定」視窗的「字型」(視窗 > 喜好設定 > 工作台> 字型)頁面中變更字型。
建議您使用下列字型:
第一次在 WebSphere Studio 現行版本中開啟舊版 WebSphere Studio 所建立的工作區時,還原視景時可能會發生錯誤。 如果有遭遇到錯誤,請從功能表列中選取視窗 > 重設視景來還原視景。 如果要避免這些錯誤,在移轉至現行版本之前,請先關閉舊版 WebSphere Studio 工作區中的所有視景。
WebSphere Studio 中的許多對話框(如「喜好設定」對話框)都需要至少 800 x 600 的螢幕解析度。
當您啟動外部工具時,如果展開後的路徑變數包含空格,它會自動括在雙引號 ( " " ) 中。Windows 程式處理包含空格之路徑的方式,通常是將它括在引號中,這已知會導致其他平台發生問題。解決方案是針對外部工具製作一個 Script,在以這些參數啟動程式之前,先取消這些引號。
當使用者語言環境和系統語言環境不同時,工作台 > 編輯器下之「喜好設定」對話框中顯示的文字檔編碼的值,在執行 Windows XP(或 2000)的平台上可能是錯的。
比方說,假設使用者使用的是日文的 Windows 2000,但是在美國工作,且該使用者選取了英文(美國)作為使用者語言環境。則 WebSphere Studio 中顯示的文字檔編碼值是不正確的:Cp1252(英文)。它應該顯示系統語言環境:MS932(日文)。
如果要解決這個問題,您可以變更使用者語言環境,使得使用者語言環境與系統語言環境一致。在上述範例中,這表示您應該設定日文作為使用者語言環境,然後重新啟動 WebSphere Studio。如此文字檔編碼的值就會是正確的:MS932(日文)。
針對 Windows XP:
Windows 2000:
動作列的用戶端可以在其 IToolBarManager
(例如:多頁編輯器)上建立許多 SubToolBarManagers
。用戶端通常會顯示一個 SubToolBarManager
,隱藏其餘的,並呼叫 updateActionBars
。這時項目的可見性可能不會正確地更新。
對用戶端而言,解決方案是明確地更新工具列:
actionBars.updateActionBars();
actionBars.getToolBarManager().update(false);
某些快速鍵對阿拉伯文的鍵盤佈置沒有作用。您可以將鍵盤佈置變更為英文鍵盤,來解決這個問題。
當您使用 WebSphere Studio 5.0 版測試版的工作區時,可能會發生和 JRE_LIB 相關的建置錯誤。如果要解決這個問題,請遵循下列步驟:
當專案重新建置後,應該不會再發生 JRE_LIB 錯誤。
如果您將另一個 WebSphere Studio 安裝架構的喜好設定匯入 WebSphere Studio 中,可能會出現參照遺漏的程式庫的編譯錯誤。 如果要適當重設類別路徑變數,請關閉任何開啟的 XML 視景。 之後,關閉工作台,重新啟動它,再開啟 XML 視景。
當您在 WebSphere Studio 中建立簡式專案(檔案 > 新建 > 其他簡式 > 專案)時,應該會提示您切換至「資源」視景,但沒有出現這個提示。 如果要暫時解決這個問題,請在建立好簡式專案之後,手動切換至「資源」視景(視窗 > 開啟視景 > 其他 > 資源)。
在這個版本的 WebSphere Studio 中,不支援鏈結資源和多個輸出資料夾。
當在工作台 > 按鍵喜好設定頁面中移除「切換改寫模式」指令的按鍵連結時,當按一下 Insert 鍵,仍會切換模式。 之後,編輯器狀態行中的模式指示就不再與實際模式同步。
當您使用大型專案和檔案時,如果發生 OutOfMemoryError 問題, 您可以在啟動 wsappdev.exe 時,利用 -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 為基礎。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.