# Быстрый старт

## PVS\-Studio Atlas Viewer

Atlas Viewer — редакция PVS\-Studio Atlas, которая представляет собой кросс\-платформенную десктопную утилиту для просмотра и разметки результатов анализа статического анализатора PVS\-Studio\. Если вам нужно развернуть серверное многопользовательское решение, перейдите к документации редакции [Atlas Server](https://pvs-studio.ru/ru/docs/manual/7197/#IDC20F28DB49)\.

### Способы установки

Дистрибутивы утилиты доступны для загрузки на странице [Скачать PVS\-Studio \(beta\)](https://pvs-studio.ru/ru/pvs-studio/download-beta/)\.

В таблице ниже приведены варианты дистрибутивов и способы их установки:

|\*\*Формат\*\*|\*\*Система и пакетный менеджер\*\*|\*\*Способ установки\*\*|
|---|---|---|
|\\\.exe|Windows, x64|Запустить инсталлятор|
|\\\.dmg|macOS, Apple Silicon|Перенести в папку Программы|
|\\\.AppImage|Linux, x64|Перенести в любой каталог|
|\\\.deb|Linux, x64|dpkg, apt|
|\\\.rpm|Linux, x64|rpm, dnf, yum, zypper|
|\\\.pacman|Linux, x64|pacman|
|\\\.tar\\\.xz|Linux, x64|Распаковать в любой каталог|

### Поддерживаемые форматы отчётов

Atlas Viewer поддерживает загрузку **только** отчётов PVS\-Studio в следующих форматах:

* `.json` — актуальный формат отчётов;
* `.plog` — устаревший формат отчётов;
* `.pvsmap` — бинарный отчёт, содержащий предупреждения, разметку результатов и исходный код \(опционально\)\.

## Интерфейс программы

### Раздел "Отчёт"

Интерфейс раздела **Отчёт** разделён на несколько функциональных областей: 

* Панель навигации; 
* Область просмотра кода; 
* Таблица диагностик; 
* Панель разметки\.

![AtlasViewer_QuickStart_ru/image1.png](https://import.viva64.com/docx/blog/AtlasViewer_QuickStart_ru/image1.png)

Левая панель \(**Workspace**\) представляет собой область для работы с файлами проекта на диске или запакованными файлами в отчёте `.pvsmap`\. Чаще всего **Workspace** совпадает с каталогом проекта\. Чтобы загрузить нужный проект в обозреватель, нужно указать к нему путь с помощью кнопки **Открыть** на панели\. В отобразившемся списке файлов можно выбрать отчёт анализатора для открытия\. При сохранении "сырого" отчёта анализатора в формат `.pvsmap` или открытии `.pvsmap` эта панель переключается из режима отображения **Workspace** в обозреватель содержимого **PVS\-Studio Map**\.

При запуске приложения автоматически загружается последний использованный **Workspace** или обозреватель **PVS\-Studio Map**, что позволяет продолжить работу без повторной настройки:

![AtlasViewer_QuickStart_ru/image2.png](https://import.viva64.com/docx/blog/AtlasViewer_QuickStart_ru/image2.png)

Центральная область отображает исходный код\. При нажатии на предупреждение анализатора происходит автоматический переход к соответствующей строке файла с кодом:

![AtlasViewer_QuickStart_ru/image3.png](https://import.viva64.com/docx/blog/AtlasViewer_QuickStart_ru/image3.png)

Правая **Панель разметки** используется для разметки предупреждений\. Пользователь может присвоить предупреждению новой уровень критичности, выбрать один из доступных статусов и оставить комментарий:

![AtlasViewer_QuickStart_ru/image4.png](https://import.viva64.com/docx/blog/AtlasViewer_QuickStart_ru/image4.png)

Нижняя панель содержит список предупреждений анализатора\. Каждая строка содержит отдельное предупреждение\. Таблица поддерживает сортировку по столбцам и различные фильтры:

![AtlasViewer_QuickStart_ru/image5.png](https://import.viva64.com/docx/blog/AtlasViewer_QuickStart_ru/image5.png)

С этой панели можно сохранить "сырой" отчёт анализатора в формат `.pvsmap`\. Файл может содержать как предупреждения и разметку, так и включать исходные файлы при необходимости:

![AtlasViewer_QuickStart_ru/image6.png](https://import.viva64.com/docx/blog/AtlasViewer_QuickStart_ru/image6.png)

Доступные варианты сохранения отчёта:

* **Сохранить с файлами кода**\. Каталог, указанный в качестве `SourceTreeRoot`, будет запакован в `.pvsmap` вместе с исходными файлами по расширениям, которые поддерживаются PVS\-Studio\.
* **Сохранить только предупреждения**\. Способ подойдёт тем, кто хочет передать кому\-то отчёт с разметкой без исходных файлов\. При этом каталог `SourceTreeRoot` всё равно необходимо настроить, чтобы пути к файлам в отчёте были обработаны корректно и визуально не содержали ссылок на пути конкретного компьютера\.
* **Текущий вид в CSV**\. Настроенный вид таблицы сохраняется в отчёт CSV для ситуаций, когда надо передать результаты анализа пользователю, у которого не установлены никакие утилиты разработчика\.

Подробнее о навигации по предупреждениям и их разметке смотрите на странице "[Просмотр и разметка результатов анализа](https://pvs-studio.ru/ru/docs/manual/7199/)"\.

### Раздел "Статистика"

Раздел **Статистика** предназначен для получения информации обо всём содержимом загруженного отчёта и о прогрессе выполнения разметки предупреждений\.

Основной элемент раздела — таблица\. Она содержит данные по категориям предупреждений\. Для каждой категории отображается количество диагностик и их распределение по статусам\. Раздел позволяет сформировать и скачать итоговый отчёт разметки\.

![AtlasViewer_QuickStart_ru/image7.png](https://import.viva64.com/docx/blog/AtlasViewer_QuickStart_ru/image7.png)

### Раздел "Настройки"

В разделе настроек доступны следующие параметры:

* **Путь к файлу настроек**: выполняет отладочную функцию на случай непредвиденной потери ранее сохранённых настроек\.
* **Имя пользователя**: используется для указания имени при разметке и комментировании результатов анализа\.
* **SourceTreeRoot**: путь до каталога с проектом; необходим для построения корректных путей до файлов с исходным кодом\.
* **Workspace как SourceTreeRoot**: если вы всегда храните отчёты анализатора в каталоге с проектом, то можно поставить галочку для использования Workspace как SourceTreeRoot для доступа к файлам по одному пути\. В ином случае стоит использовать SourceTreeRoot для каталога с проектом, а Workspace — для каталога с отчётами анализатора\.
* **Тема**: тёмная, светлая и системная\.
* **Язык**: русский и английский\.