Skip to content

AlencarGabriel/advpl-switch-project

Repository files navigation

Version Installs Downloads Rating

AdvPL Project Manager

Esta é a extensão que vai facilitar seus Debugs de projetos AdvPL com arquivos repetidos, e ainda a organizar melhor os projetos x ambientes.

Estou muito feliz pelo seu Download e espero que goste!

Necessidade

Assim como acontecia com o tão querido (e descontinuado) TDS Eclipse, quando há arquivos com o mesmo nome no Workspace, o Debug se "perde" ao mostrá-lo para depurar.

Porém no VSCode não há a opção: Fechar Projeto. Esta extensão irá te ajudar a resolver este impasse em alguns minutos, basta fazer algumas configurações e pronto ;)

Features

Esta extensão possui as seguintes funcionalidades implementadas:

  • [New] Habilitar/desabilitar todos os ambientes pela View de Gerenciamento de Ambientes;
  • [New] Mostrar o caminho do projeto na lista de seleção de Projetos;
  • [New] Associar um ambiente da lista ao Projeto Ativo;
  • [New] Definir ambiente Default para o Projeto;
    • Agora será considerado nas alternâncias de ambiente/projeto o ambiente default, não o primeiro da lista;
  • Habilitar/Desabilitar todos os Projetos;
  • Alterar ambiente ativo ao trocar de Projeto;
  • Mostrar todos os ambientes caso o Projeto não tenha ambientes relacionados;
  • Relacionar ambientes do AdvPL com o Projeto aberto;
  • Habilitar/Desabilitar todos os ambientes AdvPL;
  • Trocar projeto ativo no Workspace;
  • Remover últimos projetos.

Próximas implementações:

Looking For...

  • [pt-br] Alguem que possa me ajudar com a tradução dessa extensão para Inglês, Espanhol ou Russo. Caso tenha interesse entre em contato comigo
  • [en-us] Someone who can help me with the translation of this extension to English, Spanish or Russian. If you are interested in contact me
  • [es es] Alguien que pueda ayudarme con la traducción de esta extensión a Inglés, Español o Ruso. Si tiene interés entre en contacto conmigo
  • [ru ru] Тот, кто может помочь мне с переводом этого расширения на английский, испанский или русский. Если вы заинтересованы в свяжитесь со мной

Requisitos para utilização

Esta extensão depende da advpl-vscode desenvolvida por Rodrigo Antonio Godinho da Silva.

Obs.: Atualmente esta extensão ainda não é 100% compatível com a tds-vscode.

Configuração

Por padrão o VSCode adiciona no Workspace Settings as pastas do Workspace. Esta extensão manipula esta configuração conforme o projeto que está sendo usado.

No fim deste arquivo há um exemplo de configuração.

Configuração

Vídeo Exemplo

Utilização

A extensão é ativada sempre que um projeto AdvPL é aberto, ou o comando é chamado o comando Trocar Projeto manualmente.

Esta extensão não reabre os arquivos que já estão abertos no editor.

Utilização

Vídeo Exemplo

Relacionar Ambiente x Projeto

É possível relacionar os ambientes da configuração advpl.environments com os projetos configurados no workspace advpl.foldersProject. Assim é possível organizar melhor os ambientes que estarão disponíveis na lista.

No fim deste arquivo há um exemplo de configuração.

Este recurso só funcionará se a configuração advpl.onlyRelatedEnvironments estiver habilitada.

Importante:

  • Caso a configuração advpl.environments esteja nas Configurações do Usuário, deve ser transferido para as Configurações do Workspace;
  • Após transferir as configurações reinicie o VSCode;
  • Caso esteja usando o atributo name na configuração advpl.environments, deve estar no advpl.foldersProject.environments[] o nome dos ambientes, se não estiver usando name a extensão irá considerar o atributo environment.

Relacionar Ambiente x Projeto

Vídeo Exemplo

Caso encontre algum problema, tenha alguma dúvida ou sugestão de melhoria, fique a vontade para abrir uma Issue ou enviar um Pull Request.

Comandos da Extensão

Command Palette:

  • Advpl - Trocar projeto ativo
  • Advpl - Remover últimos projetos
  • Advpl - Habilitar todos os Ambientes
  • Advpl - Desabilitar Ambientes fora do Projeto
  • Advpl - Desabilitar todos os Projetos
  • Advpl - Habilitar todos os Projetos

View item context - Gerenciador de Ambientes:

  • Definir [ambiente] como Padrão [do Projeto]
  • Associar [Ambiente] ao Projeto
  • Desassociar [Ambiente] do Projeto

Configurações da Extensão

Esta extensão contribui com as seguintes configurações:

  • advpl.onlyRelatedEnvironments: false; // true = Mostrar somente os ambientes vinculados ao projeto

  • advpl.projectActive: "Projeto padrão do Workspace";

  • advpl.showProjectPath": true; // true = Mostra o caminho do projeto na lista de Projetos

  • Pastas do projeto:

"advpl.foldersProject": [
    {
        "path": "Caminho da pasta do projeto",
        "name": "Alias para o projeto",
        "environments": [
            "Environment A",
            "Environment B"
        ], // Ambientes da configuração advpl.environments relacionados a este projeto
        "environment_default": "Ambiente padrão do Projeto"
    }
]

Aproveite, me ajuda e com certeza irá te ajudar tambem! ❤️


Esta extensão foi criada e é mantida pela comunidade. Não tem nenhum vínculo direto ou indireto com a TOTVS®, qualquer uma de suas franquias ou qualquer um de seus representantes. TDS é um produto criado e mantido pela TOTVS®. Esta extensão tem como objetivo apenas prover recursos que facilitem o gerenciamento de projetos AdvPL no VsCode.