Come modificare un file Plist su macOS con Xcode

Su macOS, è possibile modificare un file di elenco proprietà (.plist) nell'editor strutturato di Xcode. Eseguite un backup del file, apritelo in Xcode, modificate solo le chiavi e i valori documentati e salvate. Evitate di modificare il bundle installato di un'app di terze parti: la modifica di un'app firmata può invalidarne la firma o causare problemi con gli aggiornamenti. Per la vostra app, modificate il codice sorgente del progetto o le impostazioni di compilazione e ricompilate.

Quando modificare direttamente un file plist

Gli elenchi di proprietà contengono dati strutturati: stringhe, numeri, valori booleani, array e dizionari. Il file plist di un'app Info.plistdescrive il suo bundle; file plist separati possono memorizzare le preferenze. Utilizza il file e la chiave documentati dall'app: inventare una chiave non aggiungerà il supporto per un'impostazione.

Prima di modificare un file, verifica se contiene metadati dell'app o preferenze utente. Se desideri modificare una funzionalità di un'app che utilizzi, inizia dalle impostazioni o dalla documentazione dell'app stessa. Un file di preferenze può essere sovrascritto all'avvio o alla chiusura dell'app; il file di preferenze di un pacchetto installato Info.plistnon è un pannello di impostazioni generale.

Per un progetto Xcode che gestisci, controlla prima il pannello Informazioni e le impostazioni di compilazione del target. Xcode potrebbe generare file Info.plistin fase di compilazione, quindi la modifica di una copia compilata potrebbe essere temporanea. La guida di modifica di Apple descrive l'editor strutturato; il riferimento alle impostazioni di compilazione spiega i valori generati.

Modifica un file plist con Xcode

1. Installa Xcode

Scarica Xcode dal Mac App Store . Al momento è gratuito; controlla la descrizione per i requisiti di sistema della versione compatibile con il tuo Mac. Avvia Xcode una sola volta dopo l'installazione.

2. Eseguire un backup funzionante

Trova il file plist nel Finder e duplicalo o copialo in una cartella di lavoro prima di modificarlo. Conserva l'originale finché non hai verificato la modifica. Archivia i backup al di fuori del .apppacchetto dell'app; l'aggiunta di file in quella posizione potrebbe alterarne il contenuto firmato.

3. Trova il file all'interno di un'app, se necessario

Per esaminare il contenuto di un'app, fai clic tenendo premuto il tasto Control sull'app nel Finder e scegli " Mostra contenuto pacchetto" . In questo modo verranno visualizzate le cartelle interne. Usa questa funzione per individuare un file oppure modifica solo un'app di cui sei responsabile e che puoi ricompilare o firmare nuovamente; non applicare patch a un'app di terze parti.

4. Apri il file plist nel bundle

Apri Contents, quindi cerca Info.plist. Altri file plist potrebbero trovarsi altrove, quindi segui la documentazione dell'app o del progetto. Per un file autonomo, usa la sua normale posizione nel Finder.

5. Apri il file in Xcode

Fai clic tenendo premuto il tasto Control sul file plist e scegli Apri con > Xcode . Se Xcode non è presente, scegli Altro e selezionalo da Applicazioni. Puoi anche aprire Xcode e utilizzare File > Apri . Un file plist strutturato verrà visualizzato con righe di chiave, tipo e valore.

6. Modificare un valore esistente o aggiungere una riga

Fai clic su un valore esistente per modificarlo. Per aggiungere un'impostazione, fai clic tenendo premuto il tasto Control nell'editor e scegli Aggiungi riga oppure fai clic sul controllo Aggiungi. Utilizza il tasto esatto documentato dall'app; i tasti con errori di battitura o non supportati potrebbero essere ignorati.

7. Verifica il tipo di valore e salva

Assicurati che il tipo di valore corrisponda al formato documentato: booleano, numero e stringa non sono intercambiabili. Gli array contengono elementi ordinati; i dizionari contengono valori denominati. Evita di inserire chiavi a caso o duplicate, quindi premi Comando-S .

• Stringa: testo, ad esempio un identificatore o un'etichetta.
• Booleano: vero o falso.
• Numero: un numero intero o reale.
• Array o dizionario: un elenco o un gruppo di valori denominati.

8. Riaprire e verificare il file salvato.

Chiudi e riapri il file plist per verificare che il valore sia stato salvato. Per il tuo progetto, ricompila e testa una copia. Se l'app lo ignora, verifica di aver modificato il file sorgente corretto; le app possono leggere le preferenze da altre fonti o sostituirle all'avvio. Ripristina il backup o reinstalla l'app se non funziona.

Note importanti sulla firma e sulla risoluzione dei problemi

Apple avverte che la modifica di un bundle di app firmato può invalidarne la firma; inoltre, gli aggiornamenti potrebbero sovrascrivere le modifiche. Per il software di cui sei responsabile, modifica il file plist di origine o l'impostazione di destinazione, quindi ricompila. Per le preferenze ordinarie, utilizza le impostazioni dell'app. Non disabilitare le protezioni di macOS per modificare un file plist.

Se Xcode non riesce a salvare, lavora da una copia scrivibile. Se una modifica scompare dopo la ricompilazione, aggiorna il codice sorgente o le impostazioni di compilazione. Se una chiave viene ignorata, verifica la sua ortografia, il tipo e la posizione nella documentazione dell'app.

Per maggiori dettagli, consultare la documentazione di Apple relativa all'Information Property List e la relativa nota tecnica sulla firma del codice di macOS .