# Apple {#bundle-insights-apple}

アーカイブ、インストール可能なパッケージ、またはビルド済みアプリを `tuist inspect bundle` に指定して Apple バンドルを解析します:

::: code-group
```bash [Analyze an .ipa]
tuist inspect bundle App.ipa
```
```bash [Analyze an .xcarchive]
tuist inspect bundle App.xcarchive
```
```bash [Analyze an app bundle]
tuist inspect bundle App.app
```
```bash [Analyze by app name]
tuist inspect bundle App --platforms ios --configuration Debug
```
<!-- -->
:::

macOS でパスではなくアプリ名を渡すと、Tuist は Xcode のビルド成果物からビルド済みの `.app` を解決します（`--derived-data-path` が設定されている場合はそれを尊重）。これは `tuist share` と同じ動作です。

このコマンドはバンドルをTuistにアップロードし、内容のスキャンとモジュールの内訳を含む詳細な概要へのリンクを返します。

![解析されたバンドル](/images/guides/features/bundle-size/analyzed-bundle.png)


## App Store Connect との比較 {#app-store-connect}

Tuist は提供されたバンドルをそのまま測定し、[app thinning](https://developer.apple.com/documentation/xcode/reducing-your-app-s-size) は適用しません。報告されるサイズは **universal**（未スリム化）バリアントに対応しており、App Store Connect のアプリファイルサイズレポートで「Universal」とラベル付けされた行に相当します。デバイスごとのバリアントではありません。

数値は Universal 行と同じ範囲になると予想されますが、完全には一致しません:

- **Install size** は Universal のインストールサイズに近い値です。App Store Connect が報告する値はやや高くなります。これは、生のファイルサイズ測定では捉えられないファイルシステムブロック割り当てや Apple 独自の推定など、デバイス上のオーバーヘッドが含まれるためです。
- **Download size** は Universal のダウンロードサイズより小さくなります。Apple はアップロード後にアプリバイナリを暗号化するため、暗号化データは圧縮効率が低下し、App Store の圧縮済みダウンロードは Tuist が測定する `.ipa` アーカイブより大きくなります。これはアップロード後に Apple 側で発生するため、Tuist の数値には反映されません。

App Store Connect のデバイスごとの行はさらに小さくなります。これは、app thinning によって特定のデバイスが必要としない CPU アーキテクチャやアセットバリアントが削除されるためです。Tuist は現在、デバイスごと（スリム化済み）のサイズを報告していません。

## タグ {#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` は環境変数のタグを上書きします。タグには英字、数字、ハイフン、アンダースコアを使用でき、1つのバンドルあたり最大10個、1つのタグあたり最大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 は2つの値を報告します:

- **インストールサイズ**: デバイスにインストールされたアプリが占有する領域。
- **ダウンロードサイズ**: ユーザーがダウンロードする圧縮後のサイズ。Apple バンドルの場合、これは `.ipa` (アーカイブのサイズ) のみで報告され、`.xcarchive` または `.app` の入力では利用できません。

サイズはバイト単位で保存され、1 MB を 1,000,000 バイト、1 GB を 1,000,000,000 バイトとする十進法規則で表示されます。これは Apple がストレージ容量とアプリサイズを報告するために使用する規則と同じです ([Apple デバイスでのストレージ容量の測定方法](https://support.apple.com/en-us/102119) を参照)。733,446,863 バイトのインストールサイズは 733.4 MB と表示されます。

## 継続的インテグレーション {#continuous-integration}

時間の経過に伴うバンドルサイズを追跡するには、CI でバンドルを解析します。まず、CI が <.localized_link href="/guides/server/authentication#continuous-integration">認証済み</.localized_link> であることを確認してください。

Tuist は、どのプロジェクトにバンドルを報告すべきかも把握する必要があります。プロジェクトをまだ接続していない場合は、`tuist init` を実行するか、ハンドルを自分で宣言してください:

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

Swift マニフェストのないプロジェクト (Gradle プロジェクトなど) には <.localized_link href="/references/tuist-toml">`tuist.toml`</.localized_link> を使用します。両方のファイルが存在する場合、`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)

## プル/マージリクエストのコメント {#pullmerge-request-comments}

> [!WARNING]
> **Git フォージの統合が必要**
>
> プル/マージリクエストのコメントを自動的に取得するには、<.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 プロジェクトが [GitHub](https://github.com) などの Git プラットフォームと接続されると、`tuist inspect bundle` を実行するたびに Tuist がプル/マージリクエストに直接コメントを投稿します:

![検査済みバンドルを含む GitHub アプリのコメント](/images/guides/features/bundle-size/github-app-with-bundles.png)

## サイズしきい値 {#size-thresholds}

> [!WARNING]
> **Git フォージの統合が必要**
>
> サイズしきい値を使用するには、[Tuist GitHub App](https://github.com/apps/tuist) をプロジェクトに接続します。これはプロジェクトの統合ページから実行できます。

サイズしきい値を使用すると、ベースラインブランチと比較してバンドルサイズが設定されたパーセンテージまたは絶対サイズを超えて増加した場合にプルリクエストをブロックできます。しきい値に違反すると、Tuist は PR コミットに GitHub チェックランを作成し、サイズの増加が解決されるまでマージをブロックします:

![バンドルサイズしきい値超過を示す PR ステータスチェック](/images/guides/features/bundle-size/github-pr-check-status.png)

チェックランは、ベースラインサイズ、現在のサイズ、および設定された単位での増減を表示します。増加が意図的なものである場合、GitHub UI の **承認** ボタンをクリックして直接承認できます:

![しきい値違反を示す GitHub チェックラン](/images/guides/features/bundle-size/github-check-run-threshold.png)

### 設定 {#size-thresholds-configuration}

しきい値を設定するには、プロジェクトの **設定 > バンドル** タブに移動します:

![バンドルサイズしきい値の設定](/images/guides/features/bundle-size/bundle-size-thresholds.png)

**インストールサイズ** または **ダウンロードサイズ** を選択し、次に **しきい値の種類** を選択します:

- **パーセンテージ (%)**: ベースラインサイズに対する相対的な増加を制限します。`0.47` などの小数パーセンテージもサポートされています。既存のパーセンテージしきい値は、設定された値と動作を維持します。
- **絶対サイズ (MB)**: ベースラインサイズとは無関係に、固定量による増加を制限します。最大 1.5 MB の増加を許可するには `1.5` と入力します。MB は十進単位を使用します: 1 MB = 1,000,000 バイト。値は正の整数バイトに解決される必要があります。

![絶対バンドルサイズ増加しきい値の設定](/images/guides/features/bundle-size/absolute-size-threshold.png)

どちらのタイプも、設定された**ベースラインブランチ**上の最新のバンドルと比較されます。比較対象は、同じ名前、同じバンドルタイプ（例：`.app`または`.ipa`）、および少なくとも1つの共通プラットフォームを持つバンドルです。したがって、シミュレータ用`.app`はシミュレータ用`.app`のアップロードとのみ比較されます。オプションの**バンドル名**を使用すると、ルールをそのバンドルに限定できます。チェックが失敗するのは、増加量が制限を**超えた**場合のみです。増加量が等しい場合、サイズが変わらない場合、および減少した場合はパスします。一致するベースラインがない場合、または選択した指標の記録されたサイズがない場合、ルールはスキップされます。絶対制限ではゼロサイズのベースラインがサポートされています。パーセンテージ制限では、パーセンテージ増加が未定義であるため、引き続きスキップされます。

### 承認できるユーザーの制限 {#size-thresholds-approvals}

デフォルトでは、リポジトリへの書き込みアクセス権を持つ誰でもサイズの増加を承認できます。これは、GitHub がそのボタンを表示する対象だからです。範囲を狭めるには、**設定 > バンドル** の下にある **承認できるユーザー** を設定します:

- **全員**: デフォルトです。リポジトリへの書き込みアクセス権を持つすべてのユーザー。
- **選択した GitHub ユーザー**: 追加した GitHub ユーザー名のみ。

リストにないユーザーの場合、チェックは説明付きで失敗したままとなり、ボタンは使用可能なユーザーのために残ります。

