문서 버전 v2026.07.07.0

PDF 다운로드

권한 및 파일 접근

목표

문제가 앱 로직에서 온 것인지, 시스템 파일 접근 제한에서 온 것인지 구분합니다.

지원 플랫폼

• iOS
• macOS

대상 독자

• 파일이 보이지 않거나 저장 대상 접근 문제로 막힌 사용자
• 권한 문제와 앱 로직 실패를 구분해야 하는 테스터

사전 준비

• 구체적인 가져오기, 내보내기, 드래그 앤 드롭 경로가 이미 실패했거나 예상과 다르게 동작했습니다.
• 같은 경로를 다시 시도하며 시스템 권한 프롬프트가 나타나는지 관찰할 수 있습니다.

단계

1. 같은 경로를 다시 시도하고 시스템 권한 프롬프트가 나타나는지 봅니다.
2. 원본 또는 대상 위치가 앱에서 실제로 접근 가능한지 확인합니다.
3. iOS의 PNG -> Photos 같은 플랫폼별 규칙과 맞물린 실패인지 확인합니다.
4. 정확한 오류 문구와 관련된 대략적인 위치를 기록합니다.

결과

• 문제가 시스템 접근 제한에서 온 것인지, 다른 앱 수준 문제에서 온 것인지 판단할 수 있습니다.

현재 자주 보이는 권한 시나리오

• 파일 선택기가 대상 데이터를 보지 못함
• 파일 선택 후 시스템이 접근을 거부함
• 대상에 쓰는 동안 내보내기가 실패함
• iOS에서 Photos 저장이 실패함
• 드래그 앤 드롭이 시스템에 의해 차단됨

권장 확인 순서

1. 시스템이 권한 프롬프트를 보여주었는지 확인합니다.
2. 대상 데이터가 앱이 접근할 수 있는 위치에 있는지 확인합니다.
3. iOS에서는 Photos 대상이 PNG에만 적용된다는 점을 기억합니다.
4. macOS에서는 저장 패널의 대상 위치에 쓸 수 있는지 확인합니다.
5. 정확히 같은 경로를 다시 시도해 문제가 재현되는지 확인합니다.

알아둘 동작 사실

• 사용자가 파일 선택을 의도적으로 취소하면 앱은 그것을 오류 알림으로 취급하지 않습니다.
• 드래그 앤 드롭 가져오기는 시스템이 유효한 fileURL을 제공하는지에 달려 있습니다. 권한이 없으면 앱은 이를 해석할 수 없습니다.
• iOS에서 Photos로 내보내는 경로는 별도 경로이며, 일반 Files 내보내기와 같지 않습니다.

기록하면 좋은 정보

• 플랫폼과 시스템 버전
• 대략적인 대상 위치
• 시스템 권한 프롬프트가 보였는지 여부
• 실패가 가져오기, 내보내기, 드래그 앤 드롭 중 어디에서 발생했는지
• 정확한 오류 문구

자주 묻는 질문

파일이 있는데 왜 선택기에서 안 보이나요?

대부분은 앱이 파일을 모르는 것이 아니라 시스템 접근 범위 제한 때문입니다. 파일을 더 직접적으로 접근 가능한 위치로 옮긴 뒤 다시 시도하세요.

내보내기 실패는 곧 기능 고장인가요?

아닙니다. 쓸 수 없는 대상, 권한 누락, 형식과 대상의 불일치도 내보내기 실패를 일으킬 수 있습니다.

왜 사진 앱 저장은 PNG만 가능한가요?

Photos 경로가 PNG에 연결되어 있기 때문입니다. 다른 내보내기 형식은 Files 또는 공유 시트를 사용합니다.