가져오기 실패¶
목표¶
현재 실패가 지원되지 않는 입력 때문인지, 가져오기 경로가 맞지 않아서인지, 또는 상태 보호 중단인지 빠르게 판단합니다.
지원 플랫폼¶
iOSmacOS
대상 독자¶
- 가져오기 경로가 기대대로 동작하지 않은 사용자
- 가져오기 실패, 무시된 가져오기, 부분적으로 저하된 가져오기 결과를 분류하는 테스터
사전 준비¶
- 확인할 구체적인 가져오기 사례, 메시지, 재현 경로가 있습니다.
- 가능하면 문제를 일으킨 원본 파일과 정확한 가져오기 경로를 보관합니다.
단계¶
- 실패가 파일 선택 전, 파일 선택 후, 작업 공간 진입 후 중 어디에서 발생했는지 구분합니다.
- 어떤 가져오기 경로를 사용했는지, 그 원본이 해당 경로에서 지원되어야 하는지 확인합니다.
- 변경 없는 재가져오기와 부분 DSN 저하 메시지를 포함해 아래 실패 패턴과 관찰한 동작을 비교합니다.
- 다시 시도하기 전에 정확한 메시지와 원본 문맥을 기록합니다.
결과¶
- 문제를 지원되지 않는 입력, 경로 불일치, 보호 중단, 변경 없는 재가져오기, 로컬 저하 사례 중 하나로 좁힐 수 있습니다.
먼저 확인할 세 가지¶
- 실패가 파일 선택 전, 파일 선택 후, 작업 공간 진입 후 중 어디에서 발생했나요?
- 앱이 명확한 오류 메시지를 보여주었나요?
- 동작이 새 가져오기, 리비전 추가, SES 중 무엇이었나요?
현재 가장 흔한 실패 유형¶
1. 지원되지 않는 입력 형식¶
흔한 징후:
- 앱이 확장자를 지원하지 않는다고 바로 말합니다.
- 파일을 고른 뒤 흐름이 멈춥니다.
권장 조치:
- 먼저 설계 경로를 썼는지 제조 경로를 썼는지 확인합니다.
- 그다음 입력이 현재 지원 범위에 속하는지 확인합니다.
2. 잘못된 IPC-2581 가져오기 의도¶
흔한 징후:
- 파일은 선택할 수 있지만, 가져온 결과가 기대와 다릅니다.
권장 조치:
- 다시 가져옵니다.
- 설계 쪽 데이터인지 제조 쪽 데이터인지 다시 선택합니다.
3. 잘못된 SES 사용¶
흔한 징후:
SES를 일반 새 문서처럼 가져오려고 합니다.- 또는 현재 문서에 사용할 수 있는 기준 리비전이 없습니다.
권장 조치:
- 대상 문서 메뉴를 엽니다.
Import SES에서 시작합니다.- 먼저 유효한 기준 리비전을 선택합니다.
4. 큰 IPC-2581이 느리게 열리거나 실제 가져오기 중 실패함¶
현재 버전은 매우 큰 IPC-2581 XML 입력을 보수적인 메모리 안정성 검사로 미리 중단하지 않습니다.
이런 원본이 여전히 실패한다면, 이제 실패는 열기 전 거부가 아니라 실제 가져오기 경로에서 발생합니다.
권장 조치:
- 정확한 오류 문구 또는 마지막으로 보인 로딩 단계를 기록합니다.
- 파일 크기, 플랫폼, 기기 모델을 기록합니다.
- 앱이 반응을 유지했는지, 멈췄는지, OS에 의해 종료되었는지 적습니다.
5. 다른 가져오기 작업이 이미 실행 중임¶
현재 버전은 PCB 가져오기 작업을 한 번에 하나만 허용합니다. 이전 가져오기가 아직 끝나지 않았다면 다음 가져오기 요청은 상태 메시지와 함께 거부됩니다.
6. 같은 이름·같은 형식 입력이 변경 없음으로 판단됨¶
같은 문서 이름과 같은 형식의 원본을 다시 가져오면, 현재 버전은 원본 소스 바이트를 비교합니다.
- 새로 가져온 원본 소스가 현재 리비전과 동일하면 앱은 변경된 내용이 없어 가져오기를 무시했다고 알립니다.
- 이것은 실패로 취급하지 않습니다. 중복 리비전을 피하기 위한 동작입니다.
- 새 리비전이 생겨야 한다고 생각한다면 파일 내용이 실제로 바뀌었는지 확인하세요.
7. DSN 로컬 기하가 성공적인 가져오기 후 저하됨¶
흔한 징후:
- 가져오기는 최종적으로 성공하고 문서가 열립니다.
- 하지만 일부 국소 세부 사항이 기대처럼 보이지 않습니다.
의미:
- 일부 국소 세부 사항을 표시하지 못했지만, 나머지 보드는 계속 사용할 수 있습니다.
- 이 동작은 전체 보드 가져오기가 실패하거나 앱이 크래시되는 일을 피하기 위한 것이며, 보통 전체 문서가 아니라 로컬 렌더링에만 영향을 줍니다.
권장 조치:
- 먼저 영향을 받은 영역이 원하는 작업에 여전히 쓸 수 있는지 확인합니다.
- 빠진 기하가 중요하다면 메시지 텍스트, 원본
DSN, 재현 단계를 기록해 후속 조사에 남깁니다.
KiCad 관련 추가 안내¶
KiCad 보드가 2D 관점에서 성공적으로 가져와졌더라도, 프로젝트 로컬 3D 자산이 없거나 읽을 수 없으면 이후 3D 또는 문제 세부 정보에서 이슈로 나타날 수 있습니다. 이것이 항상 2D 열기를 막지는 않지만, 3D의 완성도에는 영향을 줄 수 있습니다.
기록하면 좋은 정보¶
- 플랫폼과 기기
- 가져오기 경로 유형: 설계 / 제조 / SES
- 원본 파일 형식과 크기
- 원래 오류 문구
- 일관되게 재현되는지 여부
- 다른 가져오기 작업이 이미 실행 중이었는지 여부
자주 묻는 질문¶
어떤 제조 입력은 폴더인데도 가져올 수 있는 이유가 무엇인가요?¶
제조 경로가 디렉터리형 입력을 허용하기 때문입니다. 성공 여부는 앱이 그 디렉터리를 지원되는 제조 패키지로 인식할 수 있는지에 달려 있습니다.
실패했는데 왜 라이브러리에 새 카드가 하나도 없나요?¶
대개는 지원되지 않는 입력, 안정성 보호 중단, 앱 감지 실패처럼 문서 생성 전 단계에서 실패했다는 뜻입니다.
같은 파일 이름을 두 번째로 가져왔는데 왜 새 리비전이 안 생기나요?¶
앱이 변경된 내용이 없어 가져오기를 무시했다고 말한다면, 새로 가져온 원본 소스가 현재 리비전과 동일하다는 뜻입니다. 현재 버전은 중복 리비전을 만들지 않고 건너뜁니다.
두 번째 시도에서는 성공했습니다. 그래도 기록해야 하나요?¶
예. 간헐적인 실패도 안정성 평가에 중요합니다.