Plist फ़ाइलें कैसे पढ़ें और संपादित करें
अंतिम अपडेट:
Plist फ़ाइल को पढ़ना और संपादित करना Apple के कॉन्फ़िगरेशन फ़ॉर्मेट के साथ काम करना है — वे key-value फ़ाइलें जो macOS और iOS को चुपचाप चलाती हैं। हर ऐप में एक Info.plist होती है, हर शेड्यूल किया गया बैकग्राउंड जॉब एक launchd plist है, हर provisioning प्रोफ़ाइल और हर .mobileconfig डिवाइस प्रोफ़ाइल के अंदर plist ही है। फ़ॉर्मेट खुद सरल है: dictionary, array, string, number, boolean, date और binary data, जितनी गहराई चाहें उतनी nesting के साथ। परेशानी इसलिए शुरू होती है क्योंकि एक ही फ़ॉर्मेट दो वेशों में आता है — मनुष्य के पढ़ने लायक XML, और एक compact binary रूप जो text editor में कचरा लगता है — और इसलिए क्योंकि एक गलत type भी किसी जॉब को कभी न चलने दे सकता है। आप कोई भी plist Plist Workbench में paste करके अपने browser में पढ़, संपादित, convert और validate कर सकते हैं — कुछ भी upload नहीं होता — लेकिन यह लेख आपको फ़ाइलें खुद पढ़ना सिखाता है, ताकि tree आपके लिए कभी black box न रहे।
Plist क्या है — और इसके चार वेश क्या हैं
Property list, या plist, Apple का structured configuration संग्रहीत करने का तरीका है: dictionary और array का एक tree, जिसके पत्ते string, integer, real number, boolean, date और binary data blob होते हैं। यह JSON object या YAML फ़ाइल जैसा ही विचार है, लेकिन Apple के platform पर यह उन दोनों से पुराना है और operating system में baked in है — macOS और iOS आपसे कभी पूछे बिना लगातार plist पढ़ते रहते हैं। यदि आपने कभी सोचा है कि कोई ऐप अपना bundle ID, version, या वे permission कहाँ रखता है जो वह माँगता है, तो उत्तर है plist, और वह हमेशा से साफ़ दिखाई दे रहा था।
वही फ़ॉर्मेट चार जगहों पर दिखता है जो तब तक असंबंधित लगती हैं जब तक आप trick न जान लें। हर app bundle के अंदर, Info.plist ऐप की पहचान घोषित करती है: उसका bundle ID, version, समर्थित document type, और वे permission जो वह माँगता है। ~/Library/LaunchAgents और /Library/LaunchDaemons में, launchd जॉब फ़ाइलें background कार्य बताती हैं — क्या चलाना है, कब, और किन परिस्थितियों में। एक .mobileprovision provisioning प्रोफ़ाइल एक plist है (CMS signature में लिपटी हुई) जो बताती है कि ऐप किन device और entitlement का उपयोग कर सकता है। और एक .mobileconfig device प्रोफ़ाइल भी एक plist है जो device पर install किए जाने वाले Wi-Fi, VPN, certificate और restriction बताती है। एक ही फ़ॉर्मेट, चार वेश — एक पढ़ना सीख लें तो चारों पढ़ सकते हैं।
Binary बनाम XML: bplist00 magic, और binary plist को हाथ से संपादित करना उसे क्यों भ्रष्ट करता है
Plist के दो serialization हैं। XML रूप <?xml और <plist version="1.0"> से शुरू होता है, और किसी भी text editor में पढ़ा जा सकता है: key <key> tag में, value <string>, <integer>, <true/>, <array> और <dict> में। Binary रूप एक compact encoding है जो आठ magic byte bplist00 से शुरू होता है, जिसके बाद object table, offset table, और एक trailer आता है जो दर्ज करता है कि सब कुछ कहाँ है। Binary plist छोटी होती हैं और system के लिए load करना तेज़ होता है, इसलिए असली Mac पर ज़्यादातर plist binary होती हैं — और इसीलिए text editor में खोलने पर कचरा दिखता है।
आपके पास कौन सी है, यह कैसे बताएँ: पहले byte देखें। bplist00 का अर्थ है binary; <?xml या <plist का अर्थ है XML। और यहाँ वह नियम है जो फ़ाइलें बचाता है: binary byte को कभी हाथ से संपादित न करें। Binary plist offset का एक जाल है — एक string को लंबी string से बदल दें तो उसके बाद के सभी offset गलत हो जाते हैं, trailer table से मेल नहीं खाता, और फ़ाइल भ्रष्ट हो जाती है, भले ही बदला गया text ठीक लगे। सुरक्षित रास्ता हमेशा एक ही है: binary को XML में convert करें, XML संपादित करें, वापस binary में convert करें, और फिर परिणाम को फिर से parse करके साबित करें कि वह अभी भी valid है। Mac पर यह plutil -convert xml1 और plutil -convert binary1 है; browser में, Plist Workbench वही round trip आपके लिए करता है।
Launchd जॉब को हाथ से पढ़ना: Label, ProgramArguments, RunAtLoad, KeepAlive, StartCalendarInterval
Launchd जॉब एक छोटी vocabulary वाली plist है, और key जान लेने पर आप इसे एक minute से कम में पढ़ सकते हैं। Label जॉब का unique नाम है, परंपरा से com.example.backup जैसा reverse domain — launchd इसका उपयोग जॉब को पहचानने के लिए करता है, और समान label वाले दो जॉब टकराते हैं। ProgramArguments string का array है: चलाने वाला program और उसके argument, इसलिए ["/usr/local/bin/backup.sh"] उस script को बिना argument चलाता है। RunAtLoad एक boolean है: true का अर्थ है जॉब load होते ही चलाएँ। KeepAlive भी boolean है: इसका अर्थ है जब भी वह exit हो तो उसे restart करें। ये चार key उन ज़्यादातर जॉब को बताते हैं जिनसे आप कभी मिलेंगे।
Scheduling key है StartCalendarInterval, calendar field का dictionary — Minute, Hour, Day, Weekday, Month — जिनमें से कोई भी छोड़ा जा सकता है, इसलिए {Hour: 3, Minute: 30} का अर्थ है हर दिन 03:30 पर। इसका सरल cousin StartInterval एक integer है: हर N second चलाएँ। नीचे code block में sample इसी आकार का एक पूर्ण, काम करने वाला जॉब है — Label, ProgramArguments, RunAtLoad, StartCalendarInterval — और इसे line by line पढ़ने लायक है, क्योंकि हर launchd जॉब जिससे आप मिलेंगे वह इसका variation है: वही key, अलग value, और कभी-कभी WorkingDirectory या StandardOutPath जैसा extra, जो बताता है कि output कहाँ जाता है।
वे key जो चीज़ें तोड़ देते हैं: type गलतियाँ, गलत container, सीमा से बाहर number
ज़्यादातर टूटे launchd जॉब typo से नहीं टूटते — वे type से टूटते हैं। launchd अपेक्षा करता है कि ProgramArguments string का array हो; उसे एक अकेली string दें तो जॉब load नहीं होगा, और error बहुत कम बताएगा। KeepAlive, RunAtLoad और Disabled boolean होने चाहिए, "true" और "false" string नहीं — एक string जो "true" लिखती है वह true नहीं है, और launchd इसे type error मानेगा। StartInterval एक positive integer होना चाहिए; शून्य या negative number निरर्थक है और अस्वीकार कर दिया जाता है। ये वे गलतियाँ हैं जिन्हें text editor कभी नहीं पकड़ता, क्योंकि XML पूरी तरह well-formed है — केवल अर्थ गलत है।
टूटने का दूसरा परिवार है सीमा से बाहर number। StartCalendarInterval में, Minute 0–59 होना चाहिए, Hour 0–23, Weekday 0–7, Day 1–31, और Month 1–12 — 25 का Hour "कल सुबह 1 बजे" नहीं है, इसका अर्थ है कि जॉब कभी नहीं चलेगा, और launchd शायद आपको यह भी न बताए कि क्यों। तीसरा परिवार है वह जोड़ी जो एक साथ नहीं आनी चाहिए: Program और ProgramArguments एक ही बात कहने के दो तरीके हैं, और दोनों देना ambiguous है — एक चुनें, और ProgramArguments को प्राथमिकता दें, जो Apple document करता है। एक validator जो type, range और इन conflict की जाँच करता है, जॉब के launchd तक पहुँचने से पहले ही तीनों परिवारों को पकड़ लेता है, और यही workbench की launchd जाँच करती है।
सुरक्षित रूप से संपादित करना: backup, convert, edit, वापस convert, verify
सुरक्षित plist संपादन पाँच चरणों का एक ritual है, और क्रम मायने रखता है। पहला, मूल फ़ाइल का backup लें — छूने से पहले इसे कहीं और copy कर लें, क्योंकि launchd जॉब या device प्रोफ़ाइल में undo button नहीं होता। दूसरा, यदि फ़ाइल binary है, तो उसे XML में convert करें; binary byte को सीधे कभी संपादित न करें, ऊपर दिए offset कारणों से। तीसरा, XML में संपादन करें: एक value बदलें, एक key का नाम बदलें, array item जोड़ें — और type सही रखें, string जहाँ string होनी चाहिए, array जहाँ array होना चाहिए। चौथा, यदि मूल binary था तो वापस binary में convert करें, ताकि फ़ाइल system की अपेक्षा वाले रूप में लौटे।
पाँचवाँ, और सबसे ज़्यादा छोड़ा जाने वाला चरण: फिर से parse करके verify करें। परिणाम पर plutil -lint चलाएँ, या इसे workbench में paste करके देखें कि यह साफ़ parse होता है — यदि फ़ाइल फिर से parse हो जाती है और वापस आए value वही हैं जो आप चाहते थे, तो संपादन काम कर गया। यदि यह parse नहीं होती, तो पहले चरण का backup अभी भी आपके पास है, और disk पर फ़ाइल को editor ने कभी छुआ ही नहीं: workbench memory में एक copy संपादित करता है और केवल तभी फ़ाइल लिखता है जब आप स्पष्ट रूप से export करते हैं। यह अंतिम गुण browser में संपादित करने का पूरा मतलब है — जब तक आप यह तय नहीं करते कि नया version अच्छा है, मूल intact रहता है।
Plist Workbench क्या करता है — और क्या नहीं करता
Workbench plist के दोनों रूपों — binary bplist00 और XML — को एक tree में parse करता है जिसे आप expand कर सकते हैं, path से खोज सकते हैं (जैसे StartCalendarInterval.Hour), और जगह पर ही संपादित कर सकते हैं: एक scalar बदलें, key का नाम बदलें, key और array item जोड़ें या हटाएँ, और जहाँ unambiguous हो वहाँ value का type बदलें। हर export — XML plist, binary plist, JSON, या flattened path table का CSV — संपादित model को दर्शाता है, मूल फ़ाइल को नहीं। जब plist launchd जॉब जैसा दिखता है, तो यह पिछले section की semantic जाँच चलाता है: Label मौजूद है, Program और ProgramArguments में से ठीक एक है, calendar field सीमा में हैं, boolean वास्तव में boolean हैं। यही पूरा काम है, और यह सब आपके browser में होता है: फ़ाइल कभी आपके device को नहीं छोड़ती।
यह क्या नहीं करता, वह भी उतना ही महत्वपूर्ण है। यह कुछ भी install नहीं करता — यह आपके जॉब को launchd में load नहीं करेगा, device पर .mobileconfig install नहीं करेगा, या app को provision नहीं करेगा; वे system क्रियाएँ हैं, और कोई web page उन्हें नहीं करना चाहिए। यह Apple के मुकाबले code signature या provisioning entitlement को validate नहीं करता, इसलिए एक संपादित .mobileprovision पूरी तरह parse हो सकती है और फिर भी system द्वारा अस्वीकार की जा सकती है क्योंकि उसका signature अब मेल नहीं खाता — parse करना भरोसा करना नहीं है। और यह plist से कुछ भी run नहीं करता: एक launchd जॉब जो script की ओर इशारा करता है, launchd के उसे execute करने तक data ही है, और workbench इसे data मानता है। Android के समकक्ष — APK के अंदर manifest — के लिए APK Analyzer का उपयोग करें; launchd के Linux cousin, systemd unit के लिए, systemd Unit Auditor का उपयोग करें।
खुद आज़माएँ: एक launchd जॉब जिसे आप पढ़, convert और verify कर सकते हैं
# 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