Android
Проанализируйте Android-бандл, указав tuist inspect bundle на бандл приложения или установочный файл:
tuist inspect bundle App.aab
tuist inspect bundle App.apk
Для анализа .apk требуется aapt2, который входит в состав инструментов сборки Android SDK. Установите ANDROID_HOME или ANDROID_SDK_ROOT, чтобы Tuist мог найти его, или добавьте aapt2 в PATH. Для анализа .aab внешние инструменты не требуются.
Команда загружает бандл в Tuist и возвращает ссылку на подробный обзор, включающий сканирование содержимого и разбивку по модулям:

Теги#
Добавляйте теги при загрузке бандла, чтобы различать варианты сборки, окружения или каналы релизов. Теги бандлов следуют тем же правилам, что и теги в Build Insights:
tuist inspect bundle App.ipa --tags paid production
В CI вы также можете задать теги через запятую с помощью TUIST_BUNDLE_TAGS:
TUIST_BUNDLE_TAGS="paid,production" tuist inspect bundle App.ipa
Явные --tags заменяют теги из переменной окружения. Теги могут содержать буквы, цифры, дефисы и подчёркивания; не более 10 тегов на бандл и до 50 символов в каждом теге. Те же параметры работают для Android-бандлов. --json остаётся локальным и не загружает ни теги, ни сам бандл.
Теги отображаются рядом с названиями бандлов и в деталях бандла. Используйте фильтр Теги в панели управления и введите тег, чтобы включить его в список бандлов или исключить из него. Сопоставление точное и чувствительное к регистру, даже если операторы фильтра названы содержит и не содержит: paid не совпадает с paid-extra. Для фильтрации из CLI:
tuist bundle list --tags paid production
CLI, API (?tags=paid,production) и инструмент MCP list_bundles (tags: ["paid", "production"]) возвращают бандлы, содержащие все указанные теги. При загрузке через API принимается bundle.custom_metadata.tags; ответы на запросы списка и деталей возвращают custom_metadata.tags. Существующие бандлы без тегов остаются доступными как раньше. Теги фильтруют список бандлов; они не изменяют графики размеров или базовые линии для автоматического сравнения и порогов.
Существующие клиенты могут продолжать загружать и читать бандлы без тегов. Обновлённые клиенты также могут читать ответы от старых серверов, которые не включают custom_metadata. Хранение и фильтрация по тегам требуют версии сервера с поддержкой тегов бандлов: старые серверы игнорируют метаданные загрузки и отклоняют фильтры по тегам. Обновлённые клиенты опускают как метаданные загрузки, так и параметры запроса тегов, если теги не указаны.
Понимание размеров бандлов#
Для каждого проанализированного бандла Tuist сообщает два значения:
- Размер установки: место, которое приложение занимает после установки на устройство.
- Размер загрузки: сжатый размер, который скачивают пользователи. Для Apple-бандлов это значение сообщается только для
.ipa(размер архива); для входных данных.xcarchiveили.appоно недоступно.
Размеры хранятся в байтах и отображаются по десятичной системе, где 1 МБ = 1 000 000 байт, а 1 ГБ = 1 000 000 000 байт — та же система, которую Apple использует для отчётов о хранилище и размерах приложений (см. Как измеряется ёмкость хранилища на устройствах Apple). Размер установки 733 446 863 байт отображается как 733,4 МБ.
Непрерывная интеграция#
Чтобы отслеживать размер бандла со временем, анализируйте бандл в CI. Сначала убедитесь, что ваш CI аутентифицирован.
Tuist также должен знать, к какому проекту относить бандл. Если вы ещё не подключили проект, выполните tuist init или укажите handle самостоятельно:
let tuist = Tuist(fullHandle: "my-account/my-project")
project = "my-account/my-project"
Используйте tuist.toml для проектов без Swift-манифеста, например Gradle-проектов. Если присутствуют оба файла, приоритет имеет Tuist.swift.
Пример рабочего процесса GitHub Actions:
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
run: tuist inspect bundle App.ipa
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
# .aab is recommended over .apk for more accurate size analysis
run: tuist inspect bundle App.aab
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
После настройки вы сможете видеть, как меняется размер вашего бандла со временем:

Комментарии к pull/merge request#
Чтобы получать автоматические комментарии к pull/merge request, интегрируйте свой проект Tuist с Git-форжем: GitHub, Cursor Origin или Entire.
Когда ваш проект Tuist подключён к вашей Git-платформе, например GitHub, Tuist будет публиковать комментарий прямо в ваших pull/merge requests каждый раз, когда вы выполняете tuist inspect bundle:

Пороги размера#
Чтобы использовать пороги размера, подключите Tuist GitHub App к своему проекту. Это можно сделать на странице интеграций проекта.
Пороги размера позволяют блокировать pull requests, когда размер бандла превышает настроенный процент или абсолютное значение по сравнению с базовой веткой. При нарушении порога Tuist создаёт GitHub Check Run для коммита PR, блокируя слияние, пока увеличение размера не будет устранено:

Check Run показывает базовый размер, текущий размер и изменение в выбранной единице измерения. Если увеличение преднамеренное, вы можете принять его прямо в интерфейсе GitHub, нажав кнопку Принять:

Настройка#
Чтобы настроить пороги, перейдите на вкладку Настройки > Бандлы вашего проекта:

Выберите Размер установки или Размер загрузки, затем выберите Тип порога:
- Процент (%): ограничивает рост относительно базового размера. Поддерживаются дробные проценты, например
0.47. Существующие процентные пороги сохраняют свои настроенные значения и поведение. - Абсолютный размер (МБ): ограничивает рост на фиксированную величину, независимо от базового размера. Введите
1.5, чтобы разрешить рост до 1,5 МБ. МБ использует десятичные единицы: 1 МБ = 1 000 000 байт. Значения должны приводиться к положительному целому числу байт.

Оба типа сравнивают с последним бандлом на настроенной базовой ветке с тем же именем, тем же типом бандла (например, .app или .ipa) и хотя бы одной общей платформой, поэтому симуляторный .app сравнивается только с загрузками симуляторных .app. Необязательное поле Имя бандла ограничивает правило этим бандлом. Проверка завершается неудачей только если рост превышает лимит; равный рост, неизменные размеры и уменьшение проходят проверку. При отсутствии подходящей базы или записанного размера для выбранной метрики правило пропускается. Базовая версия нулевого размера поддерживается для абсолютных лимитов; процентные лимиты продолжают пропускать её, так как процентный рост не определён.
Ограничение тех, кто может принимать#
По умолчанию любой пользователь с правами на запись в репозиторий может принять увеличение размера, потому что именно ему GitHub показывает кнопку. Чтобы сузить круг, настройте параметр Кто может принимать в разделе Настройки > Бандлы:
- Все: по умолчанию. Любой пользователь с правами на запись в репозиторий.
- Выбранные пользователи GitHub: только указанные вами имена пользователей GitHub.
Если пользователя нет в списке, проверка остаётся неудачной с пояснением, а кнопка остаётся доступной для тех, кто может ею воспользоваться.