brunch

You can make anything
by writing

C.S.Lewis

by Lawn Jan 26. 2023

[HIG] File management

문서와 파일을 관리하는 방법

본 문서는 Apple의 Human Interface Guideline(이하 HIG) 문서를 한글로 번역한 것입니다. iOS 생태계 내에서 HIG를 읽으시는 분들이 번역본이 없어 불편함을 겪는 것을 알게 되었고, 이에 한글로 번역을 하게 되었습니다. iOS 커뮤니티 Async Swift에서 자율적으로 모인 9명이 함께 번역했으며, 일체의 상업적인 목적을 띄지 않습니다. 이 문서를 학습에 적극적으로 이용해 주시돼, 상업적인 용도로 이용하시는 것은 지양해 주시기 바랍니다. 감사합니다.

Introduction

사용자 경험에 따라, 사람들은 앱 혹은 시스템 전반에서 문서와 파일들을 관리하는 것을 원합니다.

Pages, Keynote, 사진, 메모, Sketch, 그리고 Adobe Illustrator와 같은 문서 기반 앱은 사람들이 문서와 파일을 만들고, 편집하고, 저장하는 데 도움을 주며, 종종 사람들이 앱에서 보고 싶은 콘텐츠를 찾아볼 수 있는 적절한 방법을 제공합니다.

플랫폼에 따라 사람들은 앱을 열지 않고 파일을 탐색할 수도 있습니다. Mac에서 사람들은 Finder를 사용하여 macOS 파일 시스템에 접근합니다. iPhone 및 iPad에서 사람들은 파일 앱을 사용하여 기기의 문서와 파일을 관리합니다. watchOS 및 tvOS에서 사람들은 일반적으로 문서를 작성, 편집 및 관리하지 않습니다.

Opening files

사람들은 파일 탐색 및 파일을 열기 위한 시스템 및 인터페이스에 익숙하므로 앱에서 이러한 경험을 잘 활용하는 것이 좋습니다.

앱 메뉴와 키보드 단축키를 사용해서 문서를 만들거나 열 수 있는 편리한 방법을 제공하세요. macOS 및 iPadOS에서 사람들은 앱 수준(app-level)의 파일 메뉴에서 명령어를 사용해 새로운 문서를 만들거나 기존 문서를 열기를 원합니다. 새로 만들기 또는 열기...(New or Open…)와 같은 메뉴 명령을 활성화하면 macOS는 메뉴 막대 파일 메뉴에 해당 명령을 표시하고, iPadOS는 연결된 하드웨어 키보드에서 Command 키를 누르고 있을 때 표시되는 바로 가기 인터페이스를 제공합니다. iOS는 이러한 방식으로 메뉴를 표시하지 않으므로 추가(+) 버튼을 사용하여 "새 문서" 작업을 활성화하는 것이 좋습니다.

사용자 정의 파일 열기 인터페이스(custom file-opening interface) 방식에 사람들의 시스템에 대한 이해를 반영하세요. Finder와 파일 앱을 사용하면 기기의 파일 시스템의 기본 레이아웃을 이해할 수 있으므로 사용자 지정 파일 열기에서는 이러한 이해를 기반으로 제공하는 것이 좋습니다. 문서 또는 iCloud 폴더 또는 가장 최근에 선택한 위치와 같은 사용자 지정 인터페이스 내 파일 시스템의 한 부분을 표시하는 것으로 시작하는 것이 바람직할 수도 있지만 다른 곳을 탐색하려는 사용자에게 이 영역 내에 남아 있으라고 강요하지는 마세요.

사용자 정의 파일 열기 인터페이스(custom file-opening interface)를 보다 편리하게 만드는 방법을 고려하세요. 예를 들어, 사람들은 단순한 "열기" 작업 외에 "최근 열기" 작업을 더 선호할 수 있습니다. 또한 사람들이 파일 탐색 경험을 필터링할 기준을 선택하거나 여러 문서를 선택하여 한 번에 열 수 있도록 할 수도 있습니다. MacOS 열기 패널에서 열기 단추의 제목을 사용자 지정하여 작업을 반영할 수 있습니다. 예를 들어, 앱에서 사용자가 현재 문서에 파일 내용을 삽입하고자 하는 경우 제목을 삽입으로 변경할 수 있습니다.

Saving work

사람들이 작업을 취소하거나 삭제하지 않는 한 작업이 항상 유지된다는 확신을 가질 수 있게 하는 것이 좋습니다. 일반적으로 사람들이 작업을 저장하기 위한 불필요한 작업이 필요하도록 하지 마세요. 대신 편집 중일 때, 파일을 닫을 때 혹은 다른 앱으로 전환할 때 주기적으로 자동 저장하는 것이 좋습니다..

사용자가 파일 이름, 형식 또는 위치를 변경할 수 있도록 저장 인터페이스를 제공하세요. 기본적으로, 새 문서의 제목은 사용자가 이름을 작성하기 전까지 "제목 없음"입니다. 열기 인터페이스와 마찬가지로 저장 뷰는 사람들이 원하는 위치에 문서를 저장할 수 있도록 저장할 위치를 찾을 수 있습니다. 다른 형식으로 문서를 저장할 수 있는 경우, 사용자가 특정 파일 형식을 선택할 수 있습니다.

역자설명 : 간단하게 설명하면 다음과 같이 다른 이름으로 저장을 통해 이름을 변경하거나 저장할 위치를 찾거나 문서의 확장자를 변경할 수 있습니다.

파일 확장자를 기본적으로 표시하지 않지만 사용자가 원하는 경우 볼 수 있도록 하세요. 표시하는 모든 "저장" 또는 "열기" 인터페이스에 현재 선택 사항을 반영해야 합니다.

필요한 경우 저장 다이얼로그(Save dialog)의 기능을 추가로 제공하세요. 앱에서 사용할 수 있는 경우 유용한 설정 또는 옵션이 포함된 사용자 지정 액세서리 뷰(custom accessory view)를 저장 다이얼로그(Save dialog)에 추가할 수 있습니다. 예를 들어, 메일을 파일로 저장하기 위한 대화 상자에는 파일을 첨부할지를 묻는 선택사항이 있습니다.

역자설명 : 하단의 이미지는 아이폰의 키보드에서 볼 수 있는 액세서리 뷰입니다.

출처 - Apple Developer

Quick Look previews

미리 보기를 사용하면 사용자들이 사전에 파일의 내용을 알고 작업을 할 수 있습니다. 예를 들어, 맥에서는 사람들이 오디오 파일의 미리 보기를 재생할 수 있고, iOS에서 사람들은 사진의 미리 보기에 마크업을 추가할 수 있습니다.

역자설명 : 하단의 이미지가 사진의 빠른 미리 보기(Quick Look Preview)입니다.

적절한 경우 앱에 빠른 미리 보기 뷰어(Quick Look Viewer)를 구현하는 것이 좋습니다. 앱에서 사용자가 파일(특히 기본적으로 지원하지 않는 파일)을 첨부하거나 다른 방법으로 상호 작용할 수 있는 경우 빠른 미리 보기 뷰어(Quick Look Viewer)를 구현하면 사용자가 앱을 떠나지 않고 해당 파일을 미리 볼 수 있습니다.

앱에서 사용자 지정 파일 형식을 생성하는 경우 미리 보기 생성기(Quick Look generator)를 구현하는 것이 좋습니다. 미리 보기 생성기(Quick Look generator)를 사용하면 Finder, Files 및 Spotlight를 포함한 다른 응용 프로그램에서 문서의 미리 보기를 표시하여 사용자가 문서를 더 쉽게 찾을 수 있습니다.

Platform consideration

No additional considerations for tvOS or watchOS.

iOS, iPadOS

앱이 다른 앱과 파일을 공유하는 것이 적절하다면 앱 문서 가져오기, 내보내기, 열기 및 이동을 위한 사용자 정의 인터페이스를 표시하는 파일 제공 앱 익스텐션(file provider app extension)을 만들 수 있습니다. 개발자 가이드라인은 File Provider를 참고하세요. 앱 익스텐션은 사용자들이 시스템에 특정 기능을 추가하기 위한 목적으로 설치해 사용할 수 있도록 제공하는 코드입니다. 자세한 내용은 App extensions을 참고하세요.

역자설명 : 확장 프로그램(Extension) 또는 확장 기능은 기존 기능의 동작을 변경하거나 완전히 새로운 기능을 추가하는 프로그램입니다. 기본 기능에 외부 개발자가 개발한 프로그램을 추가함으로써 맞춤화, 보안성 향상, 검색 기능 향상, 북마크 기능 추가, 번역 기능 등 기능과 성능을 향상합니다. 예를 들면 크롬에서 확장파일을 설치해 다양한 기능을 추가하는 것이 있습니다.

누군가가 파일 제공 익스텐션을 사용해서 문서를 열거나 가져올 때 적절한 문서만 표시하세요. 예를 들어 PDF 편집 앱이 익스텐션을 사용해 문서를 불러오는 경우 가져올 수 있는 PDF 파일만 보여줍니다. 수정 날짜, 크기, 문서가 로컬저장소에 위치해 있는지 원격저장소에 위치했는지와 같은 추가 정보를 표시할 수도 있습니다.

문서를 내보내고 이동할 때 사람들이 위치를 선택할 수 있도록 하세요. 앱이 단일 디렉터리에 문서를 저장하지 않는 한 사람들이 다른 디렉터리의 특정 위치로 문서를 내보내거나 이동할 수 있도록 하세요. 필요한 경우 새로운 하위 디렉터리를 추가하는 방법을 제공할 수도 있습니다.

사용자 정의 내비게이션 바를 함께 제공하는 것은 좋지 않습니다. 익스텐션은 이미 탐색이 포함된 모달 뷰 내에서 불러와집니다. 또 다른 탐색 모음을 제공하는 것은 사용자들에게 혼란을 줄 수 있고, 콘텐츠에서 불필요한 공간을 차지합니다.

또한 앱을 통해 사람들이 다른 앱에서 파일을 탐색하고 열 수 있습니다. 개발자 가이드라인은 Adding a document browser to your app을 참고하세요.

macOS

Finder Sync 익스텐션

앱이 로컬 및 원격 파일을 동기화하는 경우 Finder Sync 익스텐션을 생성하여 Finder 내에서 파일 동기화 상태 및 제어를 표현할 수 있습니다. 개발자 가이드라인은 Finder Sync를 참고하세요.

예를 들어 Finder Sync 익스텐션을 이렇게 쓸 수 있습니다.

항목의 동기화 상태를 나타내는 배지를 Finder에 표시

즐겨찾기 및 비밀번호 보호 추가와 같은 파일 및 폴더 관리 작업을 수행하는 맞춤형 콘텍스트 메뉴 항목 제공

동기화 작업 시작과 같은 전역(global) 작업을 수행하는 사용자 지정 툴바 제공

사람들이 자동 저장을 꺼도 작업에 대한 손실이 없도록 하는 것이 좋습니다. 시스템 설정 창에서 "문서를 닫을 때 변경 사항을 유지하도록 요청"에서 자동 저장을 끌 수 있습니다. 이 경우 문서에 저장되지 않은 변경 사항이 있을 때 문서를 닫거나, 앱을 종료하거나, 로그아웃하거나, 다시 시작한다면 저장 다이어로그를 표시합니다.

자동 저장이 꺼져 있으면 문서에 저장되지 않은 변경 사항이 있을 때 사람들에게 알리세요. 저장되지 않은 변경 사항이 있음을 사용자들에게 알리기 위해 문서 창의 닫기 버튼에 점을 표시하고 앱의 창 메뉴에서 문서 이름 옆에 점을 표시합니다. 자동 저장이 켜져 있을 때는 사용자들이 혼동할 수 있으니 점을 표시하지 않는 것이 좋습니다. 자동 저장 상태에 관계없이 제목 표시줄의 문서 제목에 "편집됨"을 표시할 수 있지만, 자동 저장되거나 사람들이 작업을 저장할 때 이 표시를 가려야 합니다.