https://doc.ruscomtech.ru/index.php?action=history&feed=atom&title=%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_%D1%8D%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82%D0%BE%D0%B2_%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F_SwiftUIИнструментирование элементов управления SwiftUI - История изменений2026-09-16T13:39:44ZИстория изменений этой страницы в викиMediaWiki 1.43.9https://doc.ruscomtech.ru/index.php?title=%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_%D1%8D%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82%D0%BE%D0%B2_%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F_SwiftUI&diff=2764&oldid=prevENetrebin: Новая страница: «'''ЕдиныйАгент для iOS версии 8.249+''' После инструментирования вашего мобильного приложени...»2023-05-18T16:55:08Z<p>Новая страница: «'''ЕдиныйАгент для iOS версии 8.249+''' После инструментирования вашего мобильного приложени...»</p>
<p><b>Новая страница</b></p><div>'''ЕдиныйАгент для iOS версии 8.249+'''<br />
<br />
После инструментирования вашего мобильного приложения с помощью ЕдиныйАгент для iOS, вам может потребоваться также инструментировать SwiftUI-элементы вашего приложения. Эта страница содержит дополнительную информацию о том, как настроить ваш проект, обновить SwiftUI instrumentor, преодолеть некоторые известные ограничения и многое другое.<br />
<br />
Для инструментирования элементов управления SwiftUI, SwiftUI instrumentor добавляет дополнительный код в исходный код вашего проекта (файлы '''*.swift''') в процессе сборки. Этот код отслеживает состояние элементов пользовательского интерфейса и уведомляет ЕдиныйАгент для iOS обо всех обновлениях. После завершения процесса сборки все изменения в исходном коде вашего проекта отменяются.<br />
<br />
{| class="wikitable"<br />
|❗ '''''Важно'''''<br />
<br />
''Для получения подробной информации о действиях, выполняемых SwiftUI instrumentor, и копии измененных файлов кода проверьте каталог '''Ключ-АСТРОМ_instrumented'''. SwiftUI instrumentor создает резервные копии инструментированных файлов и сгенерированных журналов в формате ZIP-архива.''<br />
|}<br />
<br />
= 1. Требования =<br />
<br />
* SwiftUI version 2.0+<br />
* iOS 14+<br />
* ЕдиныйАгент for iOS<br />
<br />
= 2. Поддерживаемые элементы управления =<br />
<br />
* Button<br />
* Stepper<br />
* Picker<br />
* Toggle<br />
* Slider<br />
<br />
= 3. Необходимые шаги =<br />
<br />
# Создайте приложение в веб-интерфейсе Ключ-АСТРОМ.<br />
# Настройте ЕдиныйАгент для своего проекта<br />
# Установите [[Инструментирование элементов управления SwiftUI#%204.1.%20%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0%20SwiftUI|SwiftUI instrumentor]]<br />
<br />
= 4. Управление SwiftUI instrumentor =<br />
<br />
== 4.1. Установка SwiftUI instrumentor ==<br />
Для инструментирования элементов управления SwiftUI в вашем приложении установите<br />
<br />
Ключ-АСТРОМ SwiftUI instrumentor. Вы можете сделать это через Homebrew или вручную.<br />
{| class="wikitable"<br />
|+<br />
!'''Homebrew'''<br />
!'''Вручную'''<br />
|-<br />
|<br />
# Запустите команду '''brew tap Ключ-АСТРОМ/tools''', чтобы добавить один из Ключ-АСТРОМ taps.<br />
# Запустите команду '''brew install DTSwiftInstrumentor''', чтобы установить SwiftUI instrumentor.<br />
# Закройте Xcode и выполните команду '''DTSwiftInstrumentor install <PROJECT.xcodeproj> --scheme <SCHEME> --target <TARGET>'''.<br />
|<br />
# Скачайте и распакуйте ZIP-файл, содержащий наш SwiftUI instrumentor. Ссылка на файл доступна в мастере мобильной инструментации (mobile instrumentation wizard).<br />
# Создайте папку '''.Ключ-АСТРОМ''' в корне вашего проекта - на том же уровне, что и файл '''*.xcodeproj'''.<br />
<br />
❗ '''''Важно'''''<br />
<br />
Если вы получаете системное предупреждение о том, что вы не можете создать папку с именем, начинающимся с точки, выполните одно из следующих действий:<br />
<br />
* В терминале запустите команду '''mkdir .Ключ-АСТРОМ''' в корне проекта, чтобы создать папку '''.Ключ-АСТРОМ'''.<br />
* В терминале запустите команду '''defaults write com.apple.finder AppleShowAllFiles true''' и '''killall Finder''', чтобы показать скрытые папки и файлы. Затем в Finder создайте папку '''.Ключ-АСТРОМ'''.<br />
<br />
Вы также можете выполнить команду '''defaults write com.apple.finder AppleShowAllFiles false''' и '''killall Finder''', чтобы снова скрыть скрытые папки и файлы.<br />
<br />
3. Скопируйте загруженный '''DTSwiftInstrumentor''' в папку '''.Ключ-АСТРОМ''' и убедитесь, что файл можно выполнить (executable).<br />
<br />
4. Выйдите из Xcode и выполните команду '''.Ключ-АСТРОМ/DTSwiftInstrumentor install <PROJECT.xcodeproj> --scheme <SCHEME> --target <TARGET>'''.<br />
|}<br />
❗ '''''Важно'''''<br />
<br />
Если при реализации возникнет ошибка, проверьте журнал сборки Xcode или журнал инструментации для получения подробной информации об ошибке. Дополнительные подсказки см. в разделе [[Инструментирование элементов управления SwiftUI#%208.%20%D0%A3%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BD%D0%B5%D0%BF%D0%BE%D0%BB%D0%B0%D0%B4%D0%BE%D0%BA|Устранение неполадок]].<br />
<br />
При сборке вашего приложения используйте схему, которую вы инструментировали.<br />
<br />
== 4.2. Обновление SwiftUI instrumentor ==<br />
Когда новая версия SwiftUI будет доступна, вы сможете обновить ее через Homebrew или вручную.<br />
{| class="wikitable"<br />
!'''Homebrew'''<br />
!'''Вручную'''<br />
|-<br />
|Как только новая версия инструмента будет выпущена, она будет загружаться через добавленный tap. Чтобы обновить SwiftUI instrumentor, запустите команды '''brew update''' и '''brew upgrade DTSwiftInstrumentor'''.<br />
|<br />
# Скачайте и разархивируйте ZIP-файл, содержащий новую версию SwiftUI instrumentor. Ссылка доступна в мастере мобильной инструментации (mobile instrumentation wizard).<br />
# Скопируйте загруженный '''DTSwiftInstrumentor''' в папку '''.Ключ-АСТРОМ''' и замените существующий файл.<br />
|}<br />
❗ '''''Важно'''''<br />
<br />
Если вы видите следующее предупреждение при сборке, вам также нужно обновить скрипты сборки, которые были интегрированы во время установки Ключ-АСТРОМ SwiftUI instrumentor.<br />
<br />
Ключ-АСТРОМ: There is an upgrade for your project instrumentation. Please execute "DTSwiftInstrumentor project-upgrade <PROJECT.xcodeproj>" to upgrade your project<br />
<br />
Выполните предложенную команду для обновления скриптов сборки, а затем сохраните внесенные изменения в файле вашего проекта.<br />
<br />
== 4.3. Удаление SwiftUI instrumentor ==<br />
Если вам больше не нужен Ключ-АСТРОМ SwiftUI instrumentor, вы можете удалить его из системы с помощью Homebrew или вручную удалить его из своего проекта.<br />
{| class="wikitable"<br />
!'''Homebrew'''<br />
!'''Вручную'''<br />
|-<br />
|Выполните команду '''brew remove DTSwiftInstrumentor''' и '''brew untap Ключ-АСТРОМ/tools''', чтобы удалить SwiftUI instrumentor из вашей системы.<br />
|<br />
# Запустите '''DTSwiftInstrumentor uninstall <PROJECT.xcodeproj>''', чтобы удалить SwiftUI instrumentor из вашего проекта.<br />
# (Опционально) Удалите папки '''.Ключ-АСТРОМ''' и '''Ключ-АСТРОМ_instrumented''' из вашего проекта.<br />
<br />
Эти папки содержат кэш, данные журналов и, при наличии, вручную установленный бинарный файл инструментария. Они содержат кэш инструментария, данные журналов и, при наличии, бинарные файлы инструментария.<br />
|}<br />
<br />
= 5. Проверьте различия инструментирования SwiftUI =<br />
'''ЕдиныйАгент для iOS версии 8.257+'''<br />
<br />
Для проверки различий между вашим исходным кодом и кодом, измененным SwiftUI instrumentor, выполните одну из следующих команд:<br />
<br />
* Из корневой директории проекта выполните одну из следующих команд, чтобы проверить разницу между вашим и измененным инструментом SwiftUI:<br />
** '''DTSwiftInstrumentor diff''', если вы установили инструмент с помощью Homebrew<br />
** '''.Ключ-АСТРОМ/DTSwiftInstrumentor diff''', если вы установили инструмент вручную<br />
* Из любой директории:<br />
** '''DTSwiftInstrumentor diff <путь-к-корневой-директории-проекта>'''<br />
<br />
= 6. Известные ограничения =<br />
<br />
== 6.1. Инструментирование пользовательских элементов управления SwiftUI не поддерживается ==<br />
В настоящее время Ключ-АСТРОМ не поддерживает инструментирование пользовательских элементов управления SwiftUI. Список элементов управления SwiftUI, которые можно инструментировать, можно найти в разделе [[Инструментирование элементов управления SwiftUI#%202.%20%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5%20%D1%8D%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82%D1%8B|Поддерживаемые элементы управления]].<br />
<br />
== 6.2. Проблемы с предпросмотром в Xcode. ==<br />
Когда сборка симулятора включала инструменты SwiftUI, предварительные просмотры не загружались в Xcode. В качестве обходного пути мы отключили инструментарий SwiftUI для сборок симулятора. Если вы хотите добавить инструментарий SwiftUI в сборки симулятора, см. [[Инструментирование элементов управления SwiftUI#%207.3.%20%D0%A1%D0%B1%D0%BE%D1%80%D0%BA%D0%B8%20%D1%81%D0%B8%D0%BC%D1%83%D0%BB%D1%8F%D1%82%D0%BE%D1%80%D0%B0|Сборки симулятора инструментов]].<br />
<br />
== 6.3. Только SwiftUI 2.0+ ==<br />
Ключ-АСТРОМ поддерживает инструментирование SwiftUI 2.0+ потому, что listener '''onChange''' недоступен в более ранних версиях SwiftUI. Поэтому требуется версия iOS 14+ для целевой платформы.<br />
<br />
== 6.4. Более длительное время сборки ==<br />
В отличие от ЕдиныйАгент для iOS, который изменяет ваше мобильное приложение в памяти во время выполнения, SwiftUI instrumentor изменяет исходный код вашего проекта во время сборки. По этой причине, процесс инструментации SwiftUI существенно влияет на время сборки.<br />
<br />
Чтобы сократить время сборки, можно использовать следующие методы:<br />
<br />
* Собирайте приложение только для устройств ('''Device'''). Если вы решили инструментировать сборки для симулятора, отключите эту функцию.<br />
* Не запускайте инструментирование SwiftUI на каждой возможной сборке. Мы рекомендуем запускать инструментирование SwiftUI на ветках, таких как '''main''' или '''release'''.<br />
<br />
== 6.5. Несовместимость с watchOS ==<br />
Невозможно скомпилировать проект, содержащий файлы, добавляемые в цель watchOS, поскольку ЕдиныйАгент для watchOS отсутствует. В этом случае [[Инструментирование элементов управления SwiftUI#%207.2.%20%D0%98%D1%81%D0%BA%D0%BB%D1%8E%D1%87%D0%B8%D1%82%D1%8C%20%D1%84%D0%B0%D0%B9%D0%BB%D1%8B|вручную исключите]] все файлы, которые используются совместно или являются частью цели watchOS.<br />
<br />
== 6.6. tvOS не поддерживается ==<br />
В настоящее время официальной поддержки сборок tvOS SwiftUI нет.<br />
<br />
= 7. Настройка инструментирования SwiftUI =<br />
<br />
== 7.1. Включить повтор сеанса (Session Replay) при сбоях ==<br />
Воспроизведение сеанса при сбоях может фиксировать и визуально воспроизводить действия, которые пользователь вашего приложения выполнял до того, как произошел сбой.<br />
<br />
== 7.2. Исключить файлы из SwiftUI instrumentor ==<br />
По умолчанию, инструментатор Ключ-АСТРОМ SwiftUI обрабатывает все файлы с расширением '''.swift''', но инструментирует только файлы, содержащие поддерживаемые элементы управления. Если необходимо, вы можете исключить определенные файлы и директории из процесса инструментирования SwiftUI.<br />
<br />
Чтобы исключить файлы и директории из процесса инструментирования SwiftUI:<br />
<br />
# Добавьте ключ конфигурации '''DTXExcludedSwiftUIFiles''' в файл '''Info.plist''' вашего проекта.<br />
# Перечислите относительные пути ко всем файлам и каталогам, которые вы не хотите инструментировать. Пути должны указываться относительно корня проекта, то есть каталога, в котором находится файл '''.xcodeproj'''.<br />
<br />
<key>DTXExcludedSwiftUIFiles</key><br />
<br />
<array><br />
<br />
<string>relative/file/path/</string><br />
<br />
<string>relative/file.swift</string><br />
<br />
</array><br />
<br />
<br />
Журнал инструментирования, доступный после каждой сборки, содержит список файлов и каталогов, которые следует исключить из инструментирования SwiftUI. Журнал инструментирования также показывает, был ли файл или каталог исключен в процессе инструментирования.<br />
<br />
== 7.3. Сборки симулятора инструментов ==<br />
Мы отключили инструментирование SwiftUI для сборок симулятора, чтобы решить [[Инструментирование элементов управления SwiftUI#%206.2.%20%D0%9F%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%D1%8B%20%D1%81|проблему с предварительным просмотром в Xcode]].<br />
<br />
Чтобы включить инструменты SwiftUI для сборок симулятора, добавьте ключ конфигурации '''DTXSwiftUIInstrumentSimulatorBuilds''' в файл '''Info.plist''' вашего проекта и установите для этого ключа значение '''true'''.<br />
<br />
<key>DTXSwiftUIInstrumentSimulatorBuilds</key><br />
<br />
<true/><br />
<br />
== 7.4. Создание сборок для неподдерживаемых целей развертывания ==<br />
SwiftUI instrumentor генерирует код, совместимый со SwiftUI 2.0+, который работает только на устройствах с iOS 14+. Попытка создать сборки для целей развертывания iOS 13 и более ранних версий завершится ошибкой.<br />
<br />
Чтобы переопределить эту проверку, добавьте ключ конфигурации '''DTXSwiftUIIgnoreDeploymentTarget''' в файл '''Info.plist''' вашего проекта и установите для этого ключа значение '''true'''.<br />
<br />
<key>DTXSwiftUIIgnoreDeploymentTarget</key><br />
<br />
<true/><br />
<br />
== 7.5. Включить сопоставление номеров строк для проектов Objective-C ==<br />
Отчеты о сбоях, доступные в Ключ-АСТРОМ, не основаны на исходном коде вашего проекта. Эти отчеты основаны на измененном коде, который Ключ-АСТРОМ генерирует во время инструментирования. Вот почему сопоставление номеров строк добавляется в ваш проект во время инструментирования, а затем передается в Ключ-АСТРОМ при запуске приложения. В противном случае номера строк в отчетах о сбоях будут неверными.<br />
<br />
По умолчанию Ключ-АСТРОМ SwiftUI instrumentor создает сопоставление номеров строк и вставляет его в основной класс вашего проекта. Это происходит автоматически для проектов с основным классом Swift, но не для устаревших проектов Objective-C. Для таких проектов вы получите сообщение об ошибке, и наш инструментарий SwiftUI не будет инструментировать ваше мобильное приложение.<br />
<br />
Чтобы включить сопоставление номеров строк для проектов Objective-C<br />
<br />
# Добавьте ключ конфигурации '''DTXSwiftUIManualPlaceholder''' в файл '''Info.plist''' вашего проекта и установите для этого ключа значение '''true'''.<br />
<br />
<key>DTXSwiftUIManualPlaceholder</key><br />
<br />
<true/><br />
<br />
# Добавьте в основной класс специальный placeholder '''AppDelegate.m'''.<br />
# Добавьте '''[Ключ-АСТРОМ setSwiftUiMapping:@"_Ключ-АСТРОМ_SWIFTUI_MAPPING_PLACEHOLDER_"];''' к основному классу либо в методе '''init''', либо в методе '''didFinishLaunchingWithOptions'''.<br />
<br />
Во время сборки, SwiftUI instrumentor заменяет часть этой строки сгенерированным сопоставлением номеров строк.<br />
<br />
== 7.6. Включить автоматическую очистку журнала ==<br />
'''ЕдиныйАгент для iOS версии 8.257+'''<br />
<br />
После каждой сборки SwiftUI instrumentor создает резервные копии инструментированных файлов и сгенерированных журналов, которые хранятся в каталоге '''Ключ-АСТРОМ_instrumented'''. По умолчанию эти файлы не удаляются, и общий размер каталога со временем будет расти. По этой причине мы рекомендуем вам включить автоматическую очистку журнала.<br />
<br />
* Чтобы удалить журналы SwiftUI instrumentor после определенного количества сборок, добавьте ключ конфигурации '''DTXCleanSwiftUILogsByCount''' в файл '''Info.plist''' вашего проекта.<br />
<br />
<key>DTXCleanSwiftUILogsByCount</key><br />
<br />
<number>10</number><br />
<br />
* Чтобы удалить журналы через определенное количество дней, добавьте ключ конфигурации '''DTXCleanSwiftUILogsByAgeDays''' в файл '''Info.plist'''.<br />
<br />
<key>DTXCleanSwiftUILogsByAgeDays</key><br />
<br />
<number>5</number><br />
<br />
<br />
Если вы добавите оба ключа в файл '''Info.plist''', ключ '''DTXCleanSwiftUILogsByAgeDays''' будет иметь приоритет.<br />
<br />
= 8. Устранение неполадок =<br />
Мы все еще работаем над улучшением процесса инструментирования SwiftUI. Если у вас возникнут какие-либо проблемы при инструментировании элементов управления SwiftUI, обратитесь в службу поддержки Ключ-АСТРОМ и предоставьте файл журнала затронутой сборки. Вы можете найти файл журнала самой последней сборки по пути '''Ключ-АСТРОМ_instrumented/current/instrumentation.log'''. Файлы журналов предыдущих сборок находятся в архивах с отметками времени в разделе '''Ключ-АСТРОМ_instrumented'''.<br />
<br />
== 8.1. Инструментация уже работает ==<br />
Если у вас возникла проблема с Ключ-АСТРОМ SwiftUI instrumentor, и он не был восстановлен автоматически, выполните шаги, описанные ниже.<br />
<br />
# Остановите процесс '''DTSwiftInstrumentor''', если он все еще существует.<br />
# Если вы видите изменения, сделанные SwiftUI instrumentor в исходном коде вашего проекта, выполните следующую команду в корне проекта:<br />
<br />
* '''DTSwiftInstrumentor restore .''' если вы установили инструмент через Homebrew<br />
* '''.Ключ-АСТРОМ/DTSwiftInstrumentor restore .''' если вы установили инструмент вручную<br />
<br />
== 8.2. DTSwiftInstrumentor завершил работу с ошибкой при обработке <filename> ==<br />
Бинарный файл SwiftUI instrumentor дал сбой. Обратитесь в службу поддержки Ключ-АСТРОМ и предоставьте файл журнала затронутой сборки.</div>ENetrebin