자주 묻는 질문 (FAQ)
설치 및 권한
AppPorts에 어떤 권한이 필요한가요?
AppPorts는 /Applications 디렉토리를 읽고 수정하기 위해 전체 디스크 접근 권한이 필요합니다. 첫 실행 시 인증을 안내합니다. 시스템 설정 → 개인정보 보호 및 보안 → 전체 디스크 접근에서 수동으로 추가할 수도 있습니다.
어떤 macOS 버전을 지원하나요?
최소 지원 버전은 macOS 12.0 (Monterey)입니다. macOS 15.1 (Sequoia) 이상은 추가로 App Store 앱의 외장 드라이브 설치와 제자리 업데이트를 지원합니다.
앱 마이그레이션
마이그레이션 후 앱이 열리지 않으면 어떻게 하나요?
- 외장 저장소가 연결되어 있고 접근 가능한지 확인
- 앱 상태 배지 확인: "Orphan Link"이면 외부 앱이 손실됨; 수동 링크 해제 필요
- "손상됨" 메시지가 나타나면 앱을 우클릭하고 "재서명" 선택
- 그래도 해결되지 않으면 외부 앱 라이브러리에서 "로컬로 다시 이동" 선택
"손상됨" 메시지가 보이면 어떻게 하나요?
macOS의 코드 서명 메커니즘이 앱 패키지 구조의 변경을 감지한 것입니다. 해결 방법:
- AppPorts에서 앱을 우클릭합니다
- "재서명"을 선택합니다
- AppPorts가 자동으로 원본 서명을 백업하고 Ad-hoc 재서명을 실행합니다
자세한 메커니즘은 재서명 및 충돌 방지를 참조하세요.
외장 저장소를 분리하면 앱이 충돌하나요?
로컬 엔트리(Stub Portal)가 open을 호출하여 외부 앱을 실행하려고 시도합니다. 외장 저장소가 연결되어 있지 않으면 앱은 충돌하지 않지만 실행할 수 없습니다. 외장 저장소를 다시 연결하면 정상적으로 사용할 수 있습니다.
마이그레이션 후 앱을 업데이트할 수 있나요?
앱 유형에 따라 다릅니다:
| 앱 유형 | 자동 업데이트 가능 | 비고 |
|---|---|---|
| 네이티브 앱 (자체 업데이트 없음) | ✓ | 정상 업데이트 |
| Chrome, Edge (커스텀 업데이터) | ✓ | 업데이트가 로컬에 설치; AppPorts가 버전 차이를 감지하여 "마이그레이션 대기 중" 태그 지정 |
| Sparkle / Electron 앱 | ✗ | 잠금이 앱 내부 업데이트를 방지; 업데이트 전에 AppPorts를 통해 로컬로 복원해야 함 |
| App Store 앱 (macOS 15.1+) | ✓ | App Store가 외장 드라이브에서 제자리 업데이트 가능 |
| App Store 앱 (macOS <15.1) | ✗ | 수동 재마이그레이션 필요 |
App Store 앱을 외장 드라이브로 마이그레이션하려면 어떻게 하나요?
macOS 15.1+: App Store 설정에서 "외장 드라이브에 대용량 앱 다운로드 및 설치"를 활성화하고, AppPorts와 동일한 외장 저장소를 선택합니다.
macOS <15.1: AppPorts 설정에서 "App Store 앱 마이그레이션"을 활성화합니다. 수동 마이그레이션 후 앱 업데이트 시 재마이그레이션이 필요합니다.
마이그레이션이 느리거나 멈췄어요. 어떻게 하나요?
- 마이그레이션 진행률 100%에서 로컬 엔트리를 생성하는 동안 1-2초 일시 정지가 발생할 수 있습니다
- 대용량 앱(예: Xcode, Adobe)은 마이그레이션에 시간이 더 걸립니다 — 정상입니다
- 오랫동안 멈춰 있으면 외장 저장소 연결 안정성을 확인하세요
- USB 2.0은 느립니다; USB 3.0 이상 또는 Thunderbolt 사용을 권장합니다
데이터 디렉토리 마이그레이션
데이터 디렉토리 마이그레이션 후 데이터가 손실되나요?
아닙니다. AppPorts는 심볼릭 링크 전략을 사용합니다: 데이터가 먼저 외장 저장소에 완전히 복사되고; 복사 성공이 확인된 후에만 원본 로컬 디렉토리가 삭제됩니다. 모든 실패 단계에서 자동 롤백이 트리거됩니다.
언제 데이터 디렉토리 마이그레이션이 앱 문제를 유발할 수 있나요?
- 파일 잠금 또는 SQLite WAL 로그를 사용하는 앱
- 심볼릭 링크를 통해 확장 속성이 손실될 수 있음
- 동일 Team 하위의 여러 앱이 공유하는 Group Containers 디렉토리
마이그레이션된 데이터 디렉토리를 어떻게 복원하나요?
AppPorts의 데이터 디렉토리 관리 인터페이스에서 마이그레이션된 디렉토리를 선택하고 "복원"을 클릭합니다. AppPorts가 심볼릭 링크를 삭제하고 외장 저장소에서 로컬로 데이터를 다시 복사합니다.
기타
AppPorts가 제 데이터를 수집하나요?
아닙니다. AppPorts는 완전히 오프라인으로 실행되며 어떠한 사용자 데이터도 수집하거나 업로드하지 않습니다. 로그 파일은 ~/Library/Application Support/AppPorts/에 로컬로 저장됩니다.
문제를 어떻게 보고하나요?
프로젝트 Issues 페이지에 제출해 주세요. 진단 패키리(메뉴바 → 로그 → 진단 패키지 내보내기)를 포함하면 문제 해결이 빨라집니다.