# Gere cartões do Anki com Rust

Canonical page: https://ankiforge.dev/pt-br/docs/quickstart/
Language: pt-BR
Description: Instale o pacote público de Rust, crie um cartão de espanhol e exporte um APKG persistente com um programa completo.

Use Rust 1.92 ou posterior. Se preferir outra linguagem, escolha [Node / TypeScript ou Python](https://ankiforge.dev/pt-br/docs/languages/).

## Instale a biblioteca

```sh
cargo new anki-deck
cd anki-deck
cargo add ankiforge@0.3.1
```

## Exporte seu primeiro baralho

Salve este programa completo como `src/main.rs`:

```rust
use ankiforge::{BuildOptions, Note, Project};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut project = Project::new("spanish")?.default_deck("Spanish");
    project.add("es:hola", Note::basic("hola", "hello"))?;
    let output = project.build(BuildOptions::to("spanish.apkg"))?;
    println!("{}", output.artifact().path().display());
    Ok(())
}
```

```sh
cargo run
```

O programa grava o arquivo persistente `spanish.apkg`. Abra-o no Anki, importe-o e estude **hola → hello** no baralho **Spanish**. A exportação não exige que o Anki esteja instalado.

O namespace `spanish` e a chave estável `es:hola` identificam essa nota mesmo quando seu conteúdo muda. Você também pode [baixar o exemplo Basic do site](https://ankiforge.dev/generated/spanish.apkg).

## Continue

Siga o [tutorial de JSON para Anki](https://ankiforge.dev/pt-br/docs/json-to-anki/#rust) para executar uma tarefa completa com mídia e atualização.

Adicione [imagens e áudio](https://ankiforge.dev/pt-br/docs/media/), [tipos de nota personalizados](https://ankiforge.dev/pt-br/docs/custom-notetypes/) ou [oclusão de imagem](https://ankiforge.dev/pt-br/docs/image-occlusion/). Guarde o APKG original distribuído antes de [comparar e publicar uma atualização](https://ankiforge.dev/pt-br/docs/updates/). Consulte a [API de Rust](https://ankiforge.dev/pt-br/docs/rust-api/) ou os [ambientes verificados](https://ankiforge.dev/pt-br/docs/compatibility/) para saber mais.