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 o Espaço de Trabalho 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 Interface com o Usuário Não Respondendo
2.3 Copiando Itens da Lista Tasks
2.4 Questões de Fontes DBCS
2.5 Resolução Mínima do Vídeo
2.6 As Ferramentas Externas Colocarão Automaticamente as Variáveis do Caminho com Espaços entre Aspas
2.7
Atualizando a Barra de Ferramentas em Editores de Várias Páginas
2.8
Determinadas Teclas de Atalho Não Funcionam com um Layout de Teclado em Árabe
2.9 As Teclas Control Não Funcionam com NumLock Ativado
2.10
Não Executar Vários Workbenches no Mesmo Diretório de Espaço de Trabalho
2.11 Erros de Intensidade de Cor Não-suportados
2.12 Copy Não Funciona nas Caixas de Combinação Somente Leitura
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 Erros Podem Ser Encontrados ao Restaurar uma Perspectiva para um Espaço de Trabalho
Migrado
2.15 Movendo Exibições Quando
Motif For Seu Sistema de Exibição de Janelas
2.16 A Criação de um Projeto Simples Deveria Abrir a Perspectiva Resource
2.17 Recursos Vinculados e
Várias Pastas de Saída
2.18 KDE Utiliza Teclas Ctrl+Fn
2.19 O Modo Sobrescrever Não Pode Ser Desativado para AbstractTextEditor e para Subclasses
2.20 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
Os Jars Xerces Não São Mais Requeridos no Classpath Ant de Tempo de Execução
6.4 As Tarefas Ant e os Tipos Ant Personalizados Devem Ser
Separados dos JARs da Biblioteca de Plug-ins
6.5 Compilações Ant Simultâneas Não-suportadas
6.6 A Execução de Determinadas Tarefas Ant Causou Fuga de Memória
6.7 Tarefas que Requerem Espaço de Trabalho com Trava de Entrada
6.8 Conclusão do Código do Ant Editor Baseada no Ant 1.5
7.0 Questões do Linux GTK
7.1 Tradução de Determinados Diálogos do S.O. Faltando
7.2 Suporte a DBCS no Linux GTK
7.3 Utilizando Versões Diferentes do GTK
7.4 Problemas na Tradução de Coreano no GTK
2.2.0
7.5 O Método de Entrada de Japonês Pára de Funcionar Depois de Chamar a
Janela Candidata
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\wsappdev50 -showlocation -data /workspace
em que WS_installdir é a localização na qual o WebSphere Studio foi instalado e /workspace é a localização de seu espaço 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, será necessário iniciar o workbench com as seguintes opções da linha de comandos:
wsappdev50 -vmargs -DproxySet=true -DproxyHost=<proxy_name> -DproxyPort=<proxy_port>
Os proxies que requerem autenticação do usuário não são atualmente suportados.
Quando o WebSphere Studio Versão 5.1 for iniciado pela primeira vez utilizando um espaço de trabalho existente do WebSphere Studio Versão 5.0, aparecerá uma caixa de diálogo mostrando uma maneira para migrar da Versão 5.0 para a Versão 5.1. Clique em OK para migrar o espaço de trabalho Versão 5.0 para a Versão 5.1 ou clique em Cancel para impedir que o WebSphere Studio seja iniciado.
Depois do espaço de trabalho ser migrado para a Versão 5.1, ele ainda poderá ser utilizado com a Versão 5.0 já que os metadados dos novos recursos do 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 nos projetos do espaço de trabalho que efetuariam os metadados ou sobrescreveriam os metadados do novo recurso do projeto dos projetos da Versão 5.1.
Para obter informações adicionais sobre os novos recursos do projeto na Versão 5.1, consulte o WebSphere Studio Migration Guide.
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.
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:
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.
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.
Se Ctrl-s, Ctrl-space ou outras combinações de teclas Ctrl não estiverem funcionando, pressione a tecla NumLock para desativar NumLock.
Não é válido iniciar o workbench duas vezes utilizando o mesmo diretório da área de trabalho. Se isso for feito, ocorrerão resultados imprevisíveis. A localização padrão do diretório do espaço de trabalho é ~/workspace e pode ser substituída pela especificação de um diretório diferente com o sinalizador -data, da seguinte forma: wsappdev50 -data /home/username/newworkspace
Ao lançar o workbench, se você receber um erro referente à profundidade de cores não suportadas, será necessário alterar a profundidade de cores de seu vídeo para um valor diferente de 15 ou 32 bpp. Isto requer que o servidor X seja reiniciado. Consulte a documentação do sistema para obter instruções sobre como fazer isso.
A cópia de texto de uma caixa de combinação somente leitura atualmente não funciona no Linux.
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 um espaço de trabalho criado com uma versão anterior do WebSphere Studio for aberto pela primeira vez na versão atual do WebSphere Studio, você poderá encontrar erros quando uma perspectiva for restaurada. Se encontrar, selecione Window >Reset Perspective na barra de menus para restaurar a perspectiva. Para evitar esses erros, feche todas as perspectivas de seu espaço de trabalho na versão anterior do WebSphere Studio antes de migrar para a versão atual.
Se você estiver trabalhando com o WebSphere Studio no Linux e seu sistema de exibição de janelas for Motif, você deverá selecionar uma exibição com o botão central do mouse para poder movê-la. Por outro lado, se você tiver um mouse com dois botões, mantenha os dois botões pressionados ao selecionar uma exibição se desejar movê-la.
Ao criar um projeto simples no WebSphere Studio (File > New > Other Simple > Project), deveria ser solicitado que você fosse para a perspectiva Resource, mas não é. A solução alternativa para esse problema é alternar manualmente para a perspectiva Resource (Window > Open Perspective > Other > Resource) depois de ter criado seu projeto simples.
Recursos vinculados e várias pastas de saída não são suportados nessa versão do Websphere Studio.
Ao utilizar o desktop KDE nos sistemas Linux, as seqüências de teclas Ctrl+Fn são utilizadas para alternar entre os desktops virtuais. Isso significa que os comandos do WebSphere Studio ligados a essas seqüências de teclas não são ativados, incluindo Ctrl+F1 (Help), Ctrl+F4 (File > Close) e Ctrl+F6 (Next Editor).
Essas teclas podem ser atribuídas novamente no KDE utilizando o Control Center. Selecione Look & Feel > Shortcuts > Shortcut Sequences > Shortcut Sequences > System > Desktop Switching e defina todos os itens para None ou para uma seqüência de teclas diferente, como Ctrl+Alt+Fn. A outra alternativa é atribuir diferentes seqüências de teclas no WebSphere Studio utilizando a página de preferências Windows > Preferences > Workbench > Keys.
Ao remover a ligação de tecla do comando "Toggle Overwrite Mode" na página de preferências Workbench > Keys, o modo ainda é alternado quando você pressiona a tecla Insert. A indicação do modo na linha de status do editor estará, então, dessincronizada do 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 WebSphere Studio. 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 Xerces ao classpath Ant de tempo de execução não é mais necessário e pode causar problemas. As classes Xerces são carregadas a partir do plug-in org.apache.xerces
fornecido com o Eclipse. Para a maioria das distribuições Ant, os JARs Xerces não podem nem estar na mesma localização física que o
ant.jar
e o optional.jar
. Isso ocorre porque os JARs Ant
contêm arquivos de manifesto que contêm entradas de classpath que apontam para os JARs
Xerces.
Incluir os arquivos de classe para as tarefas Ant ou os tipos Ant personalizados no código JAR comum para seu plug-in causa problemas. Esses arquivos de classe devem ser fornecidos em um JAR separado contribuído para o ponto de extensão org.eclipse.ant.core.antTasks
ou antTypes
(e não declarados como uma biblioteca no manifesto do
plug-in). Isso assegura que as tarefas e os tipos Ant sejam carregados pelo carregador de classes Ant especial e não pelo carregador de classes do plug-in.
O Eclipse executa Ant na mesma JVM que o restante do WebSphere Studio. Vários aspectos do Ant e sua utilização de recursos Java globais (como System.out e System.err), tornam inseguro executar mais de uma compilação Ant simultaneamente.
Sabe-se que determinadas tarefas Ant ocasionam fuga de memória.
Assim como utilizar Ant a partir da linha de comandos, prompts de entrada do console não podem ser tratados. Isso não é o mesmo que utilizar a tarefa <input>, que funciona corretamente com o WebSphere Studio.
A conclusão do código fornecida pelo Ant editor não respeita a versão especificada pelo usuário do plug-in org.eclipse.ant.core
nem ANT_HOME.
As propostas de conclusão do código sempre são baseadas no 1.5.
A seguir estão questões do Linux GTK.
Os diálogos do sistema operacional para selecionar arquivos ou pastas estão traduzidos apenas parcialmente no GTK 2.0.6 ou no GTK 2.2. Esses diálogos e as mensagens não-traduzidas vêm do GTK, não do WebSphere Studio.
As versões do GTK fornecidas com o Red Hat Linux 8.0 e o SuSE Linux 8.1 suportam locales Latin-1, mas não DBCS. O suporte a DBCS no GTK 2.2 deve ser suficiente e o WebSphere Studio deve funcionar em qualquer edição Linux com GTK 2.2.
Os usuários que fizerem download e compilarem novas versões do GTK, por exemplo, para obter suporte a DBCS no GTK 2.2.0 no RedHat 8.0, precisarão assegurar que as bibliotecas corretas do GTK estejam listadas na variável de ambiente LD_LIBRARY_PATH. Por padrão, as bibliotecas GTK compiladas são colocadas no /user/local/lib/, portanto, o seguinte precisaria ser executado antes de ativar o WebSphere Studio.
export LD_LIBRARY_PATH=/usr/local/lib/
Nota: Isso deve ser feito para cada nova sessão de terminal.
Os usuários que fizerem download e compilarem novas versões do GTK (por exemplo, para obter suporte a DBCS no GTK 2.2.0) poderão encontrar os seguintes problemas ao utilizar a tradução de coreano:
Recomendamos definir Dialog Font e Banner Font para uma fonte gothic. A fonte pode ser alterada na página de preferências Workbench > Fonts.
A solução alternativa para o problema de redimensionamento das janelas é definir uma resolução de tela alta (por exemplo, 1280x1024)
A solução alternativa para a questão da exibição Properties é utilizar as teclas de seta. Utilize a tecla de seta para a esquerda para reduzir itens e a tecla de seta para a direita para expandi-los.
Se você utilizar kinput2 e canna para entrada de japonês canji na versão do GTK, o método de entrada de japonês às vezes pára de funcionar. Isso ocorre somente depois de "Candidate Selection Window" ser aberta. Quando esse problema ocorrer, você precisa fechar o Editor ou
Exibição uma vez e abri-lo novamente para ativar o método de entrada novamente.
Para evitar esse problema, utilize outro método de entrada, como wnn.
Retornar para o arquivo Readme principal
(C) Copyright IBM Corporation 2000, 2003. Todos os Direitos Reservados.