Compartilhar via


Opções do compilador (F#)

Este tópico descreve as opções de linha de comando para o compilador F#, fsc.exe. O ambiente de compilação também pode ser controlado definindo as propriedades do projeto.

Opções de compilador listadas em ordem alfabética

A tabela a seguir mostra as opções de compilador listadas em ordem alfabética. Algumas das opções do compilador F# são semelhantes às opções do compilador C#. Se esse for o caso, um link para o tópico das opções de compilador C# será fornecido.

Opção do compilador

Descrição

-a <output-filename>

Gerencia uma biblioteca e especifica seu nome de arquivo. Esta opção é uma forma abreviada de --target:library <filename>.

--baseaddress:<string>

Especifica o endereço básico da biblioteca a ser compilado.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /baseaddress (opções do compilador C#).

--codepage:<int>

Especifica a página de códigos usada para ler arquivos de origem.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /codepage (opções do compilador C#).

--consolecolors

Especifica que os erros e avisos usam textos codificados por cores no console.

--crossoptimize[+|-]

Habilita ou desabilita otimizações de módulo cruzado.

--delaysign[+|-]

Assinatura atrasada do assembly usando somente a parte pública da chave de nome forte.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /delaysign (opções do compilador C#).

--checked[+|-]

Habilita ou desabilita a geração de verificações de estouro.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /checked (opções do compilador C#).

--debug[+|-]

-g[+|-]

--debug:[full|pdbonly]

-g: [full|pdbonly]

Habilita ou desabilita a geração de informações de depuração, ou especifica o tipo de informações de depuração a serem geradas. O padrão está completo, o que permite anexos a um programa em execução. Escolha pdbonly para obter informações de depuração limitadas armazenadas em um arquivo pdb (banco de dados de programa).

Equivalente à opção de compilador do C# com o mesmo nome. Para obter mais informações, consulte

/debug (opções do compilador C#).

--define:<string>

-d:<string>

Define um símbolo para uso em compilação condicional.

--doc:<xmldoc-filename>

Instrui o compilador a gerar comentários de documentação XML para o arquivo especificado. Para obter mais informações, consulte Documentação XML (F#).

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /doc (opções do compilador C#).

--fullpaths

Instrui o compilador a gerar caminhos totalmente qualificados.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /fullpaths (opções do compilador C#).

--help

-?

Exibe informações de uso, incluindo uma descrição curta de todas as opções do compilador.

--highentropyva[+|-]

Habilite ou desabilite o ASLR de alta entropia, um recurso de segurança avançada. O sistema operacional torna aleatórios os locais na memória onde a infraestrutura para aplicativos (como a pilha e o heap) é carregada. Se você habilitar essa opção, os sistemas operacionais poderão usar esse aleatoriedade para usar o espaço de endereço de 64 bits completo em um computador de 64 bits.

--keycontainer:<string>

Especifica um contêiner de chave de nome forte.

--keyfile:<filename>

Especifica o nome de um arquivo de chave pública para assinar o assembly gerado.

--lib:<folder-name>

-I:<folder-name>

Especifica um diretório no qual os assemblies que são referenciados devem ser procurados.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /lib (opções do compilador C#).

--linkresource:<resource-info>

Vincula um recurso especificado ao assembly. O formato das informações de recurso é filename[,name[,public |private]]

A vinculação de um único recurso a esta opção é uma alternativa à inserção de um arquivo de recurso inteiro com a opção --resource.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /linkresource (opções do compilador C#).

--mlcompatibility

Ignora os avisos que aparecem quando você usa recursos projetados para compatibilidade com outras versões do ML.

--noframework

Desabilita a referência ao assembly do .NET Framework.

--nointerfacedata

Instrui o compilador a omitir o recurso que ele normalmente adiciona a um assembly que inclua metadados específicos do F#.

--nologo

Não mostra o texto do banner ao iniciar o compilador.

--nooptimizationdata

Instrui o compilador a incluir somente a otimização essencial para a implementação de construções embutidas. Inibe o módulo cruzado em linha mas melhora a compatibilidade binária.

--nowin32manifest

Instrui o compilador a omitir o manifesto Win32 padrão.

--nowarn:<int-list>

Desabilita avisos específicos listados por número. Separe cada número de aviso por uma vírgula. Você pode descobrir o número de aviso para qualquer aviso de saída de compilação.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /nowarn (opções do compilador C#).

--optimize[+|-] [<string-list>]

-O[+|-] [<string-list>]

Habilita ou desabilita otimizações. Algumas opções de otimização podem ser desabilitadas ou habilitadas seletivamente. Para isso, basta listá-las. Estes são: nojitoptimize, nojittracking, nolocaloptimize, nocrossoptimize, notailcalls.

--out:<output-filename>

-o:<output-filename>

Especifica o nome do assembly ou módulo compilado.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /out (opções do compilador C#).

--pdb:<pdb-filename>

Nomeie o arquivo do PDB de depuração de saída (banco de dados do programa). Esta opção se aplica somente quando --debug também está habilitado.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /pdb (opções do compilador C#).

--platform:<platform-name>

Especifica que o código gerado será executado somente na plataforma especificada (x86, Itanium ou x64) ou, se o nome de plataforma anycpu for escolhido, especifica que o código gerado pode ser executado em qualquer plataforma.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /platform (opções do compilador C#).

--quotations-debug

Especifica que informações de depuração adicionais devem ser emitidas para expressões derivadas de literais de aspas duplas F# e definições refletidas. Informações de depuração são adicionadas aos atributos personalizados de um nó de árvore de expressão F#. Consulte Citações de código (F#) e Expr.CustomAttributes.

--reference:<assembly-filename>

-r <assembly-filename>

Disponibiliza o código de um assembly do F# ou do.NET Framework para o código que está sendo compilado.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /reference (opções do compilador C#).

--resource:<resource-filename>

Insere um arquivo de recurso gerenciado no assembly gerado.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /resource (opções do compilador C#).

--sig:<signature-filename>

Gera um arquivo de assinatura com base no assembly gerado. Para obter mais informações sobre arquivos assinatura, consulte Assinaturas (F#).

--simpleresolution

Especifica que as referências a assemblies devem ser resolvidas usando regras mono baseadas em diretório em vez da resolução do MSBuild. O padrão é usar a resolução MSBuild, exceto na execução em mono.

--standalone

Especifica a geração de um assembly que contém todas as suas dependências para que ele possa ser executado por si só, sem a necessidade de assemblies adicionais, como a biblioteca F#.

--staticlink:<assembly-name>

Vincula estaticamente o assembly determinado e todas as DLLs referenciadas que dependem desse assembly. Use o nome do assembly, não o nome da DLL.

--subsystemversion

Especifica a versão do subsistema do sistema operacional a ser usado pelo arquivo executável gerado. Use 6.02 para Windows 8, 6.01 para Windows 7, 6.00 para Windows Vista. Esta opção se aplica somente a executáveis, não a DLLs, e precisa ser usada apenas se seu aplicativo depende dos recursos específicos de segurança disponíveis apenas em determinadas versões do sistema operacional. Se essa opção for usada, e se um usuário tentar executar seu aplicativo em uma versão anterior do sistema operacional, ele falhará com uma mensagem de erro.

--tailcalls[+|-]

Habilita ou desabilita o uso da instrução do IL final, fazendo com que o quadro de pilha seja reutilizado para funções recursivas finais. Esta opção está habilitada por padrão.

--target:[exe | winexe | library | module ] <output-filename>

Especifica o tipo e o nome do arquivo do código compilado gerado.

  • exe significa um aplicativo de console.

  • winexe significa um aplicativo do Windows diferente do aplicativo de console que não tem fluxos padrões de arquivos entrada/saída (stdin, stdout, e stderr) definidos.

  • library é um assembly sem um ponto de entrada.

  • module é um módulo do .NET Framework (.netmodule), que posteriormente pode ser combinado a outros módulos em um assembly.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /target (opções do compilador C#).

--times

Exibe informações de temporização para compilação.

--utf8output

Habilita a saída do compilador de impressão na na codificação UTF-8.

--warn:<warning-level>

Define um nível de aviso (de 0 a 5). O nível padrão é 3. Cada aviso recebe um nível com base em sua gravidade. O nível 5 oferece mais, mas menos graves, avisos do que o nível 1.

Os avisos de nível 5 são: 21 (uso recursivo verificado em tempo de execução), 22 (let rec avaliado fora de ordem), 45 (abstração completa) e 52 (cópia defensiva). Todos os outros avisos são nível 2.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /warn (opções do compilador C#).

--warnon:<int-list>

Habilite avisos específicos que poderão estar desligados por padrão ou desabilitados por outra opção de linha de comando. No F# 3.0, somente o aviso 1182 (variáveis não usadas) estará desativado por padrão.

--warnaserror[+|-] [<int-list>]

Habilita ou desabilita a opção para relatar avisos como erros. Você pode fornecer os números de aviso específicos a serem desativados ou ativados. Opções posteriores em opções de substituição da linha de comando anteriores na linha de comando. Por exemplo, para especificar os avisos que você não deseja relatar como erros, especifique --warnaserror+ --warnaserror-:<int-list>.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /warnaserror (opções do compilador C#).

--win32manifest:manifest-filename

Adiciona um arquivo de manifesto do Win32 à compilação. Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /win32manifest (opções do compilador C#).

--win32res:resource-filename

Adiciona um arquivo de recursos do Win32 à compilação.

Esta opção de compilador é equivalente à opção de compilador C# com o mesmo nome. Para obter mais informações, consulte /win32res (opções do compilador C#).

Tópicos relacionados

Nome

Descrição

Opções do F# Interativo

Descreve opções de linha de comando com suporte do interpretador F#, fsi.exe.

Referência de propriedades de projeto

Descreve a interface de usuário para projetos, incluindo páginas de propriedades do projeto que fornecem opções de compilação.