O Dvina escreve código no seu projeto, no seu computador, com as notas, as conversas e os motivos à vista. Descreva o que pretende, reveja o que foi alterado e disponibilize o resultado, na mesma aplicação que usa para tudo o resto.
Antes de começar
A funcionalidade Código faz parte da aplicação Dvina para computador, em Mac, Windows e Linux. Não precisa de instalar nada à parte. O Dvina tem de estar instalado em pelo menos um computador; qualquer outro dispositivo pode iniciar o trabalho e acompanhá-lo.
Para obter a aplicação para computador, consulte Descarregar e instalar o Dvina.
Abrir um projeto
Um projeto é uma pasta no seu computador: um repositório de código ou uma pasta simples.
- Na aplicação para computador, abra o Dock e selecione a linha dos projetos (Projetos).
- Selecione Abrir… para escolher uma pasta ou um repositório de código, ou Novo projeto… para criar uma nova pasta neste computador.
Ao criar um novo projeto, ative Criar repositório Git para manter um histórico de todas as alterações e poder anular as edições do Dvina.
A conversa trabalha no projeto que escolher. Num projeto de código, o Dock também mostra o respetivo branch.
Pedir o trabalho
Descreva o que pretende, por exemplo, "Faz com que a exportação CSV use as datas corretas". O Dvina executa o pedido como uma tarefa no seu computador, e pode continuar a conversar ou iniciar mais tarefas. Várias tarefas podem trabalhar no mesmo repositório e decidir entre si qual faz o commit primeiro.
Antes de escrever, o Dvina lê o projeto e o contexto que o rodeia: pesquisa nas suas conversas anteriores e nos seus ficheiros, para ter em conta os motivos. Também segue o AGENTS.md ou o CLAUDE.md do seu projeto.
Rever as alterações
A resposta de cada tarefa inclui as respetivas alterações, num cartão com o nome da tarefa e a indicação Pronto para revisão.
- Ver o que mudou: Selecione Alterações para ver as alterações de cada ficheiro no painel lateral. Ficheiros permite-lhe explorar o projeto.
- Anular uma interação: Por baixo de uma resposta que tenha alterado ficheiros, selecione a linha que indica quantos ficheiros foram alterados, depois Reverter, e confirme Reverter esta interação?. Os ficheiros voltam ao estado anterior à interação, e as alterações feitas desde então são mantidas.
Fazer o commit e abrir um pull request
- No cartão da tarefa, selecione Fazer commit.
- Fazer commit das alterações apresenta os ficheiros que serão incluídos no commit no seu branch, com um Título e uma Mensagem sugeridos. Selecione Fazer commit. Nada é enviado para o repositório remoto.
- Para abrir um pull request, selecione Enviar e criar PR. O Dvina envia primeiro o branch atual para o repositório remoto e, depois, abre o pull request. Os ficheiros sem commit não são incluídos.
O pull request usa a sua própria autenticação Git. O Dvina abre-o no GitHub ou no GitLab; qualquer outro serviço abre a sua própria página de criação de pull requests no seu navegador. Quando terminar, selecione Ver PR.
Aprovações
As compilações e os testes são executados sem pedir autorização. Eliminar ficheiros, enviar alterações, alterar bases de dados, fazer implementações e qualquer ação que envolva segredos ficam à espera da sua aprovação. O cartão explica porquê, por exemplo Executar este comando? com Elimina ficheiros ou Altera uma base de dados, e pode escolher Permitir ou Rejeitar. O administrador pode definir quais as ações que pedem sempre autorização.
Importante
Nada é enviado sem a sua autorização. O seu projeto é uma pasta no seu computador e, com o Git, pode anular todas as alterações que Dvina fizer.
Testar num simulador ou emulador
Na aplicação para computador, Dvina pode testar a sua aplicação neste computador tal como os seus utilizadores a vão usar: num navegador, no iOS Simulator num Mac ou no Android Emulator num Mac, Windows ou Linux.
- Abra o Dock e escolha a linha Dispositivo.
- Em Este dispositivo, escolha Navegador, iOS Simulator ou Android Emulator.
A área abre-se no painel lateral. Se o simulador estiver desligado, inicia-se quando o abrir. Para usar outro, escolha Escolher um dispositivo na parte superior da área; cada dispositivo mostra o respetivo sistema e se está Em execução ou Desligado.
Para mostrar ou ocultar o navegador, prima ⌘ ⇧ B num Mac ou Ctrl Shift B no Windows e no Linux. Enquanto Dvina trabalha numa área que não está a ver, a linha Dispositivo mostra um ponto.
Permitir que Dvina use um dispositivo
Na primeira vez que Dvina usa um simulador ou emulador, pede autorização, por exemplo Permitir que Dvina use o iPhone 17 Pro?, porque Dvina vê o ecrã do dispositivo. Por isso, não inicie sessão nas suas contas reais nesse dispositivo. Escolha Permitir ou Rejeitar. O dispositivo guarda a sua resposta, pelo que não volta a perguntar noutra conversa. Até dar autorização, a área apresenta Permitir que Dvina o use.
Enquanto Dvina trabalha, a área indica Dvina está a usar este dispositivo e a conversa mostra o dispositivo em direto. Escolha Ver em tamanho maior para ampliar a vista. As ações de enviar, pagar e eliminar no dispositivo ficam sempre à espera da sua aprovação.
Para usar o dispositivo, escolha Assumir o controlo. Os seus toques e as teclas que premir são enviados para o dispositivo, e pode premir Início e, no Android, Voltar e Aplicações recentes. Quando terminar, escolha Devolver o controlo e Dvina continua.
Configurar o iOS Simulator
Se o iOS Simulator não estiver configurado, a respetiva linha abre a lista de verificação Configurar o iOS Simulator. Cada passo fica automaticamente assinalado quando é concluído, mesmo que o tenha feito noutro local.
- Instalar o Xcode: Escolha Abrir a App Store. O Xcode é gratuito e ocupa cerca de 7 GB; abra-o uma vez após a instalação.
- Selecionar o Xcode: Escolha Copiar o comando e execute-o no Terminal. O comando pede a sua palavra-passe, pelo que Dvina nunca o executa por si.
- Adicionar o simulador de iOS: No Xcode, aceda a Definições › Componentes e obtenha o iOS ou execute o comando no Terminal.
- Criar um dispositivo: Escolha Criar um iPhone. Não é descarregado nada.
Configurar o Android Emulator
Se o Android Emulator não estiver configurado, a respetiva linha abre a lista de verificação Configurar o emulador Android.
- Instalar o Android Studio: Escolha Obter o Android Studio. Este instala os componentes necessários para executar o emulador; abra-o uma vez após a instalação.
- Adicionar o emulador e as ferramentas de plataforma: Execute o comando num terminal ou adicione-os em Android Studio › SDK Manager.
- Ativar a aceleração por hardware: No Windows e no Linux, execute o comando pessoalmente, pois exige a sua palavra-passe ou um administrador. Depois, no Linux, termine sessão e volte a iniciá-la; no Windows, reinicie o computador. Num Mac, não é necessário fazer nada neste passo.
- Adicionar uma imagem de sistema: Execute o comando num terminal ou adicione uma em Android Studio › SDK Manager. É uma transferência de grande dimensão.
- Criar um emulador: Escolha Criar um emulador. Não é descarregado nada.
Se o administrador tiver desativado os simuladores, as linhas indicam Desativado pelo administrador.
Trabalhar a partir de qualquer lugar
No telemóvel ou na web, pede no chat o que queres que seja feito. Dvina trabalha nisso no projeto no teu computador, e as alterações ficam à espera da tua revisão. O computador tem de estar ligado, com Dvina aberto.
Quando usar
- Estás a trabalhar em software real e queres ter todo o histórico à mão: as notas, as decisões e as conversas do mês passado.
- Queres que uma correção seja feita enquanto estás longe da secretária.
- Queres que várias alterações sejam feitas em simultâneo, cada uma pronta para revisão.
Dicas
- Regista as tuas regras de trabalho. Descreve a tua forma de trabalhar em AGENTS.md ou CLAUDE.md, e Dvina segue essas orientações.
- Testa num telemóvel. Estás a criar uma aplicação? Dvina pode testá-la num simulador de iPhone ou num emulador de Android, tocando no ecrã como os teus utilizadores farão. Consulta Testar num simulador ou emulador.
- Não és programador? Para criar aplicações e páginas funcionais, usa Criar.