DroidView

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

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

1. Abra a Paleta de Comandos do VS Code.
2. Busque por "DroidView".
3. Escolha um comando para espelhar, gravar ou listar dispositivos.
4. 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.