Xcode를 사용하여 macOS에서 Plist 파일을 편집하는 방법

macOS에서는 Xcode의 구조적 편집기를 사용하여 속성 목록(.plist) 파일을 편집할 수 있습니다 . 파일을 백업한 후 Xcode에서 열고, 문서화된 키와 값만 변경한 다음 저장하세요. 타사 앱의 설치된 번들을 편집하지 마세요. 서명된 앱을 변경하면 서명이 무효화되거나 업데이트가 제대로 작동하지 않을 수 있습니다. 자체 앱의 경우 프로젝트 소스 또는 빌드 설정을 편집하고 다시 빌드하세요.

plist 파일을 직접 편집해야 하는 경우는 언제인가요?

속성 목록(plist)은 문자열, 숫자, 부울 값, 배열, 딕셔너리와 같은 구조화된 데이터를 저장합니다. 앱의 plist는 앱 Info.plist의 번들을 설명하며, 별도의 plist 파일에 환경설정을 저장할 수 있습니다. 앱에서 제공하는 파일과 키를 사용하세요. 새로운 키를 만들어도 해당 설정에 대한 지원이 추가되지 않습니다.

편집하기 전에 해당 파일이 앱 메타데이터인지 사용자 환경 설정인지 확인하세요. 사용 중인 앱의 기능을 변경하려면 해당 앱의 설정이나 설명서를 참조하세요. 환경 설정 파일은 앱이 실행되거나 종료될 때 덮어쓰여질 수 있으며, 설치된 번들의 환경 설정은 Info.plist일반 설정 패널이 아닙니다.

직접 관리하는 Xcode 프로젝트의 경우, 먼저 대상의 정보 창과 빌드 설정을 확인하세요. Xcode는 Info.plist빌드 시점에 파일을 생성할 수 있으므로, 빌드된 파일을 편집하는 것은 임시적인 조치일 수 있습니다. Apple의 편집 가이드 에서는 구조화된 편집기에 대해 설명하고 있으며, 빌드 설정 참조 문서 에서는 생성된 값에 대해 설명합니다.

Xcode를 사용하여 plist 파일을 편집합니다.

1. Xcode 설치

맥 앱 스토어 에서 Xcode를 다운로드하세요 . 현재 무료로 제공되고 있으며, 사용 중인 맥 버전에 필요한 시스템 요구 사항은 앱 스토어 페이지를 확인하세요. 설치 후 Xcode를 한 번 실행하세요.

2. 작동 가능한 백업을 만드세요

Finder에서 plist 파일을 찾아 복제하거나 작업 폴더에 복사한 후 편집하세요. 변경 사항을 확인하기 전까지는 원본 파일을 보관하십시오. 백업 파일은 앱 .app번들 외부에 저장해야 합니다. 앱 번들에 파일을 추가하면 서명된 콘텐츠가 변경될 수 있습니다.

3. 필요한 경우 앱 내에서 파일을 찾으세요.

앱 번들을 검사하려면 Finder에서 앱을 Control 키를 누른 채 클릭하고 '패키지 내용 보기'를 선택하세요 . 그러면 앱의 내부 폴더가 표시됩니다. 이 기능을 사용하여 파일을 찾거나, 직접 관리하고 다시 빌드하거나 서명할 수 있는 앱만 편집하세요. 타사 앱은 제자리에서 패치하지 마세요.

4. 번들 내의 plist 파일을 엽니다.

파일을 열고 Contents해당 파일을 찾으세요 Info.plist. 다른 plist 파일은 다른 위치에 있을 수 있으므로 앱 또는 프로젝트 설명서를 참조하세요. 독립 실행형 파일의 경우 Finder에서 일반적으로 사용하는 위치를 사용하세요.

5. Xcode에서 파일을 엽니다.

plist 파일을 Control 키를 누른 상태에서 클릭하고 [ 연결 프로그램] > [Xcode]를 선택합니다 . Xcode가 보이지 않으면 [기타]를 선택하고 [응용 프로그램]에서 Xcode를 선택합니다. 또는 [파일] > [열기]를 사용하여 Xcode를 직접 열 수도 있습니다 . 구조화된 plist 파일은 키, 유형, 값 행으로 표시됩니다.

6. 기존 값을 변경하거나 행을 추가합니다.

기존 값을 클릭하여 편집하세요. 설정을 추가하려면 편집기에서 Control 키를 누른 채 클릭하고 ' 행 추가'를 선택 하거나 '컨트롤 추가'를 클릭하세요. 앱에서 제공하는 정확한 키를 사용하세요. 오타가 있거나 지원되지 않는 키는 무시될 수 있습니다.

7. 값 유형을 확인하고 저장합니다.

값 유형을 문서화된 형식과 일치시키십시오. 부울, 숫자 및 문자열은 서로 바꿔 사용할 수 없습니다. 배열은 순서가 있는 항목을 저장하고, 사전은 이름이 지정된 값을 저장합니다. 추측하거나 중복된 키를 누르지 않도록 주의한 다음 Command-S를 누르십시오 .

• 문자열: 식별자 또는 레이블과 같은 텍스트입니다.
• 부울 값: 참 또는 거짓.
• 숫자: 정수 또는 실수.
• 배열 또는 딕셔너리: 이름이 지정된 값들의 목록 또는 그룹.

8. 저장된 파일을 다시 열고 확인하십시오.

plist 파일을 닫았다가 다시 열어 값이 유지되었는지 확인하세요. 본인의 프로젝트에서는 다시 빌드하고 복사본을 테스트해 보세요. 앱이 설정을 무시하는 경우, 올바른 소스 파일을 편집했는지 확인하세요. 앱은 다른 위치에 있는 환경설정 파일을 읽거나 실행 시 덮어쓸 수 있습니다. 앱 실행에 실패하면 백업을 복원하거나 앱을 다시 설치하세요.

중요 서명 및 문제 해결 참고 사항

Apple은 서명된 앱 번들을 수정하면 서명이 무효화될 수 있으며, 업데이트로 인해 수정 사항이 덮어쓰여질 수 있다고 경고합니다. 직접 관리하는 소프트웨어의 경우 소스 plist 또는 대상 설정을 변경한 다음 다시 빌드하십시오. 일반적인 환경 설정은 앱 설정에서 사용하십시오. plist를 편집하기 위해 macOS 보호 기능을 비활성화하지 마십시오.

Xcode에서 저장할 수 없는 경우, 쓰기 가능한 복사본을 사용하여 작업하십시오. 재빌드 후 변경 사항이 사라지면 소스 코드 또는 빌드 설정을 업데이트하십시오. 키가 무시되는 경우, 앱 문서에서 해당 키의 철자, 유형 및 위치를 확인하십시오.

자세한 내용은 Apple의 정보 속성 목록 문서 와 macOS 코드 서명에 대한 기술 노트를 참조하십시오 .