Настольный инструмент Консоль позволяет вам захватывать вывод консоли, таким же образом, как это делается в настоящий момент в Qt Creator - из приложения AppStudio, используя настольный инструмент. Как и консоль Qt Creator, инструмент Консоль можно использовать для запуска приложения на том же компьютере, при этом сохраняется возможность получения выходных данных с другого устройства в той же сети. Очень удобно использовать эту возможность для захвата вывода консоли на устройствах iOS или Android и просмотра данных на настольном компьютере.
При запуске приложения AppStudio на устройстве Android и сбое приложения вы можете получить файлы сгенерированного системного журнала для выполнения диагностики и устранения неполадок. Это требует использования инструментов Android SDK. Более подробно см. в статье базы знаний Как экспортировать журнал сбоев (logcat) с устройства Android.
Включить инструмент Консоль
При запуске ArcGIS AppStudio версии 1.2 или более поздней, вы увидите кнопку Консоль на панели инструментов в верхней части приложения. Она открывает инструмент Консоль.
Примечание:
Вам не нужно выполнять вход для доступа к этому инструменту.
Не считая информации о компьютере-хосте, эта страница сначала выглядит пустой, поскольку для получения информации для нее необходимо направить приложение к консоли. Это может быть выполнено только в приложении AppStudio со включенным ведением журнала.
Активировать запись в журнал в AppStudio Player
AppStudio Player имеет встроенную совместимость с консолью для разрабатываемых или корпоративных приложений. Чтобы включить журналирование в плеере, откройте боковое меню и щелкните опцию Подключить удаленную консоль. Вы должны выбрать один из трех методов для подключения к вашему устройству.
- Сканировать QR-код может быть полезно при запуске приложений в AppStudio Player на мобильных устройствах. Перед тем, как сканировать код, выберите IP-адрес в инструменте консоли. Поскольку система, на которой запущена консоль AppStudio, может иметь несколько назначенных адресов IP, QR-код будет сгенерирован для адреса, выбранного в ниспадающем списке, и будет отображен рядом с этим адресом. Щелкнув код QR, вы увидите увеличенную версию, полезную в случае, если устройство не может сканировать меньший размер кода. Отсканируйте сгенерированный QR-код в любом размере, чтобы завершить подключение.
- Подключиться через сеть позволяет выбрать запущенную в текущий момент консоль AppStudio в сети, чтобы выполнить подключение.
- Ввести адрес IP открывает новую страницу, где вы можете вручную ввести адрес IP и порт; например syslog://10.112.25.174:514. Нажмите Далее для подключения к консоли.
При использовании любого из этих методов, ваши действия в AppStudio Player будут приводить к отправке сообщений на консоль выбранного вами компьютера.
Запись сообщений с помощью Консоли
После выполнения подключения AppStudio Player к инструменту Консоль, поле Выходные местоположения журнала автоматически заполняется информацией о подключенном устройстве.
Консоль выбранного вами компьютера немедленно начнет отображать диагностическую информацию из AppStudio Player и из запускаемого с ним приложения. Сообщения из плеера и приложения в столбце Приложение отличаются. Консоль продолжит получать информацию, пока вы либо не отключите запись в журнал в AppStudio Player, либо не нажмете Остановить на консоли.
Запись сообщений интерактивно на другие консоли
Инструмент Консоль использует протокол syslog, широко поддерживаемый и совместимый способ регистрации информации в сети или в интернете. Это означает, что вы можете использовать возможности ведения журнала AppStudio Player и приложения, поддерживающие консоль, для отправки сообщений на другие консоли системного журнала, такие как Loggly.
Для этого введите адрес URL или адрес IP к расположению syslog вручную в текстовое поле Выходное местоположение журнала. Вам может понадобиться предоставить информацию с идентификатором пользователя. Введите это в текстовом поле Данные пользователя. Более подробно об информации пользовательского ID и Loggly можно узнать в Документации Loggly.
Сохранение записанных сообщений консоли в файл
Инструмент Консоль также может экспортировать полученные сообщения в файл журнала, на который можно ссылаться позднее или отправлять его другим пользователям. Для этого щелкните кнопку Сохранить на консоли во время или после записи в журнал. Появится диалоговое окно, позволяющее выбрать местоположение файла и его имя и сохранить результаты в виде файла .log.
Добавление совместимости с консолью в ваше приложение
Вы можете добавить возможность вывода сообщений консоли в ваше приложение. Как минимум, следующая строка кода позволит вашему приложению выводить сообщения консоли во внешний файл журнала в местоположении по умолчанию на вашем устройстве:
AppFramework.logging.enabled = true;
Примечание:
Чтобы гарантировать, что этот файл сможет быть создан при запуске вашего приложения на устройстве Android, в Настройках на вкладке Функции убедитесь, что выбрано Внешнее хранилище.
Более подробные примеры ведения журнала доступны в корпоративном шаблоне AppStudio Player, который поставляется вместе с AppStudio.