Introdução ao F# com a CLI do .NET

Este artigo aborda como você pode começar a usar o F# em qualquer sistema operacional (Windows, macOS ou Linux) com a CLI do .NET. Ele passa pela criação de uma solução multiprojetos com uma biblioteca de classes que é chamada por um aplicativo de console.

Pré-requisitos

Para começar, você deve instalar o SDK do .NET mais recente.

Este artigo pressupõe que você saiba como usar uma linha de comando e tenha um editor de texto preferencial. Se você ainda não usar, o Visual Studio Code é uma ótima opção como editor de texto para F#.

Compilar uma solução simples multiprojetos

Abra um prompt de comando/terminal e use o comando dotnet new para criar um novo arquivo de solução nomeado como FSharpSample:

dotnet new sln -o FSharpSample

A seguinte estrutura de diretório é produzida após a execução do comando anterior:

FSharpSample
    ├── FSharpSample.sln

Gravar uma biblioteca de classes

Altere os diretórios para FSharpSample.

Use o comando dotnet new para criar um projeto de biblioteca de classes na pasta src nomeada como Library.

dotnet new classlib -lang "F#" -o src/Library

A seguinte estrutura de diretório é produzida após a execução do comando anterior:

└── FSharpSample
    ├── FSharpSample.sln
    └── src
        └── Library
            ├── Library.fs
            └── Library.fsproj

Substitua o conteúdo de Library.fs pelo seguinte código:

module Library

open System.Text.Json

let getJson value =
    let json = JsonSerializer.Serialize(value)
    value, json

Adicione o projeto Library à solução FSharpSample usando o comando dotnet sln add:

dotnet sln add src/Library/Library.fsproj

Execute dotnet build para compilar o projeto. As dependências não resolvidas serão restauradas na compilação.

Gravar um aplicativo de console que consome a biblioteca de classes

Use o comando dotnet new para criar um aplicativo de console na pasta src nomeada como App.

dotnet new console -lang "F#" -o src/App

A seguinte estrutura de diretório é produzida após a execução do comando anterior:

└── FSharpSample
    ├── FSharpSample.sln
    └── src
        ├── App
        │   ├── App.fsproj
        │   ├── Program.fs
        └── Library
            ├── Library.fs
            └── Library.fsproj

Substitua o conteúdo do arquivo Program.fs pelo seguinte código:

open System
open Library

[<EntryPoint>]
let main args =
    printfn "Nice command-line arguments! Here's what System.Text.Json has to say about them:"

    let value, json = getJson {| args=args; year=System.DateTime.Now.Year |}
    printfn $"Input: %0A{value}"
    printfn $"Output: %s{json}"

    0 // return an integer exit code

Adicione uma referência ao projeto Library usando dotnet add reference.

dotnet add src/App/App.fsproj reference src/Library/Library.fsproj

Adicione o projeto App à solução usando o FSharpSample comando dotnet sln add:

dotnet sln add src/App/App.fsproj

Restaure as dependências do NuGet com dotnet restore e execute dotnet build para compilar o projeto.

Altere o diretório para o projeto de console src/App e execute o projeto passando Hello World como argumentos:

cd src/App
dotnet run Hello World

Você deve ver o seguintes resultados:

Nice command-line arguments! Here's what System.Text.Json has to say about them:
Input: { args = [|"Hello"; "World"|] year = 2021 }
Output: {"args":["Hello","World"],"year":2021}

Próximas etapas

Em seguida, confira o Tour do F# para saber mais sobre os diferentes recursos do F#.