Pular para o conteúdo
ELYRA

Interagir com o aparelho emulado

Toque, digite e faça gestos no aparelho emulado pela aba Emulador, pelo cartão do Canvas ou pela CLI.

Ver Markdown

Interagir é enviar um toque, um gesto, um texto, um botão de hardware ou uma rotação para o aparelho escolhido. Os mesmos comandos existem na tela do Elyra e na CLI: a aba e o cartão do Canvas mandam o mesmo que tap, type e gesture mandam por linha de comando.

Pré-requisitos

  • Um aparelho emulado ativo para o workspace. Se nenhum estiver ativo, a ação falha pedindo um alvo — veja Emulador de celular para listar e conectar.
  • A aba Emulador aberta ou um cartão Celular no Canvas, se você for interagir pela tela.

Passos

  1. Escolha o aparelho. No painel do aparelho, na aba Emulador, escolha o dispositivo na lista e conecte; no Canvas, escolha o dispositivo na lista do cartão Celular. O aparelho escolhido fica ativo para o workspace, e é ele que recebe as ações seguintes.
  2. Toque na tela. Clique ou toque sobre a imagem do aparelho na aba, ou sobre a transmissão do cartão do Canvas. O toque vai para o ponto em que você tocou.
  3. Faça um gesto. Arraste sobre a imagem para rolar ou deslizar. Na CLI o mesmo efeito é um gesture com dois ou mais pontos, ou um tap para um toque único.
  4. Digite. Pela CLI, use type com o texto entre aspas. Texto com espaço precisa estar entre aspas: sem elas cada palavra vira um argumento solto e o comando é recusado.
  5. Use botões e rotação. Pela CLI, button manda um botão de hardware e rotate gira a tela para uma das quatro orientações.
  6. Olhe a tela depois de cada ação. A resposta do comando diz que o comando foi enviado, não que o aparelho reagiu da forma esperada.

Equivalente na CLI, com o aparelho ativo no workspace:

Janela do terminal
elyra emulator tap 0.5 0.85 --json
elyra emulator type "user@example.com" --json
elyra emulator gesture '[{"type":"begin","x":0.5,"y":0.8},{"type":"end","x":0.5,"y":0.2}]' --json
elyra emulator button back --json
elyra emulator rotate landscape_left --json

Resultado

  • A ação é enviada ao aparelho escolhido, e a tela na aba ou no cartão do Canvas mostra o efeito.
  • O aparelho continua ativo para o workspace até você encerrar a sessão.

Limites

  • As coordenadas do tap são normalizadas de 0 a 1, com origem no canto superior esquerdo — nunca pixels. Um valor fora dessa faixa é recusado.
  • type aceita apenas US ASCII. Texto acentuado é recusado; digite pela interface do próprio app ou envie a forma sem acento.
  • O aparelho precisa estar ativo. Sem alvo resolvido, o comando falha com emulator_no_active.
  • A resposta do comando não comprova o efeito visual. Olhe a tela depois de cada ação antes de decidir o próximo passo.
  • Não existe captura de tela nesta família. No Android, a forma de ler a tela de volta é a árvore de acessibilidade (elyra emulator ax); no iOS esse verbo é recusado.
  • Para um toque único, use tap. Um gesture de dois pontos pode virar um toque longo por causa da latência do canal de controle.
  • No Android o gesto vira um arrasto reto entre o primeiro e o último ponto: ele rola e desliza, mas não desenha um caminho de múltiplos toques.

Recuperação

  • emulator_no_active — nenhum aparelho ativo no workspace. Conecte um no painel do aparelho ou passe --device <id> / --node "<id ou título do cartão>" no comando.
  • emulator_device_not_found — o identificador não existe nesta máquina. Liste com elyra emulator devices --json e use o id que aparecer.
  • O texto foi recusado — confira se há espaço sem aspas ou caractere fora de US ASCII.
  • A tela não mudou — releia a tela (no Android, a árvore de acessibilidade) antes de repetir a ação; repetir às cegas pode aplicar a mesma ação duas vezes.

Próximos passos