Skip to main content

​
Solução de problemas do Node

Use esta página quando um node estiver visível no status, mas as ferramentas do node falharem.

​
Escada de comandos

Em seguida, execute verificações específicas do node:
Sinais saudáveis:
  • O Node está conectado e pareado para a função node.
  • nodes describe inclui a capacidade que você está chamando.
  • As aprovações de exec mostram o modo/lista de permissões esperados.

​
Requisitos de primeiro plano

canvas.*, camera.* e screen.* funcionam apenas em primeiro plano em nodes iOS/Android. Verificação e correção rápidas:
Se você vir NODE_BACKGROUND_UNAVAILABLE, traga o app do node para o primeiro plano e tente novamente.

​
Matriz de permissões

​
Pareamento versus aprovações

Estes são bloqueios diferentes:
  1. Pareamento do dispositivo: este node pode se conectar ao gateway?
  2. Aprovações de exec: este node pode executar um comando de shell específico?
Verificações rápidas:
Se o pareamento estiver ausente, aprove primeiro o dispositivo do node. Se o pareamento estiver ok, mas system.run falhar, corrija as aprovações de exec/lista de permissões.

​
Códigos comuns de erro do node

  • NODE_BACKGROUND_UNAVAILABLE → o app está em segundo plano; traga-o para o primeiro plano.
  • CAMERA_DISABLED → alternância da câmera desativada nas configurações do node.
  • *_PERMISSION_REQUIRED → permissão do SO ausente/negada.
  • LOCATION_DISABLED → o modo de localização está desativado.
  • LOCATION_PERMISSION_REQUIRED → o modo de localização solicitado não foi concedido.
  • LOCATION_BACKGROUND_UNAVAILABLE → o app está em segundo plano, mas existe apenas a permissão Durante o uso.
  • SYSTEM_RUN_DENIED: approval required → a solicitação de exec precisa de aprovação explícita.
  • SYSTEM_RUN_DENIED: allowlist miss → comando bloqueado pelo modo de lista de permissões.

​
Loop rápido de recuperação

Se ainda estiver com problemas:
  • Reaprovar o pareamento do dispositivo.
  • Reabrir o app do node (primeiro plano).
  • Conceder permissões de SO novamente.
  • Recriar/ajustar a política de aprovação de exec.
Relacionado: