Поддерживаемые типы превью
Тип превью определяет, что именно вы упаковываете и где это может выполняться, независимо от системы сборки, которая его создала. Каждый рабочий процесс публикации имеет собственные требования к подписи и условиям допуска.
Мобильные приложения#
- Android: подписанный APK-файл приложения. Получателям требуется совместимое Android-устройство или эмулятор. Пакеты Android App Bundles (
.aab) не являются пакетами для установки превью. - Apple: пакет приложения для симулятора или экспортированный IPA-файл для физических устройств. Для сборок под устройства нужен профиль обеспечения, разрешающий установку на устройство получателя.
Руководства по Xcode, Gradle и Bazel описывают, какие артефакты может публиковать каждый рабочий процесс. Например, публикация через Bazel и Once поддерживает допустимые приложения для симуляторов Apple и macOS, но не сборки для физических устройств.
Настольные приложения#
Поделитесь собранным пакетом приложения macOS:
tuist share path/to/MyApp.app
Требования к подписи и нотариализации по-прежнему применяются. Пакет настольного приложения отличается от приложения Tuist для macOS, которое получатели могут использовать для запуска превью.
Инструменты командной строки#
Поделитесь автономным исполняемым файлом на macOS или Linux:
tuist share path/to/my-tool
Если CLI требует пакеты ресурсов, динамические библиотеки или вспомогательные исполняемые файлы, соберите директорию дистрибутива и укажите точку входа относительно этой директории:
tuist share path/to/distribution --executable bin/my-tool
Загружается вся директория дистрибутива. Включите библиотеки, ресурсы и вспомогательные файлы, необходимые вашему инструменту, и убедитесь, что он может работать вне директории сборки. Скриптам требуются shebang и интерпретатор, установленные в системе получателя.
Исполняемые файлы не имеют собственного значка. Передайте PNG-файл через --icon, чтобы показать значок в превью, например, для настольного приложения Linux:
tuist share path/to/distribution --executable bin/my-app --icon path/to/icon.png
Несколько целей CLI#
Превью группирует сборки одного и того же CLI для одного коммита; каждая сборка содержит дистрибутив для одной операционной системы и одной или нескольких архитектур CPU. Например, одно превью может содержать дистрибутивы для macOS arm64, macOS x86_64 и Linux x86_64. Универсальный исполняемый файл macOS покрывает обе архитектуры Mac в одной сборке.
Соберите каждую цель отдельно, затем публикуйте дистрибутивы последовательно из одного и того же рабочего каталога Git, используя одно и то же базовое имя точки входа и трек:
tuist share dist/macos-arm64 --executable bin/tuist --track pr
tuist share dist/macos-x86_64 --executable bin/tuist --track pr
tuist share dist/linux-x86_64 --executable bin/tuist --track pr
Эти загрузки добавляют сборки к одной и той же ссылке превью. Сохраняйте проект, коммит, учетную запись публикации, имя CLI и трек одинаковыми во всех загрузках. Tuist выбирает сборку, соответствующую операционной системе и архитектуре CPU получателя.
Совместимость клиента и сервера#
Используйте актуальную версию Tuist CLI для запуска превью настольных приложений и инструментов командной строки. Если вы размещаете Tuist самостоятельно, обновите сервер перед публикацией этих типов. Мобильные превью продолжают работать со старыми версиями клиентов.
Собирайте приложение для операционных систем и архитектур CPU ваших получателей. Tuist не выполняет кросс-компиляцию вашего приложения и не устанавливает его зависимости; инструментам для Linux также требуются совместимые системные библиотеки.
Превью выполняются с правами вашей пользовательской учетной записи, а не в песочнице. Запускайте только сборки от авторов и pull request'ов, которым вы доверяете.
Смотрите Запуск превью через CLI для получения информации о поведении при выполнении и передаче аргументов, а также обзор превью для сведений о доступе, треках и бейджах README.