Посібник командного рядка

Почніть з довідки

Запустіть виконуваний файл встановленого застосунку напряму з Terminal. Візьміть шлях у лапки, бо назва застосунку містить пробіли.

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

Вивід довідки перелічує поточні опції, підтримувані формати експорту, фільтрацію сканування та команди пошуку тестів.

Відкрити вікно аналізу

Використовуйте --open, коли потрібно, щоб App Trust Preview проаналізував ціль і показав звіт у застосунку.

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

Команда відкриває аналіз у новому вікні, навіть якщо основний застосунок уже запущено. Це зручно для автоматизації, наприклад для показу аналізу щоразу, коли новий застосунок додається до відстежуваної папки.

Не використовуйте жодну з наведених нижче форм Launch Services.

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

Безпосередня передача цілі в open -b блокується діалоговим вікном приватності macOS.

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

Використання --args передає ціль лише тоді, коли основний застосунок ще не запущено. Щоб уникнути обох проблем, використовуйте виконуваний файл App Trust Preview з --open.

Якщо версія з Mac App Store не може передати ціль, установіть або оновіть необов'язковий скрипт перевірки з основного застосунку та повторіть спробу.

Запуск із розгорнутими деталями звіту

Запустіть застосунок із --expand-details, щоб відкривати звіти з розгорнутими розділами деталей. Використовуйте це як окрему команду запуску. --open приймає лише шлях до цілі.

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

Підтримувані цілі

CLI приймає ті самі практичні типи файлів, що й застосунок.

• Пакети .app
• Інсталяційні пакети .pkg
• Образи дисків .dmg
• Бінарні виконувані файли
• Виконувані скрипти

Експорт звітів

Використовуйте --export json, коли інший інструмент або ШІ-агент розбиратиме звіт. Використовуйте --export txt, коли звіт читатиме людина.

'/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"

Пропустіть --output, щоб записати JSON або текст у стандартний вивід. Ці звіти містять результати перевірок безпеки й доставки оновлень, відомості про сумісність, історію завантажень і метадані файлів. Інтерфейс застосунку також може експортувати PDF і PNG звіти для записів і нотаток підтримки.

Вибір деталізації доказів у JSON

Експорт JSON за замовчуванням використовує --evidence summary. Додайте --evidence full, щоб включити необроблений вивід команд до звіту JSON.

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

Переглядайте звіти перед поширенням. Мережеві URL-адреси експортуються без змін і можуть містити приватні значення параметрів запиту або фрагменти.

Перевірка збереженого звіту JSON

Використовуйте --validate-report, щоб перевірити структуру та внутрішню узгодженість збереженого звіту JSON без повторного сканування цілі. Коректний звіт не доводить, що перевірене програмне забезпечення є безпечним.

'/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

Додайте --json, щоб отримати valid, issueCount та issues у форматі JSON. Цей параметр підтримується для перевірки звітів і пошуку тестів. Для експорту звітів використовуйте --export json.

Збереження застосунку як APP, ZIP або DMG

Використовуйте --save-app, щоб зберегти сам пакет застосунку. Виберіть app, zip або dmg і вкажіть --target та --output.

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

Джерелом має бути пакет .app. У наявній папці з дозволом на запис укажіть новий шлях призначення з відповідним розширенням .app, .zip або .dmg. Призначення не може бути всередині вихідного застосунку або пакета запущеного App Trust Preview.

У версії з Mac App Store перед збереженням застосунків установіть або оновіть необов'язковий допоміжний інструмент AppTrustPreviewInspect з основного застосунку. Версія Setapp використовує вбудований допоміжний інструмент.

Фільтрація сканування

За замовчуванням CLI запускає всі доступні перевірки. Можна знайти ключі перевірок і попросити менший набір, коли потрібна швидша автоматизація.

'/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

Спеціальне значення all запитує всі перевірки. Ідентичність завжди включена, а App Trust Preview автоматично додає потрібні залежні перевірки.

Дозволені шляхи

Відкрийте Налаштування App Trust Preview і виберіть Дозволені шляхи перед використанням автоматизації поза стандартними папками застосунків. Додайте папки, де можуть бути цілі, з доступом для читання. /Applications уже має доступ лише для читання.

• Додайте ~/Downloads, якщо там зберігаються завантажені застосунки, інсталятори, образи дисків, бінарні файли або скрипти.
• Додайте ~/Applications, якщо тримаєте там користувацькі застосунки.
• Додайте папку виводу звітів із доступом для читання й запису, якщо автоматизація має зберігати там файли.

Якщо ціль або шлях виводу недоступні, CLI друкує підказку, яка веде до тієї самої панелі Налаштувань.

Обробка виводу та кодів завершення

Читайте звіти й результати перевірки зі stdout, а повідомлення про помилки зі stderr. Для експорту, перевірки, збереження застосунків і відкриття цілі код завершення 0 означає успішне виконання команди, 1 означає збій операції або виявлені під час перевірки проблеми, а 2 означає недійсні аргументи або нечитабельний чи некоректний звіт. Успішний експорт не означає, що програмне забезпечення безпечне.

Використання з ШІ-агентами

App Trust Preview може дати ШІ-агенту локальні докази без завантаження перевіреного програмного забезпечення третій стороні. Найнадійніший робочий процес полягає в тому, щоб агент вивчив поточний CLI через --help, а потім читав вивід звіту зі стандартного виводу замість вгадування прапорців експорту.

1. Відкрийте Налаштування в App Trust Preview і виберіть Дозволені шляхи.
2. Залиште /Applications для встановлених застосунків. Він уже доступний лише для читання.
3. Додайте ~/Downloads або ~/Applications з доступом для читання, коли ці папки містять цілі.
4. Додавайте папку звітів із доступом для читання й запису лише тоді, коли агент має зберігати там файли.
5. Скажіть агенту запустити '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help і прочитати текст довідки зі стандартного виводу stdout перед вибором опцій.
6. Попросіть агента перевірити конкретні цілі за допомогою --export json --target <path> і прочитати звіт зі stdout. Пропустіть --output, якщо не потрібно зберігати файл.
7. Якщо потрібні збережені JSON або текстові файли, надайте агенту явну папку виводу з дозволом на запис і скажіть використовувати задокументовану опцію експорту з --help.

Спочатку запусти '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help і прочитай stdout.
Використовуй лише опції, описані там.
Надавай перевагу виводу звіту в stdout.
Не використовуй --json для експорту звіту.
Не записуй файли звітів, якщо я не надам папку виводу з доступом на запис.

Корисний запит для ШІ просить ідентичність, чинність підпису й позначки часу, нотаризацію, безпеку доставки оновлень, пісочницю, запити приватності, збережені рішення щодо дозволів, сумісність застосунку та компонентів, логічний і фактичний розмір на диску, походження завантаження, вміст пакета, безпеку допоміжних інструментів, мережевий доступ, хеші виконуваних файлів, посилання на звіти VirusTotal і незвичні технічні індикатори для кожної цілі в папці.