Manual de Configuração e Inicialização de Projetos .Net [Wiki TCE-GO]

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== Manual de Configuração e Inicialização de Projetos .Net ======
===== Pré-Requisitos =====

Toda máquina de desenvolvimento de sistema, deve tem instalados os programas necessários para executar o projeto que deseja alterar o código fonte. Atualmente a equipe de Suporte de Sistemas, tem uma imagem de instalação para máquina de desenvolvimento.

Nessa imagem já vem instalados os seguintes sistemas necessários para o desenvolvimento:
  * Visual Studio 2017 - utilizado para desenvolvimento de sistemas na plataforma .Net Framework 4.5 à 4.8;
  * Visual Studio 2019 - utilizado para desenvolvimento de sistemas na plataforma .Net Core 2.2 à 5;
  * Visual Studio 2022 - utilizado para desenvolvimento de sistemas na plataforma .Net Core 6 ou superior (2023);
  * SDK .Net Framework 4.6, 4.7, e 4.8, e .Net Core 2.2, 5 e 6 instalados no sistema operacional da máquina de desenvolvimento.  

**ATENÇÃO: Caso a máquina do usuário não tenha essas ferramentas de desenvolvimento instaladas, não será possível executar algum projeto de software. Nesse caso, solicite a equipe de Suporte de Sistemas a restauração da máquina, e seja instalada a imagem de máquina de desenvolvimento de sistemas de software.**
===== Artefatos =====

^Artefato^Descrição|-
|[[ pres:gerti:arquitetura:start | Arquitetura de Sistemas de Informação ]]|Documento de Arquitetura de Sistemas de Informação|

===== Abrindo Projetos .NET =====
Para abrir um projeto .Net, devemos ficar atento ao que está descrido na sessão Pré-Requisitos.
==== Estrutura Organizacional ====
A estrutura organizacional de dos projeto .Net, tanto .Net Framework e .Net Core, estão organizados em pacotes, em que na estrutura de projetos .Net, são organizados em projetos dentro da Solution de um projeto criado e organizado no Visual Studio.

A titulo de exemplo, vejamos o projeto Comunicação Oficial que se segue abaixo.

{{ :pres:gerti:manual_config_projetos_net_framework:visualstudio_comunicacao.png?1200 |}}

Os projetos por padrão são organizados nos seguintes pacotes, conforme [[pres:gerti:arquitetura:crud|Documento de Arquitetura de Sistemas]]:
  * Enumeradores;
  * InterfacesFabricas;
  * Negocio;
  * Repositorio; e
  * Servico.

Nos projetos .Net Core, o pacote de Servico, será o pacote do Serviço Web API, como apresentado na imagem acima.
==== Configuração Serviço de Controle de Dependências - NuGet ====
Devemos verificar a configuração do serviço de controle de dependências do projeto NuGet na máquina. Para isso vamos acessar no Visual Studio o menu Tools > NuGet Package Manager > Package Manager Settings.

{{ :pres:gerti:manual_config_projetos_net_framework:package_manager_nuget.png?1200 |}}

Na janela que é apresentada, clicamos na opão Package Sources, a fim de verificar se está incluído o serviço NuGet do TCE-GO, o qual deve ter Source com o link http://nexus-repository.tce.go.gov.br:8081/repository/nuget-group.tce.go.gov.br/, como podemos visualizar na imagem abaixo.

{{ :pres:gerti:manual_config_projetos_net_framework:package_sources.png?1200 |}}

Demos deixar sempre marcado as três opções que estão sendo apresentadas na imagem acima, sendo a primeira para baixar as bibliotecas públicas mantidas por terceitos. A segunda TCE-GO, para baixar as bibliotecas mantidas pela Equipe de Sistemas do TCE-GO. E a terceira e ultima, para baixar das bibliotecas já instaladas na máquina.
==== Restaurando Dependências ====
Para restaurar as dependências do projeto, para qualquer projeto .Net Framework e .Net Core, basta clicar com o botão direito do mouse na Solution do projeto, como apresentado na imagem abaixo, e clicar na opção **Restore NuGet Packages**.

{{ :pres:gerti:manual_config_projetos_net_framework:visualstudio_comunicacao_restorenuget.png?1200 |}}

Ao clicar nesse opção, todos os pacotes incluídos como dependência de algum pacote do projeto da solução, serão baixados caso nunca tinham sido baixados para a máquina do usuário. Esses pacotes estão configurados no arquivo packages.config para projetos em .Net Framework e no projeto .Net Core na pasta Dependencies > Packages, como está sendo apresentado na imagem abaixo.

{{ :pres:gerti:manual_config_projetos_net_framework:visualstudio_docs_servico_packages.png?1200 |}}

{{ :pres:gerti:manual_config_projetos_net_framework:visualstudio_comunicacao_dependenciespackage.png?1200 |}}
==== Adicionando Dependências ====
Para adicionar uma dependência ao projeto devemos clicar com o botão direito do mouse na pasta Dependêncies > Packages ou no próprio projeto, e clicar na opção **Manage NuGet Packages...**, como apresentado na imagem abaixo.

{{ :pres:gerti:manual_config_projetos_net_framework:visualstudio_comunicacao_add_package.png?1200 |}}

Após clicar, será apresentada a janela NuGet: TCE.Co...Al.Repositorio. Nessa janela temos os menus Browse, INstalled e Updates. No primeiro serve para pesquisar novos pacotes que desejamos adicionar ao projeto. O segundo os pacotes já instalados no projeto. E o terceiro os pacotes que tem novas versões disponibilizadas.

Através dessas três opções no menu, gerenciamos as dependências do projeto, tanto em .Net Framework quanto .Net Core.

Para garantir que nas três opções do menu, sejam apresentadas as bibliotecas publicas e as mantidas pela Equipe de Sistemas do TCE-GO, devemos selecionar sempre a oção All no campo Package source, como apresentado na imagem abaixo.

{{ :pres:gerti:manual_config_projetos_net_framework:visualstudio_comunicacao_add_package_source.png?1200 |}}
==== Compilação ====
Para compilar um projeto .Net, Framework ou Core, devemos clicar na opção Build > Build Solution, como apresentado na imagem abaixo.

{{ :pres:gerti:manual_config_projetos_net_framework:visualstudio_comunicacao_build.png?1200 |}}