Hoe bewerk je een Plist-bestand op macOS met Xcode?

Je kunt een property list-bestand (.plist) op macOS bewerken in de gestructureerde editor van Xcode. Maak een back-up van het bestand, open het in Xcode, wijzig alleen de gedocumenteerde sleutels en waarden en sla het vervolgens op. Vermijd het bewerken van de geïnstalleerde bundel van een app van derden: het wijzigen van een ondertekende app kan de handtekening ongeldig maken of updates verstoren. Voor je eigen app kun je de projectbroncode of de buildinstellingen bewerken en de app opnieuw compileren.

Wanneer moet je een plist-bestand direct bewerken?

Eigenschappenlijsten bevatten gestructureerde gegevens: tekenreeksen, getallen, Booleaanse waarden, arrays en woordenboeken. Een eigenschappenlijst Info.plistbeschrijft de bundel van een app; afzonderlijke eigenschappenlijsten kunnen voorkeuren opslaan. Gebruik het bestand en de sleutel die door de app zijn gedocumenteerd: het zelf bedenken van een sleutel voegt geen ondersteuning toe voor een instelling.

Voordat je een bestand bewerkt, controleer dan of het app-metadata of een gebruikersvoorkeur bevat. Als je een functie in een app wilt wijzigen, begin dan in de instellingen of documentatie van die app. Een voorkeurenbestand kan worden overschreven wanneer de app wordt gestart of afgesloten; het voorkeurenbestand van een geïnstalleerd pakket Info.plistis geen algemeen instellingenpaneel.

Controleer voor een Xcode-project dat u beheert eerst het informatiepaneel en de buildinstellingen van het doel. Xcode kan Info.plisttijdens het bouwen een bestand genereren, dus het bewerken van een reeds gebouwde kopie kan tijdelijk zijn. De bewerkingshandleiding van Apple beschrijft de gestructureerde editor; de referentie voor buildinstellingen legt de gegenereerde waarden uit.

Een plist-bestand bewerken met Xcode

1. Installeer Xcode

Download Xcode uit de Mac App Store . Het is momenteel gratis; controleer de beschrijving voor de vereisten voor de versie die beschikbaar is voor jouw Mac. Start Xcode eenmaal na de installatie.

2. Maak een werkende back-up

Zoek het plist-bestand in Finder en dupliceer het of kopieer het naar een werkmap voordat je het bewerkt. Bewaar het origineel totdat je de wijziging hebt geverifieerd. Sla back-ups buiten de app- .appbundel op; het toevoegen van bestanden daarin kan de ondertekende inhoud wijzigen.

3. Zoek het bestand indien nodig in een app.

Om een ​​appbundel te inspecteren, klikt u met de rechtermuisknop (of Control-klik) op de app in Finder en kiest u 'Toon pakketinhoud' . Hiermee worden de interne mappen weergegeven. Gebruik dit om een ​​bestand te vinden of bewerk alleen een app die u zelf beheert en die u opnieuw kunt compileren of ondertekenen; patch geen apps van derden ter plaatse.

4. Open het plist-bestand in de bundel.

Open het bestand Contentsen zoek vervolgens naar het bestand Info.plist. Andere plist-bestanden kunnen zich elders bevinden, dus raadpleeg de documentatie van de app of het project. Voor een losstaand bestand gebruikt u de normale locatie in Finder.

5. Open het bestand in Xcode.

Klik met de rechtermuisknop op het plist-bestand en kies 'Openen met' > 'Xcode' . Als Xcode niet is geïnstalleerd, kies dan 'Overig' en selecteer het in de lijst met toepassingen. Je kunt Xcode ook openen via 'Bestand' > 'Openen' . Een gestructureerd plist-bestand wordt weergegeven als rijen met sleutels, typen en waarden.

6. Een bestaande waarde wijzigen of een rij toevoegen

Klik op een bestaande waarde om deze te bewerken. Om een ​​instelling toe te voegen, klikt u met de Control-toets ingedrukt in de editor en kiest u 'Rij toevoegen' , of klikt u op de knop 'Toevoegen'. Gebruik de exacte sleutel zoals die in de app is gedocumenteerd; verkeerd gespelde of niet-ondersteunde sleutels worden mogelijk genegeerd.

7. Controleer het waardetype en sla op.

Zorg ervoor dat het waardetype overeenkomt met het gedocumenteerde formaat: een Booleaanse waarde, een getal en een tekenreeks zijn niet uitwisselbaar. Arrays bevatten geordende items; dictionaries bevatten benoemde waarden. Vermijd geraden of dubbele toetsen en druk vervolgens op Command-S .

• String: tekst, zoals een identificatiecode of label.
• Booleaanse waarde: waar of onwaar.
• Getal: een geheel getal of een reëel getal.
• Array of woordenboek: een lijst of een groep van benoemde waarden.

8. Heropen en controleer het opgeslagen bestand.

Sluit en heropen het plist-bestand om te controleren of de waarde is opgeslagen. Bouw voor je eigen project een kopie opnieuw en test deze. Als de app de waarde negeert, controleer dan of je het juiste bronbestand hebt bewerkt; apps kunnen voorkeuren elders lezen of ze bij het opstarten vervangen. Herstel de back-up of installeer de app opnieuw als deze niet werkt.

Belangrijke notities over ondertekening en probleemoplossing

Apple waarschuwt dat het wijzigen van een ondertekend app-pakket de handtekening ongeldig kan maken; updates kunnen ook wijzigingen ongedaan maken. Voor software die u onderhoudt, wijzigt u het bron-plist-bestand of de doelinstelling en compileert u de app opnieuw. Voor gewone voorkeuren gebruikt u de instellingen van de app zelf. Schakel macOS-beveiligingen niet uit om een ​​plist-bestand te bewerken.

Als Xcode niet kan opslaan, werk dan met een beschrijfbare kopie. Als een wijziging verdwijnt na het opnieuw compileren, werk dan de broncode of de build-instellingen bij. Als een sleutel wordt genegeerd, controleer dan de spelling, het type en de locatie ervan in de documentatie van de app.

Zie voor meer informatie de documentatie van Apple over de Information Property List en de technische toelichting op het ondertekenen van macOS-code .