コンテンツへスキップ

Xcodeプレビュー

アプリケーションをビルドし、tuist shareを使用してTuistプロジェクトに公開します。まず、既存のXcodeプロジェクトまたは生成されたプロジェクトのガイドに従ってプロジェクトを接続してください。

ビルドと共有#

Tuistで生成されたプロジェクトの場合:

bash
tuist generate App
tuist xcodebuild build -scheme App -workspace App.xcworkspace \
-configuration Debug -sdk iphonesimulator
tuist share App

既存のXcodeプロジェクトの場合:

bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
-configuration Debug -sdk iphonesimulator
tuist share App --configuration Debug --platforms iOS

スキーム、プロジェクト、ワークスペースの名前を各自のものに置き換えてください。Releaseビルドを共有するには、ビルド時に-configuration Releaseを使用し、共有時に--configuration Releaseを使用します。

実機デバイス#

受信者のデバイスへのインストールを許可するプロビジョニングプロファイルで、デバイス用ビルドに署名するのはあなたの責任です。シミュレータSDKではなく、デバイス宛てを指定してビルドしてください:

bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
-configuration Debug -destination 'generic/platform=iOS'
tuist share App --configuration Debug --platforms iOS

すでにエクスポート済みのIPAも共有できます:

bash
tuist share App.ipa

受信者はモバイルデバイスでIPAプレビューリンクを開き、アプリケーションをインストールできます。認証とプロジェクトのプレビュー表示設定は引き続き適用されます。

CIとビルド番号#

既存のCI認証を使用し、新しいビルドごとにCFBundleVersionを一意にしてください。例えば、GitHub Actionsの${{ github.run_number }}を使用します。tuist shareを通じて同じバイナリとビルド番号を再度アップロードすると、重複が作成されるのではなく失敗します。

bash
tuist share App --track beta --release-notes "Fix sign-in"

公開されたビルドの実行、アクセス、トラック、およびREADMEバッジについては、プレビューを実行するを参照してください。

tuist share でトラックを指定する#

tuist share を使って公開するワークフローでは、--track を使用してトラックを選択します:

bash
tuist share App --track beta
tuist share App --track nightly

リリースノート#

環境グループにはトラックを、個々のビルドの目的にはリリースノートを使用します:

bash
tuist share App --track QA --release-notes "Fix sign-in and improve the checkout flow"

App をアプリ名、アプリケーションファイルのパス、または実行可能配布物とその --executable オプションに置き換えます。リリースノートは任意のプレーンテキストで、最大 10,000 文字です。最初の空白でない行がプレビューリストで一行のスニペットとして表示されるため、ビルド番号やその他の識別情報が一目で確認できます。長い行は切り詰められ、詳細ページに全量が掲載されます。検索結果には表示名と完全なリリースノートが含まれ、スニペットに表示されていない行も対象となります。複数行のノートもサポートされており、例えば --release-notes "$(< release-notes.txt)" のように指定できます。これらはアプリの表示名やトラックを変更しません。

互換性#

リリースノートは、ビルドが属するプレビューを変更しません。プレビューが最初に受け取ったノートが保持されます。後からのアップロードでは、ノートがないプレビューにノートを追加できますが、既存のノートを上書きしたり削除したりすることはできません。リリースノートが存在する前にアップロードされたプレビューは、ノートなしでも有効です。

セルフホストデプロイメントでは、リリースノートとトラックフィルタリングをサポートするサーバーバージョンと、更新されたクライアントが必要です。古いサーバーはノートを無視します。リストエンドポイントのトラックおよび検索フィルターについては、API リファレンスをご覧ください。

プル/マージリクエストのコメント#

Git フォージの統合が必要

プル/マージリクエストへの自動コメントを取得するには、リモートプロジェクト を Git フォージと統合してください: GitHub、Cursor Origin、または Entire。

Tuist プロジェクトが Git プラットフォームと接続されたら、CI でのアプリケーションビルド成功後に tuist share を追加します。Tuist はプレビューリンクをプル/マージリクエストに直接投稿するため、レビュアーはローカルでビルドせずにテストできます:

Tuist Preview リンク付きの GitHub アプリコメント

自動化#

tuist share から JSON 出力を取得するには --json を使用します:

bash
tuist share --json

結果をカスタム自動化(例: CI から Slack メッセージを投稿)に利用できます。url キーには完全なプレビューリンクが含まれ、qrCodeURL はデバイスでプレビューを開くための QR コード画像を指します:

json
{
"id": 1234567890,
"url": "https://tuist.dev/preview/1234567890",
"qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}

受信者は、ビルドシステム統合とは独立して、Tuist macOSアプリまたはiPhoneアプリを使用できます。iPhoneのガイドでは、Tuist SDKを使用したアプリ内更新通知についても説明しています。