문서 버전 v2026.07.07.0

PDF 다운로드

성능과 로딩

목표

앱이 아직 정상적으로 진행 중인지, 실제로 멈춘 것인지 판단합니다.

지원 플랫폼

• iOS
• macOS

대상 독자

• 가져오기나 보기 준비를 기다리는 중이고 앱이 계속 진행 중인지 확신이 없는 사용자
• 로딩 정지, 멈춘 것처럼 보이는 상태, 체감 성능 저하를 분류하는 테스터

사전 준비

• 문서를 가져오거나, 열거나, 3D 보기를 구성하는 중입니다.
• 보이는 진행 상태, 단계 문구, UI 반응성을 관찰할 수 있습니다.

단계

1. 단계 문구, 퍼센트, 로딩 카드가 계속 바뀌는지 확인합니다.
2. UI가 기본 조작에 계속 반응하는지 확인합니다.
3. 멈췄다고 판단하기 전에 정확한 단계와 그 상태가 얼마나 오래 유지되는지 기록합니다.
4. 아래의 정상 대기와 의심스러운 정지 패턴에 비교합니다.

결과

• 정상적인 단계별 진행, 보호 중단, 실제 로딩 문제 가능성을 구분할 수 있습니다.

현재 버전에서 자주 보이는 대기 단계

가져오기에서 2D 준비로 넘어가는 단계

• 라이브러리 상단에 가져오기 배너가 표시됩니다.
• 작업 공간이 잠시 Data로 전환될 수 있습니다.
• 첫 투영 프레임이 게시될 때까지 2D 뷰어가 차단될 수 있습니다.

3D 보기 구성 단계

3D는 다음과 같은 명확한 단계와 진행 문구를 보여줍니다.

• Loading
• Details
• View
• Finishing

아직 정상 진행 중이라고 판단하는 방법

다음 신호에 집중하세요.

1. 진행 숫자나 단계 문구가 바뀝니다.
2. UI가 기본 조작에 반응합니다.
3. 가져오기 배너나 3D 로딩 카드가 계속 갱신됩니다.

세 가지가 모두 참이면 대개 앱은 아직 정상적으로 진행 중입니다.

실제 문제를 의심할 때

• 같은 단계에서 오래 머물고 문구가 전혀 바뀌지 않습니다.
• UI가 반응하지 않습니다.
• 같은 입력이 같은 기기에서 매번 같은 지점에 멈춥니다.
• 이전 안정 버전에서는 없던 동작이 이번 버전에서만 나타납니다.

현재 동작과 관련해 알아둘 점

• 가져오기 중에는 뷰어가 자동으로 Data로 전환될 수 있습니다. 정상 전환이며 열기 실패를 뜻하지 않습니다.
• 3D에는 충분한 보드 수준 기하를 가진 보드 세션이 필요합니다. 그 입력이 없어서 명확한 문제 메시지가 보이는 것은 성능 문제가 아닙니다.
• 거대한 IPC-2581 입력은 더 이상 열기 시점의 메모리 안정성 검사로 사전에 중단되지 않습니다. 매우 느리거나 결국 실패한다면 실제 가져오기 경로 문제로 기록하세요.

기록하면 좋은 정보

• 기기와 플랫폼
• 입력 형식과 크기
• 앱이 멈춘 단계
• 그 상태가 지속된 시간
• UI가 계속 반응했는지 여부
• 문제가 한 보기에서만 나타나는지 여부

자주 묻는 질문

오래 기다리면 항상 문제가 있는 건가요?

아닙니다. 큰 보드, 첫 3D 보기 구성, 제조 패키지 인식은 눈에 띄는 대기 시간을 만들 수 있습니다. 중요한 것은 상태가 계속 진전되는지입니다.

왜 정확한 단계를 기록하는 것이 중요한가요?

현재 버전은 가져오기와 3D 로딩을 이미 명확한 단계로 나누어 보여줍니다. 단계를 기록하면 재현과 진단이 훨씬 빨라집니다.