Guía de línea de comandos

App Trust Preview incluye una interfaz de línea de comandos para abrir análisis en nuevas ventanas de la app y exportar informes desde automatización, shell scripts, flujos de revisión de seguridad y agentes de IA. Analiza archivos compatibles localmente en tu Mac.

Empieza con ayuda

Ejecuta directamente desde Terminal el binario de la app instalada. Pon la ruta entre comillas porque el nombre de la app contiene espacios.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help

La salida de ayuda lista las opciones actuales, formatos de exportación compatibles, filtrado de escaneo y comandos de descubrimiento de pruebas.

Abrir una ventana de análisis

Usa --open cuando quieras que App Trust Preview analice un objetivo y muestre el informe en la app.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --open "/Volumes/Stats/Stats.app"

El comando abre el análisis en una ventana nueva, incluso si la app principal ya se está ejecutando. Esto lo hace adecuado para automatización, como mostrar un análisis cada vez que se agrega una app nueva a una carpeta vigilada.

No uses ninguna de estas formas de Launch Services.

open -b com.apptrustpreview.app /Volumes/Stats/Stats.app

Pasar el objetivo directamente a open -b queda bloqueado por un diálogo de privacidad de macOS.

open -b com.apptrustpreview.app --args /Volumes/Stats/Stats.app

Usar --args solo pasa el objetivo cuando la app principal aún no se está ejecutando. Usa el binario de App Trust Preview con --open para evitar ambos problemas.

Si la versión de Mac App Store no puede transferir el objetivo, instala o actualiza el script de inspección opcional desde la app principal e inténtalo de nuevo.

Iniciar con los detalles del informe expandidos

Inicia la app con --expand-details para abrir las vistas del informe con las secciones de detalles expandidas. Úsalo como un comando de inicio independiente. --open solo acepta la ruta del objetivo.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --expand-details

Objetivos compatibles

La CLI acepta los mismos tipos prácticos de archivo que la app.

  • Paquetes .app
  • Paquetes instaladores .pkg
  • Imágenes de disco .dmg
  • Ejecutables binarios
  • Scripts ejecutables

Exportar informes

Usa --export json cuando otra herramienta o un agente de IA vaya a procesar el informe. Usa --export txt cuando lo vaya a leer una persona.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --export json --target "/Applications/Example.app" --output "$HOME/Desktop/example-report.json"
'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --export txt --target "$HOME/Downloads/Example.pkg"

Omite --output para escribir JSON o texto en la salida estándar. Estos informes incluyen hallazgos de seguridad, comprobaciones de entrega de actualizaciones, detalles de compatibilidad, historial de descargas y metadatos de archivos. La interfaz de la app también puede exportar informes PDF e imagen PNG para registros y notas de soporte.

Elegir el nivel de detalle de la evidencia JSON

Las exportaciones JSON usan --evidence summary de forma predeterminada. Agrega --evidence full para incluir la salida sin procesar de los comandos en el informe JSON.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --export json --target "/Applications/Example.app" --evidence full

Revisa los informes antes de compartirlos. Las URL de red se exportan sin cambios y pueden contener valores de consulta o fragmentos privados.

Validar un informe JSON guardado

Usa --validate-report para comprobar la estructura y la coherencia interna de un informe JSON guardado sin volver a escanear el objetivo. Un informe válido no demuestra que el software inspeccionado sea seguro.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --validate-report "$HOME/Desktop/example-report.json"
'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --validate-report "$HOME/Desktop/example-report.json" --json

Agrega --json para devolver valid, issueCount e issues como JSON. Esta opción está disponible para la validación de informes y el descubrimiento de pruebas. Para exportar informes, usa --export json.

Guardar una app como APP, ZIP o DMG

Usa --save-app para guardar el paquete de la app. Elige app, zip o dmg y proporciona --target y --output.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --save-app zip --target "/Applications/Example.app" --output "$HOME/Desktop/Example.zip"

El origen debe ser un paquete .app. Usa un destino nuevo con la extensión correspondiente .app, .zip o .dmg en una carpeta existente con permiso de escritura. El destino no puede estar dentro de la app de origen ni del paquete de App Trust Preview que se está ejecutando.

En la versión de Mac App Store, instala o actualiza el auxiliar opcional AppTrustPreviewInspect desde la app principal antes de guardar apps. La versión de Setapp usa su auxiliar integrado.

Filtrado de escaneo

Por defecto la CLI ejecuta todos los escaneos disponibles. Puedes descubrir claves de pruebas y pedir un conjunto más pequeño cuando necesites automatización más rápida.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --list-tests
'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --list-tests --json
'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --export json --target "/Applications/Example.app" --tests signature,notarization,privacyAccesses

El valor especial all solicita todos los escaneos. La identidad siempre se incluye y App Trust Preview agrega automáticamente los escaneos de dependencia requeridos.

Rutas permitidas

Abre Ajustes de App Trust Preview y elige Rutas permitidas antes de usar automatización fuera de las carpetas de apps por defecto. Agrega carpetas donde puedan vivir los objetivos con acceso de lectura. /Applications ya tiene acceso de solo lectura.

  • Agrega ~/Downloads si las apps, instaladores, imágenes de disco, binarios o scripts descargados se guardan ahí.
  • Agrega ~/Applications si mantienes apps por usuario ahí.
  • Agrega una carpeta de salida de informes con lectura y escritura si la automatización debe guardar archivos allí.

Si no se puede acceder a un objetivo o ruta de salida, la CLI imprime una guía que apunta al mismo panel de Ajustes.

Gestionar la salida y los códigos de salida

Lee los informes y los resultados de validación desde stdout, y los mensajes de error desde stderr. Para exportar, validar, guardar apps y abrir objetivos, el código de salida 0 indica que el comando se completó correctamente, 1 que una operación falló o la validación encontró problemas, y 2 que los argumentos no son válidos o el informe no se puede leer o tiene un formato incorrecto. Una exportación correcta no significa que el software sea seguro.

Usar con agentes de IA

App Trust Preview puede dar evidencia local a un agente de IA sin subir el software inspeccionado a un tercero. El flujo más fiable es hacer que el agente aprenda a usar la CLI actual desde --help y luego lea la salida del informe desde la salida estándar en lugar de adivinar opciones de exportación.

  1. Abre Ajustes en App Trust Preview y elige Rutas permitidas.
  2. Mantén /Applications para apps instaladas. Ya está disponible como solo lectura.
  3. Agrega ~/Downloads o ~/Applications con acceso de lectura cuando esas carpetas contengan objetivos.
  4. Agrega una carpeta de informes con lectura y escritura solo cuando el agente deba guardar archivos allí.
  5. Dile al agente que ejecute '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help y lea el texto de ayuda desde stdout antes de elegir opciones.
  6. Pide al agente que inspeccione objetivos específicos con --export json --target <path> y lea el informe desde stdout. Omite --output salvo que necesites guardar un archivo.
  7. Si sí quieres archivos JSON o de texto guardados, da al agente una carpeta de salida explícitamente escribible y dile que use la opción de exportación documentada en --help.
Ejecuta primero '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help y lee stdout.
Usa solo las opciones documentadas allí.
Prefiere la salida del informe en stdout.
No uses --json para exportar informes.
No escribas archivos de informe salvo que yo proporcione una carpeta de salida con acceso de escritura.

Una instrucción útil para IA es pedir identidad, firma y validez de la marca de tiempo, notarización, seguridad de entrega de actualizaciones, sandbox, solicitudes de privacidad, decisiones de permisos guardadas, compatibilidad de la app y sus componentes, tamaño lógico y en disco, procedencia de la descarga, contenido de paquetes, seguridad de herramientas auxiliares, acceso de red, hashes ejecutables, enlaces de informes de VirusTotal e indicadores técnicos inusuales para cada objetivo de una carpeta.