Перейти к содержимому

Android

Проанализируйте Android-бандл, указав tuist inspect bundle на бандл приложения или установочный файл:

bash
tuist inspect bundle App.aab
bash
tuist inspect bundle App.apk
Note

Для анализа .apk требуется aapt2, который входит в состав инструментов сборки Android SDK. Установите ANDROID_HOME или ANDROID_SDK_ROOT, чтобы Tuist мог найти его, или добавьте aapt2 в PATH. Для анализа .aab внешние инструменты не требуются.

Команда загружает бандл в Tuist и возвращает ссылку на подробный обзор, включающий сканирование содержимого и разбивку по модулям:

Проанализированный бандл

Теги#

Добавляйте теги при загрузке бандла, чтобы различать варианты сборки, окружения или каналы релизов. Теги бандлов следуют тем же правилам, что и теги в Build Insights:

bash
tuist inspect bundle App.ipa --tags paid production

В CI вы также можете задать теги через запятую с помощью TUIST_BUNDLE_TAGS:

bash
TUIST_BUNDLE_TAGS="paid,production" tuist inspect bundle App.ipa

Явные --tags заменяют теги из переменной окружения. Теги могут содержать буквы, цифры, дефисы и подчёркивания; не более 10 тегов на бандл и до 50 символов в каждом теге. Те же параметры работают для Android-бандлов. --json остаётся локальным и не загружает ни теги, ни сам бандл.

Теги отображаются рядом с названиями бандлов и в деталях бандла. Используйте фильтр Теги в панели управления и введите тег, чтобы включить его в список бандлов или исключить из него. Сопоставление точное и чувствительное к регистру, даже если операторы фильтра названы содержит и не содержит: paid не совпадает с paid-extra. Для фильтрации из CLI:

bash
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 самостоятельно:

swift
let tuist = Tuist(fullHandle: "my-account/my-project")
toml
project = "my-account/my-project"

Используйте tuist.toml для проектов без Swift-манифеста, например Gradle-проектов. Если присутствуют оба файла, приоритет имеет Tuist.swift.

Пример рабочего процесса GitHub Actions:

yaml
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
run: tuist inspect bundle App.ipa
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
yaml
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#

Требуется интеграция с Git-форжем

Чтобы получать автоматические комментарии к pull/merge request, интегрируйте свой проект Tuist с Git-форжем: GitHub, Cursor Origin или Entire.

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

Комментарий приложения GitHub с проинспектированными бандлами

Пороги размера#

Требуется интеграция с Git-форжем

Чтобы использовать пороги размера, подключите Tuist GitHub App к своему проекту. Это можно сделать на странице интеграций проекта.

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

Проверка статуса PR, показывающая превышение порога размера бандла

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

GitHub check run, показывающий нарушение порога

Настройка#

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

Настройки порогов размера бандла

Выберите Размер установки или Размер загрузки, затем выберите Тип порога:

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

Настройка порога абсолютного роста размера бандла

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

Ограничение тех, кто может принимать#

По умолчанию любой пользователь с правами на запись в репозиторий может принять увеличение размера, потому что именно ему GitHub показывает кнопку. Чтобы сузить круг, настройте параметр Кто может принимать в разделе Настройки > Бандлы:

  • Все: по умолчанию. Любой пользователь с правами на запись в репозиторий.
  • Выбранные пользователи GitHub: только указанные вами имена пользователей GitHub.

Если пользователя нет в списке, проверка остаётся неудачной с пояснением, а кнопка остаётся доступной для тех, кто может ею воспользоваться.