1.0 Executando o Workbench
1.1 Tópicos de Lançamento Avançados
1.2
Exibindo a Localização do Espaço de Trabalho na Barra de Título do Workbench
1.3
Acessando Sites de Atualização Através de um Proxy
1.4 Utilizando o
WebSphere Studio Versão 5.1 com Espaço de Trabalho da Versão 5.0
2.0 Problemas Conhecidos com o Workbench
2.1 Atualização Manual Requerida Quando Arquivos são Modificados Fora do Workbench
2.2 Problemas no Windows: Ao Utilizar Documentos OLE
2.2.1 Estado Dirty não Rastreado Apropriadamente para Documento OLE
2.2.2 Falhas do Documento OLE Podem Causar
a Saída Repentina do WebSphereR Studio
2.3 Interface do Usuário não Respondendo
2.4 Copiando Itens a partir da Exibição
Tasks
2.5 Problemas de Fontes DBCS
2.6 Podem Ocorrer Erros ao Restaurar uma Perspectiva para um Espaço de Trabalho Migrado
2.7 Resolução Mínima de Vídeo
2.8 As Ferramentas Externas Colocarão Automaticamente as Variáveis de Caminho que Contêm Espaços
Entre Aspas
2.9
A Codificação do Arquivo de Texto Padrão Pode Ser Detectada Incorretamente (Apenas
Windows XP/2000)
2.10
Atualizando a Barra de Ferramentas em Editores de Várias Páginas
2.11
Determinadas Teclas de Atalho não Funcionam com um Layout de Teclado Árabe
2.
12 Erros de Construção Relacionados ao JRE_LIB Podem Ocorrer ao Utilizar uma Área de Trabalho
Versão 5.0 Beta
2.13
Necessário Redefinir Variáveis de Caminho se Você Importar Definição de Preferência de Outra Instalação do WebSphere Studio
2.14 Criação de Projeto Simples
Deveria Abrir a Perspectiva Resource
2.15 Recursos Vinculados e
Várias Pastas de Saída
2.16 O Modo Overwrite Não Pode Ser Desativado para AbstractTextEditor e Subclasses
2.17 Trabalhando com Projetos e Arquivos Grandes
3.0 Problemas Conhecidos com os Editores
3.1 Marcadores Não São Removidos Adequadamente
3.2
O Editor HTML e JSP Padrão Não Suporta Idiomas Bidirecionais
4.0 Executando em Diferentes VMs
4.1 Executando em J9
5.0
Erros de Programa Causados por utc.dll
6.0 Ant
6.1
Preferred Output Level na Página de Preferências External Tools não tem Efeito para Ant
6.2 A UI de Ant nas External Tools não Trata de Entradas ENTITY em Todos os Casos
6.3
JAR de Xerces Não São Mais Necessárias no Classpath Ant de Tempo de
Execução
6.4 Tarefas Ant e Tipos Ant
Personalizados Devem Ser Separados de JARs da Biblioteca de
Plug-ins
6.5 Construções
Ant Simultâneas Não São Suportadas
6.6
Execução de Certas Tarefas Ant Causam Fugas de Memória
6.7
Tarefas Que Exigem Entrada Bloqueiam o Espaço de Trabalho
6.8
Conclusão de Código do Editor Ant Baseada no Ant 1.5
Após a instalação, o workbench é iniciado executando-se o programa executável localizado no diretório de instalação de nível máximo.
Por padrão, o workbench cria um diretório chamado workspace. Esse diretório é utilizado como a área de conteúdo padrão para seus projetos, bem como para receber todos os metadados requeridos. Para instalações de áreas de trabalhos múltiplas ou compartilhadas, você deve determinar explicitamente a localização da área de trabalho em vez de usar o padrão. Há dois meios de controlar a localização da área de trabalho: utilizando o diretório de trabalho atual ou utilizando o argumento -data da linha de comando.
A maneira mais fácil de utilizar o diretório de trabalho atual é criar um atalho utilizando as seguintes etapas:
Outras opções são incluir o argumento -data (por exemplo, -data c:\myworkspace) na linha Target no atalho ou iniciar o programa a partir de um prompt de comandos e incluir o argumento -data .
O lançamento do WebSphere Studio falhará se ele estiver instalado em um diretório cujo caminho contenha determinados caracteres inválidos, incluindo :%#<>"!.
O Eclipse (a plataforma na qual o WebSphere Studio é construído) oferece uma série de opções de execução que são de interesse das pessoas que desenvolvem ou depuram plug-ins. A forma geral de execução de um executável é:
platform [platform options] [-vmargs [Java VM arguments]]
sendo que platform é o nome do executável encontrado no nível superior do diretório de instalação e as opções de plataforma válidas são:
-application <app id> | Identifica o aplicativo a ser executado. Se não for especificado, o workbench será executado. Os aplicativos são declarados pelos plug-ins fornecendo extensões para os pontos de extensão do org.eclipse.core.runtime.applications. |
-boot <boot code path> | Define o caminho do código de plug-in de inicialização (que é, boot.jar). Somente necessário durante a alteração da localização relativa de startup.jar e boot.jar. |
-consolelog | Espelha o log de erros da plataforma para o console utilizado para executar a plataforma. |
-data <workspace path> | Define o caminho da área de trabalho em que a plataforma será executada. |
-debug [options file path] | Coloca a plataforma em modo de depuração e carrega as opções de depuração no arquivo especificado. Se um caminho de arquivo não for fornecido, a plataforma procurará um arquivo chamado .options no diretório de instalação da plataforma e no diretório de metadados da área trabalho. |
-dev [classpath entries] | Coloca a plataforma no modo de desenvolvimento. As entradas opcionais do caminho da classe (uma lista separada por vírgulas) são incluídas no caminho da classe de cada plug-in. Por exemplo, ao desenvolver plug-ins, utilize -dev bin para incluir o diretório bin da ferramenta JavaTM para cada plug-in. As entradas do caminho da classe redundantes ou inexistentes são eliminadas. |
-nosplash | Executa a plataforma sem utilizar a tela principal. |
-os <os-id> | Define o sistema operacional no qual a plataforma está sendo executada. Normalmente, a plataforma pode detectar o OS, mas algumas situações podem requerer especificação explícita. O valor especificado aqui relaciona-se à Platform.getOS(). |
-vm <vm path> | Especifica a Java VM a ser utilizada para executar a plataforma. Se não for especificada, uma Java VM será localizada em relação ao executável. |
-ws <ws-id> | Define o sistema de janelas no qual a plataforma está sendo executada. Em muitos casos, a plataforma pode detectar o sistema de janelas, mas algumas situações podem requerer especificação explícita. O valor especificado aqui relaciona-se à Platform.getWS(). |
Todos os argumentos após (mas não incluindo) a entrada -vmargs são transmitidos diretamente para a Java VM indicada como argumentos da máquina virtual (ou seja, antes da classe ser executada). Todos os argumentos que precedem a entrada -vmargs (com exceção de -vm e -nosplash) são transmitidos diretamente para a plataforma para interpretação.
Se você desejar que a localização de sua área de trabalho seja exibida na barra de título do workbench, será necessário iniciar o WebSphere Studio utilizando o seguinte comando:
WS_installdir\wssitedev.exe -showlocation -data c:\workspace
em que WS_installdir é a localização na qual você instalou o WebSphere Studio e c:\workspace é a localização de sua área de trabalho.
Você pode iniciar o WebSphere Studio a partir de um prompt de comandos, utilizando esse comando ou alterar o atalho do desktop.
Para acessar um site de atualização através de um proxy, é preciso iniciar o workbench com as seguintes opções da linha de comandos:
wssitedev.exe -vmargs -DproxySet=true -DproxyHost=<nome_do_proxy> -DproxyPort=<porta_do_proxy>
Proxies que exigem autenticação do usuário não são suportados atualmente.
Quando o WebSphere Studio Versão 5.1 é iniciado pela primeira vez utilizando um espaço de trabalho existente do WebSphere Studio Versão 5.0, uma caixa de diálogo aparece mostrando uma maneira de migrar da Versão 5.0 para a Versão 5.1. Clique em OK para migrar o espaço de trabalho da Versão 5.0 para a Versão 5.1 ou clique em Cancel para impedir o início do WebSphere Studio.
Quando o espaço de trabalho é migrado para a Versão 5.1 ainda é possível utilizá-lo com a Versão 5.0, pois os metadados dos novos recursos de projeto da Versão 5.1 são ignorados e podem ser lidos pela Versão 5.0. Não é possível fazer nenhuma alteração na Versão 5.0 aos projetos no espaço de trabalho que teriam efeito sobre os metadados ou sobrescreveriam os metadados dos novos recursos de projeto para projetos da Versão 5.1.
Para obter informações adicionais sobre os novos recursos de projeto na Versão 5.1, consulte o Guia de Migração do WebSphere Studio.
Os seguintes problemas com a UI do workbench nesse release são conhecidos.
Quando arquivos dentro de um projeto são incluídos fora do WebSphere Studio ou quando um editor externo é utilizado para modificar um arquivo dentro de um projeto, uma atualização manual deve ser feita para que as alterações sejam mostradas no workbench. Para fazer isso, selecione o projeto na exibição Navigator e clique em Refresh em seu menu pop-up. Isso atualiza apenas o projeto selecionado. Clique em F5 para atualizar todos os projetos.
Os seguintes problemas conhecidos podem ocorrer ao utilizar documentos OLE no workbench (por exemplo, editando um arquivo .doc no Word ou WordPad).
O estado dirty de um documento OLE não é atualizado corretamente. Isso faz com que o workbench solicite a você para salvar o conteúdo de um documento quando ele é fechado, mesmo se o conteúdo já tiver sido salvo.
Se ocorrer uma falha do documento OLE, os menus do workbench poderão ficar inconsistentes ou ocorrerá a saída repentina do WebSphere Studio.
A interface do usuário do workbench é composta de exibições e editores. A exibição ou o editor que está em foco tem a sua guia destacada em azul. O componente da interface do usuário em destaque tem o controle e, no caso de editores, determina a contribuição feita à árvore de menus e ao conjunto de ícones de ação comuns no workbench. Ou seja, quando um editor é ativado as opções do menu e os ícones de ação adicionais podem aparecer na interface do usuário do workbench. Ao trabalhar com um recurso em um editor, você também pode interagir com uma exibição que suporte o editor (tal como a exibição Outline que suporta o editor de origem Java). Quando a exibição é focalizada, as opções de menu e os ícones de ação associados ao editor podem desaparecer. Para tornar novamente visíveis as opções de menu e os ícones de ação, ative o editor.
Há várias técnicas que você pode utilizar para ativar o editor. A técnica requerida pode depender do tipo de editor que estiver sendo utilizado.
Para ativar o editor, você deve clicar na guia de título ou numa área que pode ser editada dentro do próprio editor.
Existem ocasiões, após ter seguido um padrão específico de cliques, em que o editor mantém-se em foco (quando sua guia do título está em azul), mesmo quando você clicou em outro lugar, tal como em uma entrada em outra exibição. Por exemplo, quando o editor DTD for aberto e a exibição Outline estiver visível, proceda da seguinte forma:
Esse comportamento mantém as contribuições do editor ao menu e aos ícones de ação ativas, mesmo quando você interage com outra exibição. Você ainda pode pedir o menu de contexto para a entrada selecionada na exibição. O único problema é que isso parece estranho quando o título em azul está dizendo que o foco ainda está no editor.
Alguns editores são afetados por outro problema relacionado a como e quando o foco é alterado. As entradas feitas em um campo de texto apenas são registradas como uma alteração ao campo quando perde-se o foco. Se você inserir dados em um campo, como o campo de mapeamento de URI no editor web.xml e simplesmente clicar na área cinza da página do editor, os dados inseridos não serão vistos como uma alteração ao campo. Os dados inseridos são registrados como uma alteração se você executar uma das seguintes ações:
O editor informará a você quando uma alteração tiver sido registrada, incluindo um asterisco (*) na frente do nome do arquivo mostrado na guia do editor.
Avisos e erros de validação, erros do compilador e mensagens são mostrados na exibição Tasks. Para colar o texto em um arquivo, selecione as linhas das tarefas relevantes e arraste os itens para um editor apropriado (como o Wordpad). Suas tarefas aparecerão em um formato de relatório organizado.
Se você alterar as fontes do workbench no diálogo Preferences para uma fonte não-DBCS (por exemplo, Arial) em uma máquina que esteja executando um idioma DBCS, os caracteres DBCS aparecerão como pontos de interrogação; este é o comportamento esperado. No entanto, quando você alterar novamente a fonte para uma fonte suportada por DBCS, assegure-se de especificar a definição do script no diálogo de fontes ao mesmo tempo que define a fonte. Se estas duas definições não forem feitas ao mesmo tempo, os caracteres DBCS permanecerão como pontos de interrogação. Outra solução para este problema é clicar no botão Use System Font na página de Preferências Workbench Font.
É recomendável que os usuários do DBCS alterem as fontes utilizadas para exibir texto no WebSphere Studio. Você pode alterar as fontes na página Fonts (Window > Preferences > Workbench > Fonts) da janela Preferences.
É recomendável utilizar as seguintes fontes:
Quando um espaço de trabalho criado com uma versão anterior do WebSphere Studio é aberto pela primeira vez na versão atual do WebSphere Studio, podem ocorrer erros quando uma perspectiva é restaurada. Se isso acontecer, selecione Window >Reset Perspective na barra de menus para restaurar a perspectiva. Para evitar esses erros, feche todas as perspectivas no espaço de trabalho na versão anterior do WebSphere Studio antes de migrar para a versão atual.
Uma série de caixas de diálogo no WebSphere Studio, como a caixa de diálogo Preferences, requerem uma resolução mínima de vídeo de, pelo menos, 800 x 600.
Quando uma ferramenta externa é lançada, as variáveis de caminho expandidas que contêm espaços são colocadas automaticamente entre aspas duplas ( " " ). Embora seja normal que os programas do Windows coloquem os caminhos que contêm espaços entre aspas, isso pode causar problemas em outras plataformas. Uma solução alternativa é criar um script para a ferramenta externa que remova as aspas antes de lançar o programa com esses parâmetros.
O valor Text file encoding exibido na caixa de diálogo Preferences em Workbench > Editors pode estar incorreto em plataformas que executam o Windows XP (ou 2000) quando o locale do usuário e o locale do sistema são diferentes.
Por exemplo, suponha que um usuário esteja utilizando o Windows 2000 Japonês, mas esteja trabalhando nos Estados Unidos. O usuário selecionou English (United States) como o locale do usuário. O valor Text File Encoding exibido pelo WebSphere Studio está incorreto: Cp1252 (Inglês). Ele deve exibir o locale do sistema: MS932 (Japanese).
Para solucionar isso, você pode alterar o locale do usuário de modo que os locales do usuário e do sistema sejam idênticos. No exemplo acima, isso significa que você deve definir Japanese como o locale do usuário, em seguida, iniciar novamente o WebSphere Studio. O valor Text file encoding ficará, então, correto: MS932 (Japonês).
No Windows XP:
No Windows 2000:
Os clientes das barras de ação podem criar uma série de SubToolBarManagers
em seu IToolBarManager
(por exemplo, um editor de várias páginas). O cliente
normalmente tornará visível um SubToolBarManager
, o restante ficará invisível e chamará updateActionBars
. A visibilidade dos itens pode não ser
atualizada corretamente.
Uma solução alternativa é o cliente atualizar explicitamente a barra de ferramentas:
actionBars.updateActionBars();
actionBars.getToolBarManager().update(false);
Determinadas teclas de atalho não funcionam com um layout de teclado Árabe. Você pode solucionar isso alterando o layout do teclado para English.
Ao utilizar uma área de trabalho do WebSphere Studio Versão 5.0 Beta, poderão ocorrer erros relacionados ao JRE_LIB. Para corrigir isso, siga estas etapas:
Erros de JRE_LIB não devem ocorrer quando o projeto é reconstruído.
Se você importar definições de preferência no WebSphere Studio vindas de outra instalação do WebSphere Studio, você pode receber erros de compilação referentes a bibliotecas ausentes. Para redefinir as variáveis de caminho de classe corretamente, feche qualquer perspectiva XML aberta. Depois, feche o workbench, reinicie-o e abra a perspectiva XML.
Quando você cria um projeto simples no WebSphere Studio (File > New > Other Simple > Project) deveria ser solicitado a alternar para a perspectiva Resource, mas isso não acontece. Para solucionar isso, mude manualmente para a perspectiva Resource (Window > Open Perspective > Other > Resource) depois de haver criado seu projeto simples.
Recursos vinculados e várias pastas de saída não são suportados nesta versão do WebSphere Studio.
Ao remover a ligação de tecla para o comando "Toggle Overwrite Mode" na página de preferências Workbench > Keys, o modo ainda é alternado ao pressionar a tecla Insert. A indicação do modo na linha de status do editor fica então fora de sincronismo com o modo real.
Se tiver problemas de OutOfMemoryError quando trabalhar com projetos e arquivos grandes, o tamanho do heap pode ser aumentado utilizando as opções da linha de comandos -vmargs -Xmx500M, quando iniciar o wsappdev.exe. Ajuste o 500M (500 mega) para uma quantidade apropriada para sua situação.
Os seguintes problemas com os editores são conhecidos.
Quando você inclui marcadores em texto não-salvo, eles não são atualizados ou removidos de modo apropriado se o editor for fechado sem que as alterações do texto sejam salvas. Depois de fechar o editor, os marcadores podem apontar para regiões de texto não-existentes ou não relacionadas.
O editor HTML e JSP padrão não suporta idiomas bidirecionais. Se você estiver trabalhando com um idioma bidirecional, deverá configurar o Page Designer "Classic" como seu editor padrão para arquivos HTML ou JSP. Para fazer isso, selecione Window > Preferences > Workbench > File Associations e altere as associações nesta página. Para obter mais informações sobre como ativar o Page Designer Classic e alterar as associações, consulte o readme das ferramentas da Web.
Quando executar em J9, é recomendável utilizar as seguintes opções de VM. Consulte a documentação e a ajuda da J9 VM para obter informações adicionais:
platform [arguments] -vm <path to j9w.exe> -vmargs -ms:20 -jit -mo:32000 -mx:200000
sendo que platform é o nome do executável encontrado no nível superior do diretório de instalação e arguments são os argumentos a ser fornecidos à plataforma.
NOTA: o flag -vmargs e os argumentos da VM real devem vir no final da linha.
Se você receber um erro de programa no utc.dll, deverá lançar o WebSphere Studio a partir de seu arquivo .exe. O arquivo de definições de configuração (no mesmo diretório que o arquivo .exe - ele termina com .ini) também deve conter a seguinte entrada na seção [Environment Variables]:
JITC_COMPILEOPT=SKIP{org/eclipse/ui/views/tasklist/TaskListContentProvider}
{resourceChanged}
Se você lançar o WebSphere Studio a partir do atalho criado no menu Start, a entrada já foi incluída.
Se um script Ant for executado como uma ferramenta externa ou utilizando o menu pop-up Run Ant,
ele será executado na mesma Java VM que o WebSphere Studio. Se o script em execução
executar qualquer tarefa do Ant que chame o System.exit(int)
, o WebSphere Studio sairá e
qualquer trabalho não salvo será perdido. Uma solução alternativa para essas tarefas do Ant é configurar o Ant
como uma ferramenta externa. As etapas a seguir mostram como isso é feito:
- Faça download e instale a versão binária de Ant a partir de http://jakarta.apache.org/ant
- Clique em Run > External Tools > Configure.
- Clique em New.
- Insira um nome para a sua ferramenta externa (por exemplo, External Ant).
- Clique em Browse File System.
- Localize e selecione um arquivo denominado
ant.bat
(ele deve estar na pasta bin/ de sua instalação do Ant).- No campo Tool Arguments, insira os argumentos para o script que normalmente seriam inseridos para executá-lo fora do workbench.
- No Working directory, digite o diretório de seu script.
- Clique em OK para sair do assistente.
- Para executar o script, clique em Run > External Tools > External Ant.
Em Window > Preferences > External Tools, há um grupo de botões de rádio sob o título Preferred output level - Information, Verbose e Debug. A alteração desses valores não afeta o WebSphere Studio de nenhuma maneira.
Ao
executar um script Ant, utilize os argumentos de linha de comando do Ant -verbose
ou -debug
para obter um nível de saída diferente do padrão
(Information).
A UI de Ant no WebSphere Studio resolve corretamente as entidades com valores de sistema baseados em URI,
especificando o protocolo "file:"
. Outros formatos e
protocolos, como caminhos relativos, URIs "http:"
e
assim por diante, são resolvidos pelo analisador de XML padrão do usuário, que pode variar
por JRE, definições do usuário, etc. Os analisadores, como o org.apache.crimson.parser
, por
exemplo, esperam apenas URIs válidos e falharão em uma referência de entidade, tal como
esta:
<!ENTITY custom SYSTEM "../../custom.xml">
A solução alternativa para este problema é assegurar que você inclua o especificador de protocolo "file:"
nos caminhos relativos, conforme a seguir:
<!ENTITY custom SYSTEM "file:../../custom.xml">
Esse problema ocorre apenas na UI, uma vez que o mecanismo de execução Ant no WebSphere Studio utiliza o SAXParser
, que resolve corretamente os formatos, como caminhos relativos.
Adicionar explicitamente os JARs de Xerces ao classpath de tempo
de execução de Ant não é mais necessário e pode causar problemas. As
classes Xerces são carregadas do plug-in
org.apache.xerces
fornecido com o Eclipse. Para a
maioria das distribuições de Ant, os JARS de Xerces nem mesmo
podem estar na mesma localização física de ant.jar
e
optional.jar
. Isto resulta do fato de os JARs de Ant
conterem arquivos de manifesto os quais contêm entradas de classpath
que apontam para os JARs de Xerces.
A inclusão dos arquivos de classe para tarefas Ant e tipos Ant
personalizados no JAR de código regular para seu plug-in causa
problemas. Esses arquivos de classe devem ser fornecidos eu um JAR
separado que é contribuído para o ponto de extensão
org.eclipse.ant.core.antTasks
ou antTypes
(e não declarado como uma biblioteca no manifesto do plug-in). Isso
assegura que as tarefas e os tipos Ant sejam carregados pelo
carregador de classe Ant especial e não por um carregador de classe
de plug-in.
O Eclipse executa o Ant na mesma JVM do resto do WebSphere Studio. Vários aspectos do Ant e sua utilização de recursos Java globais (tais como System.out e System.err), tornam inseguro executar mais que uma construção Ant simultaneamente.
Sabe-se que certas tarefas do Ant causam fugas de memória.
Como ocorre com a utilização do Ant a partir da linha de comandos, solicitações de entrada do console não são manipuladas. Isto não é o mesmo que fazer uso da tarefa <input>, a qual funciona corretamente dentro do WebSphere Studio.
A conclusão de código fornecida pelo editor Ant não respeita a
versão especificada pelo usuário do plug-in
org.eclipse.ant.core
ou ANT_HOME.
As propostas de conclusão do código são sempre baseadas no Ant 1.5.
Retornar para o arquivo leia-me principal
(C) Copyright IBM Corporation 2000, 2003. Todos os Direitos Reservados.