Xcode ビルドインサイト

大規模プロジェクトでの作業において、同じコードを何度も再ビルドする必要はありません。Tuist Build Insights を使えば、ローカルや CI のビルド時間がボトルネックになる前に傾向を把握できるよう、ビルド分析を追跡できます。

ビルドインサイトは tuist inspect build コマンドによって提供され、通常はスキームのポストアクションに追加します。

ローカルのビルド時間の追跡を開始するには、スキームのポストアクションに tuist inspect build コマンドを追加して活用します。

その場合は、関連する project.pbxproj の BuildAction で runPostActionsOnFailure を YES に設定することで実行できます。

diff

<BuildAction

buildImplicitDependencies="YES"

parallelizeBuildables="YES"

+ runPostActionsOnFailure="YES">

Mise の場合、ポストアクション環境で tuist を有効化します。

Homebrew の場合、ポストアクション環境に Homebrew のパスを追加します。

アクタークレームはデフォルトで無効です。スキームのポストアクション用に設定するには、シェルのエクスポートに頼らず、そのスクリプト内で TUIST_ACTOR_ID を設定してください。Dock から起動した Xcode は ~/.zshrc からの変数を継承しません。Homebrew で設定済みのクレームを明示的に抑制するには、次を使用します。

Mise では、Mise が環境を読み込んだ後に値を上書きします。

オプトインするには、空の値ではなく明示的なラベルを使用してください。

ログインすると、ローカルビルドが追跡され、Tuist ダッシュボードから利用可能になります。

CI におけるビルドインサイト#

CI でビルドインサイトを追跡するには、CI が 認証済みであることを確認してください。

Xcodebuild 主導の CI の場合、次のことが必要です。

• xcodebuild アクションを呼び出す際は、tuist xcodebuild を使用します。
• xcodebuild コマンドに -resultBundlePath を追加します。

-resultBundlePath がないと、必要なアクティビティログと結果バンドルが生成されず、tuist inspect build でビルドを分析できません。

プライベートネットワークでの認証不要なレポート公開#

セルフホストされたデプロイメントでは、開発者がサインインせずに完了したレポートを公開できるようにすることができます。オペレーターはインスタンスで TUIST_NETWORK_TRUSTED_INSIGHTS_ACCESS=true を構成し、セルフホスティングガイドに記載されている通りに再起動する必要があります。これはサポートされているすべてのプロジェクトに適用され、ダッシュボードの設定はありません。スキームのポストアクションまたはターミナルで使用される環境で、セルフホストされた URL とプロジェクトを設定してください。認証情報がない場合、CLI は自動的にインスタンスのポリシーを検出します。

認証情報が genuinely absent（真に存在しない）場合、アクティビティログと XCResult バンドルはローカルで解析され、構造化されたレポートとして送信されます。生のアーカイブ、添付ファイル、カバレッジ/履歴のアップロード、リモートプロセッサ、シャード参照、または選択的実行の証拠は送信されません。レポートは表示されたままですが、認証されたテストケースの状態を更新したり、検疫/失敗の自動化を駆動したりすることはできません。ダッシュボードやその他の特権コマンドには引き続きサインインが必要です。インスタンスが別途ネットワーク信頼キャッシュアクセスを有効にしていない限り、または認証情報がプロビジョニングされていない限り、キャッシュ統合は無効のままにしてください。

既存の認証情報は認証されたままです。無効、破損、空白、またはリフレッシュ拒否された認証情報はフェイルクローズされ、ディスク上に残るため、後続のコマンドがサイレントに未署名状態になることはありません。意図的な復旧措置として、再度サインインするか、明示的にサインアウトしてください。認証不要クライアントをアップグレードする前に、すべてのサーバーレプリカをディスカバリー対応バージョンにアップグレードし、リダイレクトなしで最終的なサーバー URL を構成してください。ディスカバリー機能のない古いサーバー、無効化されたインスタンス、およびディスカバリー失敗時は依然として認証が必要です。クライアント側のオプトインは不要です。設定されたアクタークレームを省略するには TUIST_ACTOR_ID="" を独立して設定してください。検証済みの認証情報 ID は影響を受けません。

マシンメトリクス#

ビルドインサイトには、ビルド中にキャプチャされたマシンレベルのパフォーマンスメトリクス（CPU、メモリ、ネットワーク、およびディスク使用量）を含めることができます。これを有効にするには、システムメトリクスを継続的にサンプリングする軽量なバックグラウンドデーモンを設定します。

これにより、バックグラウンドでメトリクスをサンプリングするローカルデーモンが実行されます。データは tuist inspect build によって自動的に取得され、ビルドレポートと一緒にアップロードされます。

マシンメトリクスの収集を停止するには、次を実行します。

これにより、デーモンの LaunchAgent がアンロードされ、plist が削除され、~/.local/state からサンプリングされたメトリクスとデーモンログが削除されるため、バックグラウンドで実行されているものは何も残りません。

レポートアクタークレーム#

レポート作成リクエストには、TUIST_ACTOR_ID を組織スコープのラベルに明示的に設定した場合のみ、オプションの x-tuist-actor-id ヘッダーが含まれます（例：TUIST_ACTOR_ID=employee-123 tuist inspect build）。デフォルトではラベルは送信されず、Tuist はオペレーティングシステムのユーザー名を検出しません。空の TUIST_ACTOR_ID は報告された識別子を省略しますが、認証情報ベースの検証済み ID は削除されません。識別子はスペース以外の印刷可能 ASCII で 1〜128 バイトである必要があります。無効なオーバーライドはフォールバックせずに省略されます。カスタムプロキシが見慣れないヘッダーを拒否する場合は、空の環境オーバーライドでオプトアウトしてください。

検証済みの個別認証情報が優先されます。それ以外の場合、クライアント報告の識別子は 未検証 として表示され、権限を付与したりユーザーに自動リンクしたりすることはありません。識別子はプロジェクトのレポートを表示できる anyone に表示され、プロジェクトが公開されている場合は公開ビューアにも表示され、データエクスポートにも含まれるため、機密情報を含めないでください。これはビルド、テスト、およびコマンドイベントレポートに適用されます。古いサーバーはオプションのヘッダーを無視し、新しいサーバーはそれなしの古いクライアントを受け入れます。識別子のない新しい共有トークンレポートは、公開組織ではなく 不明 と表示されます。過去のレポートは以前の帰属を保持します。ビルドおよびテスト一覧は、検証済みユーザーと未検証の報告された識別子を区別します。セルフホストされたインスタンスが認証不要なレポート公開を明示的に有効にし、クライアントがそのポリシーを検出しない限り、認証は引き続き必要です。

カスタムメタデータ#

環境変数を使用してビルドにメタデータを添付し、フィルタリングを改善できます。

環境変数#

例#

ビルドを実行する前に、CIまたはシェルでこれらの値を設定してください：