Lauch Settings | Visual Studio

• Lauch Settings | Visual Studio

---

O arquivo launchSettings.json é uma parte fundamental no desenvolvimento de aplicações ASP.NET Core, especialmente durante as fases de desenvolvimento e depuração. Localizado na pasta Properties do projeto, este arquivo define como a aplicação é iniciada em diferentes ambientes de desenvolvimento, permitindo configurações específicas para cada cenário.

Estrutura do launchSettings.json

O arquivo é estruturado em três seções principais:

1. iisSettings: Configurações específicas para o IIS ou IIS Express.
2. profiles: Define múltiplos perfis de inicialização para diferentes cenários.
3. $schema (opcional): Especifica o esquema JSON para validação.

Exemplo de launchSettings.json

{
  "$schema": "http://json.schemastore.org/launchsettings.json",
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:5000",
      "sslPort": 44312
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "MyApp": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

Detalhamento das Seções

1. iisSettings

Esta seção configura como a aplicação será executada no IIS ou IIS Express:

• windowsAuthentication: Habilita ou desabilita a autenticação do Windows.
• anonymousAuthentication: Habilita ou desabilita a autenticação anônima.
• iisExpress:
  • applicationUrl: Define a URL base usada pelo IIS Express.
  • sslPort: Porta SSL para conexões seguras.

2. profiles

Cada perfil define um conjunto de configurações para iniciar a aplicação:

• commandName:
  • "IISExpress": Executa a aplicação no IIS Express.
  • "Project": Executa o projeto diretamente com dotnet run.
• launchBrowser: Indica se o navegador deve ser aberto automaticamente.
• applicationUrl: Especifica as URLs que a aplicação irá escutar.
• environmentVariables: Define variáveis de ambiente, como ASPNETCORE_ENVIRONMENT.
• dotnetRunMessages: Quando true, exibe mensagens detalhadas do dotnet run.

Uso do launchSettings.json

• Visual Studio: Carrega automaticamente o launchSettings.json ao iniciar o projeto, permitindo a seleção do perfil desejado.
• CLI do .NET: Ao usar dotnet run, o perfil com commandName definido como "Project" é utilizado.

Considerações Importantes

• O launchSettings.json é utilizado apenas no ambiente de desenvolvimento e não é necessário em produção.
• Evite armazenar informações sensíveis neste arquivo, pois ele pode ser incluído no controle de versão.
• Se o arquivo estiver ausente, o .NET usará configurações padrão ao executar o projeto.

Para mais detalhes, você pode consultar o artigo ASP.NET Core LaunchSettings.json File.

Com o launchSettings.json, é possível personalizar a inicialização da aplicação ASP.NET Core, facilitando o desenvolvimento e a depuração em diferentes cenários.

---