> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/comecar/using-the-cli.md).

# Usando a CLI

Para construir cenas para o Decentraland, você pode usar qualquer uma das seguintes opções:

* O [Creator Hub](/creator/content-creator-pt/scene-editor/comecar/editor-installation.md)
* A Interface de Linha de Comando (CLI)

Ambas as ferramentas permitem compilar e visualizar sua cena em um ambiente de desenvolvimento "off-chain". Depois de testar sua cena localmente, você pode enviar seu conteúdo para o content server, vinculando-o ao seu LAND ou WORLD.

Embora o Scene Editor no Creator Hub seja mais fácil de usar, a CLI oferece mais flexibilidade e pode ser facilmente usada em processos automatizados.

{% hint style="warning" %}
**📔 Nota**: O Scene Editor executa as mesmas operações de linha de comando nos bastidores.
{% endhint %}

{% hint style="info" %}
**💡 Dica**: Veja [guia de instalação](/creator/content-creator-pt/scene-editor/comecar/editor-installation.md) para instruções sobre como instalar o Creator Hub.
{% endhint %}

## Antes de começar

Para lidar com a scene pela linha de comando, instale as seguintes dependências antes de executar comandos da CLI com a scene:

* [Node.js](https://nodejs.org) (versão 8 ou posterior)

## Iniciar um novo projeto

Execute `npx @dcl/sdk-commands init` em uma pasta vazia para preenchê-la com os arquivos padrão de um projeto do Decentraland.

A CLI então solicita que você escolha que tipo de projeto deseja construir, se quiser criar uma [scene](/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md), um [workspace](/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/workspaces.md) ou um [smart wearable](/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/smart-wearables.md). Se selecionar uma scene, a CLI solicita que você escolha qual projeto base usar como ponto de partida.

## Atualizar a versão do SDK de uma scene

Execute o seguinte comando na pasta da scene:

```bash
npm i @dcl/sdk@latest
```

Você pode confirmar que funcionou verificando o arquivo `package.json` da scene e procurando a versão do `@dcl/sdk` lá.

## Executar uma preview

Execute `npm run start` na pasta raiz de um projeto de scene, workspace ou smart wearable para abrir uma preview em uma janela do navegador.

```bash
npm run start
```

Para visualizar sua scene no [app móvel do Decentraland](/creator/content-creator-pt/scenes-sdk7/criar-para-mobile/building-for-mobile.md) em vez disso, execute `npm run start -- --mobile` (alias `-- -m`). A CLI exibe um código QR que abre a scene em um telefone conectado à mesma rede Wi-Fi que o seu computador. Veja [Preview no mobile](/creator/content-creator-pt/scenes-sdk7/criar-para-mobile/preview-on-mobile.md) para o guia completo.

```bash
npm run start -- --mobile
```

Veja [preview scenes](/creator/content-creator-pt/scenes-sdk7/comecar/preview-scene.md) para detalhes e opções especiais ao executar uma preview.

## Build

Execute `npm run build` para construir seu projeto. As scenes do Decentraland são escritas em TypeScript, mas são compiladas para JavaScript minificado quando publicadas. Veja [coding scenes](https://github.com/decentraland/docs-creator/blob/main/sdk7/getting-started/coding-scenes.md) para mais detalhes.

O comando de build é opcional, pois ele também é executado em segundo plano antes do deploy (embora você possa adicionar um flag para ignorá-lo).

O comando de build executa verificações de tipo mais rigorosas do que aquelas executadas com `npm run start`, executá-lo às vezes pode ser útil para depurar uma scene.

## Fazer deploy de uma scene

Execute `npm run deploy` para publicar sua scene no Decentraland. Este comando abre uma janela do navegador onde você pode assinar com sua wallet para autorizar o deploy.

Veja [publicação](/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md) para detalhes e opções especiais ao publicar uma scene.

## Solução de problemas

Se você encontrar problemas, veja a [seção de solução de problemas](/creator/content-creator-pt/scenes-sdk7/depuracao/troubleshooting.md) .


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/comecar/using-the-cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.