> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de migração para V2

Ao atualizar exemplos de templates mais antigos para o formato atual do SDK, tenha estas migrações em mente:

* Prefira a API de builder `Template` em vez de inicialização de runtime ad hoc dentro de `Sandbox.create(...)`.
* Use `Template.build(...)` para produzir primeiro um template reutilizável e, em seguida, passe o ID do template retornado para `Sandbox.create(...)`.
* Mova a lógica de inicialização para `setStartCmd(...)` / `set_start_cmd(...)` para que o ambiente esteja pronto antes da chegada de solicitações em runtime.
* Mova etapas repetidas de instalação de pacotes e cópia de arquivos para o build do template, em vez de executá-las após a inicialização do sandbox.
* Use tags para promoção de releases em vez de alterar nomes de templates a cada lançamento.

Para JavaScript e TypeScript, use o caminho de importação ESM padrão ao trabalhar com `Template` em um projeto Node ESM:

```ts theme={"system"}
import { Template, Sandbox } from "novita-sandbox"
```

Este é o caminho atualmente validado para a API `Template` neste conjunto de documentação.