라이브러리와 리비전¶
목표¶
흩어진 프로젝트 파일을 다시 열고, 새 리비전으로 확장하고, 공유할 수 있는 보드 작업 공간으로 정리합니다.
지원 플랫폼¶
iOSmacOS
대상 독자¶
- 가져온 보드를 재사용 가능한 라이브러리로 정리하려는 사용자
- 문서, 리비전, 공유 동작을 검증하는 테스터
사전 준비¶
- 앱이 라이브러리 홈 페이지에 열려 있습니다.
- 최소 하나의 문서가 있거나 가져올 프로젝트 파일이 준비되어 있습니다.
단계¶
- 그리드 또는 목록 모드에서 문서 목록을 확인하고, 대상 문서의 동작 메뉴를 엽니다.
- 문서 수준 동작을 사용해 정보 확인, 리비전 추가, 복제, 고정, 공유를 수행합니다.
- 변경 후 문서를 다시 열어 리비전과 세부 정보가 라이브러리에 반영되었는지 확인합니다.
결과¶
- 문서는 재사용 가능한 프로젝트 항목으로 정리되고, 불필요한 최상위 중복 없이 리비전을 유지할 수 있습니다.
라이브러리 홈에서 할 수 있는 일¶
- 그리드와 목록 레이아웃 전환
- 새 설계 또는 제조 문서 가져오기
- 일괄 선택 및 일괄 삭제 진입
- 각 문서의 썸네일, 형식, 마지막으로 연 시간, 리비전 수 확인
- 단일 문서의 이름 변경, 복제, 고정, 삭제, 공유, 정보 확인
문서와 리비전의 관계¶
- 문서: 라이브러리 안의 하나의 프로젝트 항목
- 리비전: 그 문서 아래의 과거 버전
- 현재 리비전: 현재 열려 있고, 표시되고, 내보내는 리비전
리비전을 추가해도 앱은 별도의 최상위 카드를 만들지 않습니다. 대신 카드의 revisionCount가 증가하고, 문서 안에서 현재 리비전을 전환할 수 있습니다.
KiCad Project 문서의 소스 트리¶
문서가 KiCad .kicad_pro에서 왔다면, 라이브러리는 단일 진입 파일만 저장하지 않습니다. 해당 리비전과 연결된 프로젝트 파일도 함께 보관합니다. 열고 나면 작업 공간의 Project 페이지가 다음처럼 내용을 묶어 보여줍니다.
Source Documents: PCB 파일, 회로도 시트, 열 수 있는 기타 설계 문서.Libraries: 프로젝트에 포함되었거나 참조된 심볼, 풋프린트, 기타 라이브러리 파일.Settings:.kicad_pro및 프로젝트 설정 파일.
이 구조 덕분에 한 프로젝트의 PCB와 회로도를 같은 라이브러리 문서와 리비전 문맥 안에 둘 수 있습니다. 리비전을 추가할 때는 나중에 시트, 라이브러리, 설정이 빠지지 않도록 전체 프로젝트나 관련 프로젝트 파일을 함께 가져오는 편이 좋습니다.
문서 메뉴의 핵심 동작¶
각 문서 카드 메뉴에서 다음을 할 수 있습니다.
- 설계 리비전 추가
- 제조 리비전 추가
- SES 가져오기
- 이름 변경
- 복제
- 정보 보기
- 공유
- 고정 / 고정 해제
- 삭제
SES의 특별 규칙¶
SES는 일반적인 새 문서 가져오기 경로가 아닙니다. 현재 버전에서는 다음 순서가 필요합니다.
- 대상 문서의 동작 메뉴를 엽니다.
Import SES를 선택합니다.- 목록에서 사용할 수 있는 기준 리비전을 선택합니다.
해당 문서에 적합한 기준 리비전이 없으면 앱은 조용히 실패하지 않고 상태 메시지를 보여줍니다.
문서 정보 페이지에 표시되는 것¶
Information을 클릭하면 다음을 확인할 수 있습니다.
- 문서 이름
- 파일 형식
- 가져온 시간
- 마지막으로 연 시간
- 현재 리비전 ID
- 전체 리비전 수
- 전체 리비전 목록
이 정보는 모두 테스트 메모와 문제 재현 기록에 복사할 수 있습니다.
사용 팁¶
- 같은 프로젝트가 계속 발전하는 경우 리비전 추가를 우선 사용하세요.
- 실험적인 분기를 보존하고 싶다면 복제로 별도 문서를 만드세요.
- 중요한 문서는 고정해 실수로 삭제하거나 잘못 선택할 위험을 줄이세요.
- 가져오기가 끝나면 현재 리비전을 한 번 열어 내용, 썸네일, 마지막으로 연 시간이 제대로 갱신되었는지 확인하세요.
자주 묻는 질문¶
한 문서 안에 왜 리비전이 여러 개 있나요?¶
현재 라이브러리 모델은 프로젝트의 지속적인 변화를 관리하도록 설계되어 있기 때문입니다. 여러 리비전은 하나의 프로젝트 문맥 안에서 변경 이력을 추적하게 해 줍니다.
가져오는 도중 다른 문서를 열면 새로 가져온 문서로 초점이 넘어가나요?¶
아닙니다. 가져오기는 계속 진행되고 완료되지만, UI를 새로 가져온 문서로 강제로 되돌리지 않습니다.
공유하면 문서 전체 패키지가 전달되나요?¶
라이브러리 공유 동작은 현재 문서의 공유 가능한 루트 경로에서 공유 항목을 준비합니다. 묶음 또는 디렉터리 기반 원본의 경우, 공유 결과는 단순 텍스트 요약만이 아니라 그 소스 루트를 기준으로 만들어집니다.