Skip to content
This repository has been archived by the owner on Apr 16, 2021. It is now read-only.

totvs/tds-eclipse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation


TOTVS Developer Studio para Eclipse (BETA)


Apresentação

O adicional TOTVS Developer Studio, é um conjunto de aplicações e ferramentas que interagem entre si, disponibilizando aos desenvolvedores na plataforma Protheus, um ambiente de desenvolvimento ágil, confortável e poderoso.

Público

Desenvolvedores de produtos na plataforma Protheus, que utilizem uma ou mais das linguagens de programação suportadas pela plataforma.

  • Adv/PL, Adv/PL-asp e suas variantes
  • 4GL (em planejamento)

Requisitos

Conhecimento

  • Sistema operacional adotado
  • Conhecimentos da linguagem a ser utilizada
  • Configuração e execução da plataforma Protheus (desejável)
  • Ambiente Eclipse (desejável)

Sistemas Operacionais

O TDS pode ser utilizado nos sistemas operacionais:

  • Microsoft Windows
  • Linux
  • MAC/OS

Recomenda-se o uso de arquitetura 64 bits.

Plataforma Protheus

O TDS pode ser utilizado nas plataformas Protheus com suporte a:

  • Adv/PL, versão 7.00.101202A ou superior, de acordo com o sistema operacional em uso
  • 4GL, versão 7.00.101202A ou superior, de acordo com o sistema operacional em uso

Verifique a lista de Plataformas Homologadas para servidores.

Principais Funcionalidades e Características

  • Comunicação baseada nos protocolos LSP e DAP
  • Sintaxe destacada
  • Auto complemento
  • Amostras de código
  • Formatação de fontes
  • Compilação de fontes, pastas e área de trabalho (workspace)
  • Depuração de fontes (local e webApp).
  • Geração e aplicação de Pacotes de Atualização
  • Exclusão de fontes do RPO
  • Desfragmentação do RPO
  • Inspetor de objetos do RPO
  • Inspetor de funções do RPO
  • Geração de Serviços Web (webservice) Protheus
  • Monitoramento de servidores
  • Assistentes para geração de códigos
  • Integração com o dicionário de dados
  • E mais aquilo que você inventar e compartlhar com a comunidade

Guia Ultra Rápido e Simplificado

Usuários

A lista de servidores de área de trabalhos com versões anteriores a 11.4 não são compatíveis. Processo de compatibilização planejado (chamados #11 e #12).

Use o instalador (baseado no Oomph) somente se tiver experiência no seu uso.

  1. Obtenha e instale a plataforma Eclipse, dando preferência a sua versão mais recente.
  2. Inicie o Eclipse e instale os adicionais TDS a partir do endereço do sítio de distribuição do TDS.
  3. Inicie (ou abra) uma área de trabalho.
  4. Registre um servidor Protheus na visão Servidores.
  5. Conecte-se ao servidor.
  6. Inicie (ou selecione) um projeto TOTVS.
  7. Inicie (ou abra) um arquivo fonte.
  8. Acione menu de contexto do editor e compile.
  9. Inicie (ou selecione) um executor para depuração/execução.

Colaborador

Para ser um colaborador, faz-se necessário:

  • Ter uma conta no GitHub
  • Conhecimentos em Java
  • Uso da plataforma Eclipse
  • Conhecimentos no desenvolvimento de adicionais para o Eclipse.
  • Conhecimentos básicos no uso da aplicação Maven
  • Conhecimentos no uso de repositórios GIT
  • Conhecimentos no uso das ferramentas de teste JUnit e SWTBot
  1. Obtenha e instale a plataforma Eclipse IDE for RCP and RAP Developers.
  2. Inicie uma área de trabalho nova.
  3. Inicie o Eclipse e instale os adicionais necessários transferindo para sua estação e importando o arquivo colaboratorSettings.p2f
  4. Instale a aplicação Apache Maven Project, versão 3.6.2 (mínima) conforme o seu sistema operacional.
  5. Retorne ao Eclipse, acesse menu Windows | Preferences e na árvore de navegação, localize Maven + Instalations... e registre o Apache Maven Projeto instalado no passo anterior.
  6. Efetue um fork do projeto TDS-Eclipse. Faça o fork a partir do ramo no qual vai efetuar a correção ou do ramo desenv, se for uma nova funcionalidade. Assim, você agiliza o processo de reincorporação.
  7. Importe o projeto a partir do endereço do seu fork.
  8. Execute o lançador br.com.totvs.tds.build.
  9. Após a execução dos scripts Maven, reconstrua todo os projetos acionando o menu Project | Clean....
  10. Pronto para começar a colaborar.
  11. Acesse Abertura e acompanhamento de chamados, localize (ou crie) um e...
  12. DIVIRTA-SE programando :D
  13. Ao terminar a sua colaboração, solicite a incorporação.

Veja outras formas de colaborar no tópico Colaboração abaixo. Leitura complementar: [[Fazendo fork]], [[Estrutura do TDS-Eclipse]], [[Diretrizes de Desenvolvimento]]

Conceitos

Se você nunca usou o TDS ou o Eclipse, recomendamos os tópicos:

  • [[Conceitos]]
  • [[Operações Básicas]]
  • [[Preferências|Preferências]]

Suporte

No caso de dúvidas ou ocorrências, abra um chamado em Abertura e acompanhamento de chamados.

Leitura complementar: [[Ajude-nos a ajudá-lo]]

Colaboração

Você pode contribuir com o TDS de diversas formas. Escolha uma.

Erros, falhas ou sugestões

Caso encontre erros, comportamentos inesperados ou tenha sugestões, entre em contato através de um chamado. Isso vale tanto para ocorrências nos adicionais do TDS, assim como na sua documentação.

Abertura e acompanhamento de chamados

Leitura complementar: [[Ajude-nos a ajudá-lo]]

Documentação

  1. Efetue um fork do repositório (Wiki)[https://github.com/totvs/tds-eclipse/wiki]
  2. Faça as edições que desejar
  3. Requisite a incorporação de suas edições

Recomenda-se que a edição seja efetuada localmente. Leitura complementar: [[Fazendo fork]], [[Edição Local da Documentação]], [[Diretrizes de Documentação]]

Tradução (nova ou revisão)

  1. Execute os mesmos passos do tópico Guid ultra-rápido e simplificado | Colaborador
  2. Faça as edições que desejar
  3. Requisite a incorporação de suas edições

Recomenda-se que a edição seja efetuada localmente. Leitura complementar: [[Fazendo fork]], [[Edição Local da Traduções/Revisão]], [[Diretrizes de Traduções/Revisão]]

Desenvolvimento

  1. Procure um incidente com que possa colaborar. Caso a sua colaboração não se enquadre em nenhum chamado, abra um descrevendo o que irá fazer.
  2. Efetue um fork do repositório TDS Eclipse
  3. Faça o desenvolvimento da nova funcionalidade ou a correção de um chamado
  4. Requisite a incorporação de suas edições

ATENÇÃO: Faça o fork a partir do ramo no qual vai efetuar a correção ou do ramo Desenv, se for uma nova funcionalidade. Fazendo assim, você agiliza o processo de revisão e incorporação.

Leitura complementar: [[Fazendo fork]], [[Estrutura do TDS-Eclipse]], [[Diretrizes de Desenvolvimento]]

Problemas Conhecidos

Problemas Conhecidos

  1. Incompatibilidade da lista de servidores registrados no TDS-VSCode ou em TDS anteriores a versão 11.4. Assim como, a lista de servidores do TDS 11.4 também não é compatível com essas aplicações. Chamados #11 e #12.

  2. Testes automatizados devem ser executados um a um.

  3. Em quedas bruscas do AppServer o LS/DA fica com instância presa (intermitente)