자주 묻는 질문 (FAQ)
설치 및 권한
AppPorts에 어떤 권한이 필요한가요?
AppPorts는 /Applications 디렉토리를 읽고 수정하기 위해 전체 디스크 접근 권한이 필요합니다. 첫 실행 시 인증을 안내합니다. 시스템 설정 → 개인정보 보호 및 보안 → 전체 디스크 접근에서 수동으로 추가할 수도 있습니다.
어떤 macOS 버전을 지원하나요?
최소 지원 버전은 macOS 12.0 (Monterey)입니다. macOS 15.1 (Sequoia) 이상은 추가로 App Store 앱의 외장 드라이브 설치와 제자리 업데이트를 지원합니다.
앱 마이그레이션
/Applications 외부의 앱은 어떻게 스캔하나요?
"Mac 로컬 앱" 헤더의 "+" 버튼을 클릭해 추가 스캔 디렉토리를 지정합니다. JetBrains Toolbox, Steam처럼 사용자 지정 위치에 앱을 설치하는 도구에 유용합니다. 추가한 디렉토리는 자동으로 저장되고 변경 사항도 모니터링됩니다. 디렉토리를 추가하면 헤더에 사용자 지정 디렉토리 수가 표시되며, 이 숫자 메뉴를 열어 추가한 디렉토리를 확인하거나 제거할 수 있습니다.
마이그레이션 후 앱이 열리지 않으면 어떻게 하나요?
- 외장 저장소가 연결되어 있고 접근 가능한지 확인
- 앱 상태 배지 확인: "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 앱 마이그레이션"을 활성화합니다. 수동 마이그레이션 후 앱 업데이트 시 재마이그레이션이 필요합니다.
마이그레이션 전에 "보호된 앱" 경고가 표시되는 이유는 무엇인가요?
App Store 앱 또는 root 소유 앱은 일반적으로 macOS 권한으로 보호되어 AppPorts가 로컬 사본을 자동으로 삭제하거나 교체하지 못할 수 있습니다. 이 경고가 표시되면 먼저 Finder에서 앱을 외장 저장소로 수동 이동하고(macOS가 관리자 암호를 요청합니다), 다시 AppPorts로 돌아와 외부 앱에 대한 로컬 링크를 만드는 것이 더 안전합니다. 자동 마이그레이션을 계속할 수는 있지만 권한 부족으로 실패할 수 있습니다.
마이그레이션이 느리거나 멈췄어요. 어떻게 하나요?
- 마이그레이션 진행률 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 페이지에 제출해 주세요. 진단 패키리(메뉴바 → 로그 → 진단 패키지 내보내기)를 포함하면 문제 해결이 빨라집니다.