Versão do documento
v2026.05.16.0
Baixar PDF
Desempenho e carregamento¶
Meta¶
Ajuda você a decidir se o aplicativo ainda está progredindo normalmente ou está realmente travado.
Plataformas Suportadas¶
iOSmacOS
Público-alvo¶
- Usuários aguardando importação ou preparação de cena e sem saber se o aplicativo ainda está em andamento
- Testadores fazendo triagem de travamentos de carregamento, travamentos aparentes ou regressões de desempenho percebidas
Pré-requisitos¶
- Um documento está importando, abrindo ou construindo uma cena 3D
- Você ainda pode observar o estado de progresso visível, o texto do estágio ou a capacidade de resposta da IU
Etapas¶
- Verifique se o texto do estágio, a porcentagem ou o cartão de carregamento ainda estão mudando.
- Confirme se a IU ainda responde à interação básica.
- Registre o estágio exato e quanto tempo o aplicativo permanece lá antes de decidir que está travado.
- Compare o comportamento com os padrões conhecidos de espera normal e de parada suspeita abaixo.
Resultado¶
- Você pode distinguir entre um progresso encenado normal, uma parada protetora e um provável problema de carregamento real.
Estágios de espera comuns na versão atual¶
Importar para preparação 2D¶
- o topo da biblioteca mostra um banner de importação
- o espaço de trabalho pode mudar temporariamente para
Data - o visualizador 2D pode permanecer bloqueado até que o primeiro quadro projetado seja publicado
3D construção de cena¶
3D mostra texto explícito de estágio e progresso, como:
LoadingDetailsViewFinishing

Como saber se o progresso ainda é normal¶
Concentre-se nestes sinais:
- o número do progresso ou o texto do estágio está mudando
- a IU ainda responde à interação básica
- o banner de importação ou o cartão de carregamento 3D continua atualizando
Se todos os três forem verdadeiros, o aplicativo geralmente ainda está progredindo normalmente.
Quando suspeitar de um problema real¶
- o aplicativo permanece no mesmo palco por muito tempo sem alteração de texto
- a UI deixa de responder
- a mesma entrada trava repetidamente no mesmo ponto no mesmo dispositivo
- o comportamento só aparece nesta versão e não nas anteriores estáveis
Alguns fatos atuais de implementação¶
- Durante a importação, o visualizador poderá mudar automaticamente para
Data; esta é uma transição normal e não significa que a abertura falhou. - 3D exige uma board session com geometria de placa suficiente. Se uma entrada não atender a essa condição, uma mensagem clara não será um problema de desempenho.
- Enormes entradas
IPC-2581não são mais interrompidas proativamente por uma simulação de memória de tempo de abertura; se um for muito lento ou eventualmente falhar, registre-o como um problema real de caminho de importação.
O que gravar¶
- dispositivo e plataforma
- tipo e tamanho de entrada
- em qual estágio o aplicativo para
- quanto tempo fica lá
- se a UI ainda responde
- se o problema aparece apenas em uma visualização
Perguntas comuns¶
Se esperar muito tempo, isso sempre significa que algo está errado?¶
Placas grandes, construção de cena 3D pela primeira vez e reconhecimento de pacote de fabricação podem produzir um tempo de espera perceptível. O que importa é se o Estado ainda está avançando.
Por que é importante registrar o estágio exato?¶
Porque a implementação atual já divide a importação e o carregamento de 3D em estágios explícitos. O registro do estágio torna a reprodução e o resumo de problemas muito mais rápidos.