Plist 파일 읽고 편집하는 방법

plist 파일을 읽고 편집하는 것은 Apple의 설정 형식을 다루는 일입니다. macOS와 iOS를 조용히 움직이는 키-값 파일들입니다. 모든 앱에는 Info.plist가 있고, 예약된 모든 백그라운드 작업은 launchd plist이며, 모든 프로비저닝 프로파일과 모든 .mobileconfig 기기 프로파일은 그 속이 plist입니다. 형식 자체는 단순합니다. 딕셔너리, 배열, 문자열, 숫자, 불리언, 날짜, 바이너리 데이터가 원하는 만큼 깊게 중첩됩니다. 문제는 같은 형식이 두 가지 모습으로 배포되기 때문에 시작됩니다. 사람이 읽을 수 있는 XML과, 텍스트 편집기에서는 쓰레기처럼 보이는 compact한 바이너리 형식, 그리고 단 하나의 잘못된 타입이 작업을 영원히 실행되지 않게 만들 수 있기 때문입니다. 어떤 plist든 Plist Workbench에 붙여넣어 브라우저에서 읽고, 편집하고, 변환하고, 검증할 수 있습니다. 아무것도 업로드되지 않습니다. 하지만 이 글은 파일을 직접 읽는 방법을 가르쳐 줍니다. 그러면 트리가 절대 블랙박스가 되지 않습니다.

plist란 무엇인가 — 그리고 그것이 입는 네 가지 옷

프로퍼티 리스트, 즉 plist는 Apple이 구조화된 설정을 저장하는 방식입니다. 딕셔너리와 배열로 이루어진 트리로, 잎은 문자열, 정수, 실수, 불리언, 날짜, 바이너리 데이터 덩어리입니다. JSON 객체나 YAML 파일과 같은 아이디어이지만, Apple 플랫폼에서는 둘보다 먼저 등장했고 운영체제에 내장되어 있습니다. macOS와 iOS는 사용자에게 묻지 않고 끊임없이 plist를 읽습니다. 앱이 번들 ID나 버전, 요청하는 권한을 어디에 저장하는지 궁금했던 적이 있다면, 답은 plist이고, 그것은 줄곧 눈앞에 있었습니다.

같은 형식은 요령을 알기 전까지는 무관해 보이는 네 곳에 나타납니다. 모든 앱 번들 안에서 Info.plist는 앱의 정체성을 선언합니다. 번들 ID, 버전, 지원하는 문서 타입, 요청하는 권한입니다. ~/Library/LaunchAgents와 /Library/LaunchDaemons에서는 launchd 작업 파일이 백그라운드 작업을 설명합니다. 무엇을 실행할지, 언제, 어떤 조건에서, 입니다. .mobileprovision 프로비저닝 프로파일은 plist이며(CMS 서명으로 감싸져 있습니다), 앱이 사용할 수 있는 기기와 권한을 나열합니다. 그리고 .mobileconfig 기기 프로파일도 plist로, 기기에 설치할 Wi-Fi, VPN, 인증서, 제한을 설명합니다. 같은 형식, 네 가지 옷 — 하나를 읽을 줄 알면 네 가지 모두 읽을 수 있습니다.

바이너리 대 XML: bplist00 매직, 그리고 바이너리 plist를 손으로 편집하면 안 되는 이유

plist에는 두 가지 직렬화가 있습니다. XML 형식은 <?xml과 <plist version="1.0">로 시작하며, 어떤 텍스트 편집기에서도 읽을 수 있습니다. 키는 <key> 태그에, 값은 <string>, <integer>, <true/>, <array>, <dict>에 들어 있습니다. 바이너리 형식은 compact한 인코딩으로, 8바이트 매직 bplist00으로 시작하고, 객체 테이블, 오프셋 테이블, 모든 것이 어디에 있는지 기록하는 트레일러가 이어집니다. 바이너리 plist는 더 작고 시스템이 로드하기도 더 빠르기 때문에, 실제 Mac의 대부분의 plist는 바이너리입니다. 그래서 텍스트 편집기에서 열면 쓰레기만 보이는 것입니다.

어떤 것을 가지고 있는지 구분하는 방법: 처음 몇 바이트를 보세요. bplist00이면 바이너리, <?xml이나 <plist이면 XML입니다. 그리고 파일을 구하는 규칙이 있습니다. 바이너리 바이트를 절대 손으로 편집하지 마세요. 바이너리 plist는 오프셋의 그물입니다. 하나의 문자열을 더 긴 것으로 바꾸면 그 뒤의 모든 오프셋이 틀어지고, 트레일러가 테이블과 맞지 않게 되며, 파일이 손상됩니다. 변경한 텍스트가 보기에는 괜찮아도 말입니다. 안전한 경로는 항상 같습니다. 바이너리를 XML로 변환하고, XML을 편집하고, 바이너리로 다시 변환한 뒤, 결과를 다시 파싱해서 여전히 유효한지 증명하는 것입니다. Mac에서는 plutil -convert xml1과 plutil -convert binary1이고, 브라우저에서는 Plist Workbench가 같은 왕복을 대신 해 줍니다.

launchd 작업을 직접 읽기: Label, ProgramArguments, RunAtLoad, KeepAlive, StartCalendarInterval

launchd 작업은 어휘가 작은 plist이며, 키만 알면 1분 안에 읽을 수 있습니다. Label은 작업의 고유한 이름으로, 관례상 com.example.backup 같은 역방향 도메인입니다. launchd는 이것으로 작업을 식별하고, 같은 라벨의 작업이 두 개 있으면 충돌합니다. ProgramArguments는 문자열 배열입니다. 실행할 프로그램과 그 인수이며, ["/usr/local/bin/backup.sh"]는 해당 스크립트를 인수 없이 실행합니다. RunAtLoad는 불리언으로, true는 로드되자마자 작업을 실행한다는 뜻입니다. KeepAlive도 불리언으로, 종료될 때마다 다시 시작한다는 뜻입니다. 이 네 가지 키가 여러분이 만나게 될 대부분의 작업을 설명합니다.

스케줄링 키는 StartCalendarInterval로, 캘린더 필드의 딕셔너리입니다. Minute, Hour, Day, Weekday, Month 중 어느 것이든 생략할 수 있어, {Hour: 3, Minute: 30}은 매일 03:30을 의미합니다. 더 단순한 사촌인 StartInterval은 하나의 정수로, N초마다 실행합니다. 아래 코드 블록의 샘플은 이 형태의 완전하고 동작하는 작업입니다. Label, ProgramArguments, RunAtLoad, StartCalendarInterval, 한 줄씩 읽을 가치가 있습니다. 여러분이 만나는 모든 launchd 작업은 그 변형이기 때문입니다. 같은 키, 다른 값, 그리고 가끔 출력이 어디로 가는지 알려주는 WorkingDirectory나 StandardOutPath 같은 추가 항목이 있습니다.

문제를 일으키는 키: 타입 실수, 잘못된 컨테이너, 범위를 벗어난 숫자

망가진 launchd 작업 대부분은 오타 때문에 망가지는 것이 아니라 타입 때문에 망가집니다. launchd는 ProgramArguments가 문자열 배열이기를 기대합니다. 하나의 문자열을 주면 작업이 로드되지 않고, 오류 메시지는 거의 아무것도 알려주지 않습니다. KeepAlive, RunAtLoad, Disabled는 불리언이어야 하며, "true"와 "false"라는 문자열이 아닙니다. "true"라고 적힌 문자열은 true가 아니며, launchd는 이를 타입 오류로 취급합니다. StartInterval은 양의 정수여야 합니다. 0이나 음수는 무의미하고 거부됩니다. 이것은 텍스트 편집기가 절대 잡아내지 못하는 실수입니다. XML 자체는 완벽하게 well-formed하기 때문입니다. 틀린 것은 의미뿐입니다.

두 번째 망가짐의 유형은 범위를 벗어난 숫자입니다. StartCalendarInterval에서 Minute는 0–59, Hour는 0–23, Weekday는 0–7, Day는 1–31, Month는 1–12여야 합니다. Hour가 25라는 것은 "내일 새벽 1시"가 아니라 작업이 절대 실행되지 않는다는 뜻이며, launchd는 왜 그런지 알려주지 않을 수도 있습니다. 세 번째 유형은 함께 나타나면 안 되는 쌍입니다. Program과 ProgramArguments는 같은 것을 말하는 두 가지 방법이며, 둘 다 주면 모호합니다. 하나를 선택하고, Apple이 문서화한 ProgramArguments를 우선하세요. 타입, 범위, 그리고 이런 충돌을 검사하는 검증기는 작업이 launchd에 도달하기 전에 세 가지 유형을 모두 잡아냅니다. 바로 그것이 워크벤치의 launchd 검사가 하는 일입니다.

안전하게 편집하기: 백업, 변환, 편집, 다시 변환, 검증

안전한 plist 편집은 다섯 단계의 의식이며, 순서가 중요합니다. 첫째, 원본 파일을 백업하세요. 만지기 전에 다른 곳에 복사하세요. launchd 작업이나 기기 프로파일에는 실행 취소 버튼이 없기 때문입니다. 둘째, 파일이 바이너리라면 XML로 변환하세요. 바이너리 바이트를 직접 편집하지 마세요. 위의 오프셋 이유 때문입니다. 셋째, XML에서 편집하세요. 값을 바꾸고, 키 이름을 바꾸고, 배열 항목을 추가하세요. 그리고 타입을 올바르게 유지하세요. 문자열은 문자열 자리에, 배열은 배열 자리에. 넷째, 원본이 바이너리였다면 바이너리로 다시 변환해서, 파일이 시스템이 기대하는 형태로 돌아가게 하세요.

다섯째, 그리고 가장 자주 생략되는 단계: 다시 파싱해서 검증하세요. 결과에 plutil -lint를 실행하거나, 워크벤치에 붙여넣어 깨끗하게 파싱되는 것을 확인하세요. 파일이 다시 파싱되고 돌아온 값이 의도한 값이라면, 편집은 성공한 것입니다. 파싱되지 않는다면 1단계의 백업이 아직 있고, 디스크의 파일은 편집기에 닿은 적이 없습니다. 워크벤치는 메모리의 복사본을 편집하고, 명시적으로 내보낼 때만 파일을 씁니다. 이 마지막 특성이 브라우저에서 편집하는 일의 전부입니다. 새 버전이 좋다고 여러분이 판단할 때까지 원본은 그대로 유지됩니다.

Plist Workbench가 하는 일 — 그리고 하지 않는 일

워크벤치는 두 가지 형태의 plist, 바이너리 bplist00와 XML을 모두 펼쳐볼 수 있는 트리로 파싱합니다. 경로로 검색할 수 있고(StartCalendarInterval.Hour처럼), 제자리에서 편집할 수 있습니다. 스칼라를 바꾸고, 키 이름을 바꾸고, 키와 배열 항목을 추가하거나 삭제하고, 모호하지 않은 경우 값의 타입을 바꿀 수 있습니다. 모든 내보내기 — XML plist, 바이너리 plist, JSON, 또는 평탄화한 경로 테이블 CSV — 는 원본 파일이 아니라 편집된 모델을 반영합니다. plist가 launchd 작업처럼 보이면, 앞 섹션의 의미 검사를 실행합니다. Label이 있는지, Program과 ProgramArguments 중 정확히 하나만 있는지, 캘린더 필드가 범위 안에 있는지, 불리언이 실제로 불리언인지. 그것이 작업의 전부이며, 모든 것이 여러분의 브라우저 안에서 일어납니다. 파일이 기기를 떠나는 일은 절대 없습니다.

하지 않는 일도 똑같이 중요합니다. 아무것도 설치하지 않습니다. 작업을 launchd에 로드하거나, 기기에 .mobileconfig을 설치하거나, 앱을 프로비저닝하지 않습니다. 그것들은 시스템 동작이며, 웹페이지가 수행해서는 안 됩니다. 코드 서명이나 프로비저닝 권한을 Apple과 대조해 검증하지도 않습니다. 그래서 편집한 .mobileprovision은 완벽하게 파싱될 수 있지만, 서명이 더 이상 맞지 않아 시스템에 거부될 수 있습니다. 파싱할 수 있다는 것은 신뢰할 수 있다는 것이 아닙니다. 그리고 plist 안의 어떤 것도 실행하지 않습니다. 스크립트를 가리키는 launchd 작업은 launchd가 실행하기 전까지는 데이터이며, 워크벤치는 그것을 데이터로 취급합니다. Android의 대응물, APK 안의 매니페스트에는 APK Analyzer를, launchd의 Linux 사촌인 systemd 유닛에는 systemd Unit Auditor를 사용하세요.

직접 해보기: 읽고, 변환하고, 검증할 수 있는 launchd 작업

# A minimal launchd job, as XML — the form you can read and edit safely
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.example.backup</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/backup.sh</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>StartCalendarInterval</key>
    <dict>
        <key>Hour</key>
        <integer>3</integer>
        <key>Minute</key>
        <integer>30</integer>
    </dict>
</dict>
</plist>

# Convert between the two forms on a Mac — never edit the binary bytes:
$ plutil -convert xml1 job.plist     # binary -> readable XML
$ plutil -convert binary1 job.plist  # XML -> compact binary, for shipping
$ plutil -lint job.plist             # re-parse to verify it is still valid

출처

자주 묻는 질문

.plist를 텍스트 편집기로 열었더니 쓰레기처럼 보입니다 — 파일이 망가진 건가요?

거의 확실히 아닙니다. 바이너리 plist입니다. 파일을 열어 처음 몇 바이트를 보세요. bplist00이라고 읽힌다면, 그 파일은 Apple의 compact한 바이너리 형식으로, 기계를 위한 것이지 눈을 위한 것이 아닙니다. 먼저 XML로 변환하세요(Mac에서는 plutil -convert xml1, 또는 Plist Workbench에 붙여넣으면 매직을 감지해 대신 변환해 줍니다). 그러면 같은 키와 값이 읽을 수 있는 형태로 보입니다. 파일이 bplist00으로도

.mobileprovision이나 .mobileconfig도 같은 방식으로 편집할 수 있나요?

형식은 같습니다. 둘 다 속은 plist입니다. 하지만 결과는 다릅니다. .mobileconfig은 plain plist라 깨끗하게 편집됩니다. .mobileprovision은 CMS 서명으로 감싼 plist라서, 안의 값을 바꾸면 서명이 깨지고, Apple의 도구는 편집된 프로파일을 파싱이 되더라도 거부합니다. 워크벤치는 둘 다 파싱하고 편집하지만, Apple과 대조해 서명을 검증하지 않으므로, 파싱된 .mobileprovision은 "읽을 수 있다"로 취급하고 "여전히 유효하다"로 취급하지 마세요. 확신이 서지 않으면 편집하는 대신 Apple 포털에서 프로파일을 다시 생성하세요.

launchd가 제 작업을 무시하거나 로드를 거부하는 이유는 무엇인가요?

이 순서대로 흔한 용의자들을 확인하세요. 첫째, Label이 있고, 문자열이며, 고유한가요? 둘째, ProgramArguments가 문자열 배열인가요? 거기에 하나의 문자열이 있는 것이 가장 흔한 실패입니다. 셋째, StartCalendarInterval 필드가 범위 안에 있나요? Hour가 25이면 작업이 절대 실행되지 않습니다. 넷째, 파일에 plutil -lint를 실행해 잘못된 XML을 찾고, 파일이 올바른 디렉토리에 있는지 확인하세요(사용자는 ~/Library/LaunchAgents, 시스템은 /Library/LaunchDaemons). 그래도 로드되지 않으면 Plist Workbench에 붙여넣으세요. launchd 검사가 이러한 문제를 하나씩 쉬운 말로 된 수정 방법과 함께 표시합니다.