DroidView

Extensão para VS Code que executa scrcpy para espelhar, gravar e controlar um dispositivo Android diretamente do editor.

Demo

Visão geral

DroidView é uma extensão de interface para o scrcpy. Ela simplifica o uso do scrcpy através de comandos do VS Code, barra de status e prompts para configurações personalizadas.

Esta extensão não empacota o scrcpy. Você precisa instalar o scrcpy e garantir que o comando adb esteja disponível no ambiente.

Requisitos

Instalar o scrcpy
Habilitar a depuração USB no Android
Ter o comando adb disponível no PATH
Ter o VS Code com suporte a extensões

Como usar

Abra a Paleta de Comandos do VS Code.
Busque por "DroidView".
Escolha um comando para espelhar, gravar ou listar dispositivos.
Para acesso rápido, use o item na barra de status.

Comandos disponíveis

Mirror screen: inicia o espelhamento da tela
Record screen: inicia a gravação do dispositivo
Mirror screen (set bit rate): define bitrate personalizado
Mirror screen (set frame rate): define taxa de quadros personalizada
Mirror screen (set size): define tamanho máximo da imagem
Mirror screen (set crop): define área de crop da tela
Mirror screen (custom settings): configura múltiplos parâmetros
Record screen (custom settings): gravação com configurações personalizadas
List Android devices: lista dispositivos conectados
Stop scrcpy session: encerra a sessão atual

Funcionalidades

Acesso rápido via barra de status
Detecção automática de dispositivos por meio do adb
Tratamento seguro de argumentos para o scrcpy
Criação automática de diretórios para gravação
Validação de ambiente antes de iniciar a sessão

Estrutura do projeto

src/extension.js: registro dos comandos da extensão
src/scrcpy.js: orquestração da execução do scrcpy e interação com a UI
src/utils.js: funções auxiliares para adb, prompts e configuração de saída
test/: testes de regressão e validação de comportamento

Desenvolvimento

Para executar os testes locais:

node --test

Para validar o pacote da extensão, use o fluxo padrão do VS Code para extensões.

Resolução de problemas

Se o comando adb não for encontrado, verifique se o Android SDK Platform Tools está instalado e no PATH.
Se o scrcpy não for encontrado, confirme a instalação do binário e a presença dele no PATH.
Se nenhum dispositivo aparecer, confirme a depuração USB e a autorização do computador no dispositivo Android.

Créditos

Projeto original de Maestral Solutions (2020).

Fork mantido por João M J Braga.