Cómo leer y editar archivos plist

Saber leer y editar un archivo plist es trabajar con el formato de configuración de Apple: los archivos de clave-valor que mueven macOS e iOS en silencio. Cada app lleva un Info.plist, cada tarea programada en segundo plano es un plist de launchd, cada perfil de aprovisionamiento y cada perfil de dispositivo .mobileconfig es un plist por debajo. El formato en sí es sencillo: diccionarios, arrays, cadenas, números, booleanos, fechas y datos binarios, anidados tanto como quieras. El problema empieza porque el mismo formato se distribuye con dos disfraces — XML legible para humanos, y una forma binaria compacta que parece basura en un editor de texto — y porque un solo tipo equivocado puede impedir en silencio que una tarea se ejecute jamás. Puedes pegar cualquier plist en el Plist Workbench y leerlo, editarlo, convertirlo y validarlo en tu navegador — no se sube nada — pero este artículo te enseña a leer los archivos tú mismo, para que el árbol nunca sea una caja negra.

Qué es un plist, y los cuatro disfraces que lleva

Una lista de propiedades, o plist, es la forma que tiene Apple de guardar configuración estructurada: un árbol de diccionarios y arrays cuyas hojas son cadenas, enteros, números reales, booleanos, fechas y bloques de datos binarios. Es la misma idea que un objeto JSON o un archivo YAML, pero es anterior a ambos en las plataformas de Apple y está integrado en el sistema operativo: macOS e iOS leen plists constantemente, sin preguntarte nunca. Si alguna vez te preguntaste dónde guarda una app su bundle ID, su versión o los permisos que pide, la respuesta es un plist, y ha estado a la vista todo el tiempo.

El mismo formato aparece en cuatro lugares que parecen no tener relación hasta que conoces el truco. Dentro de cada paquete de app, Info.plist declara la identidad de la app: su bundle ID, versión, tipos de documento admitidos y los permisos que solicita. En ~/Library/LaunchAgents y /Library/LaunchDaemons, los archivos de tareas de launchd describen tareas en segundo plano: qué ejecutar, cuándo y en qué condiciones. Un perfil de aprovisionamiento .mobileprovision es un plist (envuelto en una firma CMS) que lista qué dispositivos y permisos puede usar una app. Y un perfil de dispositivo .mobileconfig es un plist que describe la Wi-Fi, la VPN, los certificados y las restricciones que se instalan en un dispositivo. El mismo formato, cuatro disfraces: aprende a leer uno y podrás leer los cuatro.

Binario frente a XML: la magia bplist00, y por qué editar un plist binario a mano lo corrompe

Un plist tiene dos serializaciones. La forma XML empieza con <?xml y <plist version="1.0">, y se puede leer en cualquier editor de texto: las claves en etiquetas <key>, los valores en <string>, <integer>, <true/>, <array> y <dict>. La forma binaria es una codificación compacta que empieza con los ocho bytes mágicos bplist00, seguidos de una tabla de objetos, una tabla de desplazamientos y un tráiler que registra dónde vive cada cosa. Los plist binarios son más pequeños y el sistema los carga más rápido, por eso la mayoría de los plists de un Mac real son binarios, y por eso abrir uno en un editor de texto muestra basura.

Cómo saber cuál tienes: mira los primeros bytes. bplist00 significa binario; <?xml o <plist significa XML. Y aquí está la regla que salva archivos: nunca edites los bytes binarios a mano. Un plist binario es una red de desplazamientos: cambia una cadena por una más larga y todos los desplazamientos posteriores quedan mal, el tráiler ya no coincide con la tabla y el archivo queda corrupto aunque el texto que cambiaste se vea bien. El camino seguro es siempre el mismo: convertir de binario a XML, editar el XML, volver a convertir a binario y reanalizar el resultado para demostrar que sigue siendo válido. En un Mac eso es plutil -convert xml1 y plutil -convert binary1; en el navegador, el Plist Workbench hace el mismo viaje de ida y vuelta por ti.

Leer una tarea de launchd a mano: Label, ProgramArguments, RunAtLoad, KeepAlive, StartCalendarInterval

Una tarea de launchd es un plist con un vocabulario pequeño, y puedes leer una en menos de un minuto cuando conoces las claves. Label es el nombre único de la tarea, convencionalmente un dominio inverso como com.example.backup: launchd lo usa para identificar la tarea, y dos tareas con la misma etiqueta chocan. ProgramArguments es un array de cadenas: el programa a ejecutar seguido de sus argumentos, así que ["/usr/local/bin/backup.sh"] ejecuta ese script sin argumentos. RunAtLoad es un booleano: true significa ejecutar la tarea en cuanto se carga. KeepAlive, también booleano, significa reiniciarla cada vez que termina. Esas cuatro claves describen la mayoría de las tareas que vas a encontrar.

La clave de programación es StartCalendarInterval, un diccionario de campos de calendario — Minute, Hour, Day, Weekday, Month — cualquiera de los cuales puedes omitir, así que {Hour: 3, Minute: 30} significa todos los días a las 03:30. Su prima más simple, StartInterval, es un solo entero: ejecutar cada N segundos. La muestra del bloque de código de abajo es una tarea completa y funcional con esta forma — Label, ProgramArguments, RunAtLoad, StartCalendarInterval — y merece leerse línea por línea, porque cada tarea de launchd que encuentres es una variación de ella: las mismas claves, valores distintos, y algún extra ocasional como WorkingDirectory o StandardOutPath para indicar adónde va la salida.

Las claves que rompen cosas: errores de tipo, contenedores equivocados, números fuera de rango

La mayoría de las tareas de launchd rotas no se rompen por errores tipográficos, sino por tipos. launchd espera que ProgramArguments sea un array de cadenas; dale una sola cadena y la tarea no carga, con un error que dice muy poco. KeepAlive, RunAtLoad y Disabled deben ser booleanos, no las cadenas "true" y "false": una cadena que deletrea "true" no es true, y launchd lo tratará como un error de tipo. StartInterval debe ser un entero positivo; un cero o un número negativo no tiene sentido y se rechaza. Estos son los errores que un editor de texto nunca detecta, porque el XML está perfectamente bien formado: solo el significado está mal.

La segunda familia de roturas son los números fuera de su rango. En StartCalendarInterval, Minute debe ser 0–59, Hour 0–23, Weekday 0–7, Day 1–31 y Month 1–12: un Hour de 25 no significa "mañana a la 1", significa que la tarea nunca se ejecuta, y es posible que launchd ni siquiera te diga por qué. La tercera familia es el par que no debe aparecer junto: Program y ProgramArguments son dos formas de decir lo mismo, y dar ambas es ambiguo: elige una, y prefiere ProgramArguments, que es la forma que documenta Apple. Un validador que comprueba tipos, rangos y estos conflictos detecta las tres familias antes de que la tarea llegue a launchd, que es exactamente lo que hacen las comprobaciones de launchd del workbench.

Editar con seguridad: copia de seguridad, convertir, editar, volver a convertir, verificar

Editar un plist con seguridad es un ritual de cinco pasos, y el orden importa. Primero, haz una copia de seguridad del archivo original: cópialo a otro sitio antes de tocarlo, porque una tarea de launchd o un perfil de dispositivo no tiene botón de deshacer. Segundo, si el archivo es binario, conviértelo a XML; nunca edites los bytes binarios directamente, por las razones de desplazamiento de arriba. Tercero, haz el cambio en el XML: cambia un valor, renombra una clave, añade un elemento al array, y mantén los tipos correctos: una cadena donde va una cadena, un array donde va un array. Cuarto, vuelve a convertir a binario si el original era binario, para que el archivo regrese en la forma que el sistema espera.

Quinto, y el paso que más se salta la gente: verificar reanalizando. Ejecuta plutil -lint sobre el resultado, o pégalo en el workbench y observa cómo se analiza limpiamente: si el archivo se reanaliza y los valores que devuelve son los que querías, el cambio funcionó. Si no se analiza, todavía tienes la copia de seguridad del paso uno, y el archivo del disco nunca fue tocado por el editor: el workbench edita una copia en memoria y solo escribe un archivo cuando exportas explícitamente. Esa última propiedad es todo el sentido de editar en el navegador: el original permanece intacto hasta que decides que la nueva versión es buena.

Qué hace el Plist Workbench, y qué no hace

El workbench analiza ambas formas de plist — binario bplist00 y XML — en un árbol que puedes expandir, buscar por ruta (como StartCalendarInterval.Hour) y editar in situ: cambiar un escalar, renombrar una clave, añadir o eliminar claves y elementos de array, y cambiar el tipo de un valor cuando eso no es ambiguo. Cada exportación — plist XML, plist binario, JSON o un CSV de la tabla de rutas aplanada — refleja el modelo editado, no el archivo original. Cuando el plist parece una tarea de launchd, ejecuta las comprobaciones semánticas de las secciones anteriores: Label presente, exactamente uno de Program y ProgramArguments, campos de calendario dentro del rango, booleanos que realmente son booleanos. Ese es todo el trabajo, y todo ocurre en tu navegador: el archivo nunca sale de tu dispositivo.

Lo que no hace es igual de importante. No instala nada: no cargará tu tarea en launchd, no instalará un .mobileconfig en un dispositivo ni aprovisionará una app; esas son acciones del sistema, y una página web no debería realizarlas. No valida firmas de código ni permisos de aprovisionamiento contra Apple, así que un .mobileprovision editado puede analizarse perfectamente y aun así ser rechazado por el sistema porque su firma ya no coincide: analizar no es confiar. Y no ejecuta nada del plist: una tarea de launchd que apunta a un script es datos hasta que launchd la ejecuta, y el workbench la trata como datos. Para el equivalente en Android — el manifiesto dentro de un APK — usa el Analizador de APK; para el primo de launchd en Linux, las unidades de systemd, usa el Auditor de unidades systemd.

Pruébalo tú mismo: una tarea de launchd que puedes leer, convertir y verificar

# 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

Fuentes

Preguntas frecuentes

Abrí un .plist en un editor de texto y parece basura: ¿está roto el archivo?

Casi seguro que no: es un plist binario. Abre el archivo y mira los primeros bytes: si dicen bplist00, el archivo está en la forma binaria compacta de Apple, hecha para máquinas, no para ojos. Conviértelo primero a XML (plutil -convert xml1 en un Mac, o pégalo en el Plist Workbench, que detecta la magia y lo convierte por ti) y verás las mismas claves y valores en forma legible. Preocúpate solo si el archivo no empieza ni por bplist00 ni por

¿Puedo editar un .mobileprovision o un .mobileconfig de la misma forma?

El formato es el mismo — ambos son plists por debajo — pero las consecuencias difieren. Un .mobileconfig es un plist simple y se edita limpiamente. Un .mobileprovision es un plist envuelto en una firma CMS, así que cambiar un valor dentro rompe la firma, y las herramientas de Apple rechazarán el perfil editado aunque siga analizándose. El workbench analiza y edita ambos, pero no valida firmas contra Apple, así que trata un .mobileprovision analizado como "legible", no como "sigue siendo válido". Ante la duda, regenera el perfil desde el portal de Apple en lugar de editarlo.

¿Por qué launchd ignora mi tarea, o se niega a cargarla?

Revisa los sospechosos habituales en este orden. Primero, ¿está Label presente, es una cadena y es único? Segundo, ¿es ProgramArguments un array de cadenas? Una sola cadena ahí es el fallo más común. Tercero, ¿están los campos de StartCalendarInterval dentro del rango? Un Hour de 25 significa que la tarea nunca se ejecuta. Cuarto, ejecuta plutil -lint sobre el archivo para detectar XML mal formado, y comprueba que el archivo vive en el directorio correcto (~/Library/LaunchAgents para tu usuario, /Library/LaunchDaemons para el sistema) con la propiedad adecuada. Si aun así no carga, pégalo en el Plist Workbench: sus comprobaciones de launchd marcan cada uno de estos problemas con una solución en lenguaje sencillo.