# Android {#bundle-insights-android}

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

::: code-group
```bash [Analyze an .aab (recommended)]
tuist inspect bundle App.aab
```
```bash [Analyze an .apk]
tuist inspect bundle App.apk
```
<!-- -->
:::

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

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

![Проанализированный бандл](/images/guides/features/bundle-size/analyzed-bundle.png)


## Теги {#tags}

Добавляйте теги при загрузке бандла, чтобы различать варианты сборки, окружения или каналы релизов. Теги бандлов следуют тем же правилам, что и теги в 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`. Хранение и фильтрация по тегам требуют версии сервера с поддержкой тегов бандлов: старые серверы игнорируют метаданные загрузки и отклоняют фильтры по тегам. Обновлённые клиенты опускают как метаданные загрузки, так и параметры запроса тегов, если теги не указаны.

## Понимание размеров бандлов {#understanding-sizes}

Для каждого проанализированного бандла Tuist сообщает два значения:

- **Размер установки**: место, которое приложение занимает после установки на устройство.
- **Размер загрузки**: сжатый размер, который скачивают пользователи. Для Apple-бандлов это значение сообщается только для `.ipa` (размер архива); для входных данных `.xcarchive` или `.app` оно недоступно.

Размеры хранятся в байтах и отображаются по десятичной системе, где 1 МБ = 1 000 000 байт, а 1 ГБ = 1 000 000 000 байт — та же система, которую Apple использует для отчётов о хранилище и размерах приложений (см. [Как измеряется ёмкость хранилища на устройствах Apple](https://support.apple.com/en-us/102119)). Размер установки 733 446 863 байт отображается как 733,4 МБ.

## Непрерывная интеграция {#continuous-integration}

Чтобы отслеживать размер бандла со временем, анализируйте бандл в CI. Сначала убедитесь, что ваш CI <.localized_link href="/guides/server/authentication#continuous-integration">аутентифицирован</.localized_link>.

Tuist также должен знать, к какому проекту относить бандл. Если вы ещё не подключили проект, выполните `tuist init` или укажите handle самостоятельно:

::: code-group
```swift [Tuist.swift]
let tuist = Tuist(fullHandle: "my-account/my-project")
```
```toml [tuist.toml]
project = "my-account/my-project"
```
<!-- -->
:::

Используйте <.localized_link href="/references/tuist-toml">`tuist.toml`</.localized_link> для проектов без Swift-манифеста, например Gradle-проектов. Если присутствуют оба файла, приоритет имеет `Tuist.swift`.

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

::: code-group
```yaml [Apple]
name: Build

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

После настройки вы сможете видеть, как меняется размер вашего бандла со временем:

![График размера бандла](/images/guides/features/bundle-size/bundle-size-graph.png)

## Комментарии к pull/merge request {#pullmerge-request-comments}

> [!WARNING]
> **Требуется интеграция с Git-форжем**
>
> Чтобы получать автоматические комментарии к pull/merge request, интегрируйте свой <.localized_link href="/guides/server/accounts-and-projects">проект Tuist</.localized_link> с Git-форжем: <.localized_link href="/guides/integrations/gitforge/github">GitHub</.localized_link>, <.localized_link href="/guides/integrations/gitforge/origin">Cursor Origin</.localized_link> или <.localized_link href="/guides/integrations/gitforge/entire">Entire</.localized_link>.

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

![Комментарий приложения GitHub с проинспектированными бандлами](/images/guides/features/bundle-size/github-app-with-bundles.png)

## Пороги размера {#size-thresholds}

> [!WARNING]
> **Требуется интеграция с Git-форжем**
>
> Чтобы использовать пороги размера, подключите [Tuist GitHub App](https://github.com/apps/tuist) к своему проекту. Это можно сделать на странице интеграций проекта.

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

![Проверка статуса PR, показывающая превышение порога размера бандла](/images/guides/features/bundle-size/github-pr-check-status.png)

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

![GitHub check run, показывающий нарушение порога](/images/guides/features/bundle-size/github-check-run-threshold.png)

### Настройка {#size-thresholds-configuration}

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

![Настройки порогов размера бандла](/images/guides/features/bundle-size/bundle-size-thresholds.png)

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

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

![Настройка порога абсолютного роста размера бандла](/images/guides/features/bundle-size/absolute-size-threshold.png)

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

### Ограничение тех, кто может принимать {#size-thresholds-approvals}

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

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

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

