# Xcodeプレビュー

アプリケーションをビルドし、`tuist share`を使用してTuistプロジェクトに公開します。まず、<.localized_link href="/guides/get-started/existing-xcode-project">既存のXcodeプロジェクト</.localized_link>または<.localized_link href="/guides/get-started/generated-xcode-project">生成されたプロジェクト</.localized_link>のガイドに従ってプロジェクトを接続してください。

## ビルドと共有

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とビルド番号

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

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

公開されたビルドの実行、アクセス、トラック、およびREADMEバッジについては、<.localized_link href="/guides/features/previews#run-a-preview">プレビューを実行する</.localized_link>を参照してください。

## tuist share でトラックを指定する {#share-tracks}

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

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

## リリースノート {#release-notes}

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

```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)"` のように指定できます。これらはアプリの表示名やトラックを変更しません。

### 互換性 {#preview-metadata-compatibility}

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

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

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

> [!WARNING]
> **Git フォージの統合が必要**
>
> プル/マージリクエストへの自動コメントを取得するには、<.localized_link href="/guides/server/accounts-and-projects">リモートプロジェクト</.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 プラットフォームと接続されたら、CI でのアプリケーションビルド成功後に <.localized_link href="/cli/share">`tuist share`</.localized_link> を追加します。Tuist はプレビューリンクをプル/マージリクエストに直接投稿するため、レビュアーはローカルでビルドせずにテストできます:

![Tuist Preview リンク付きの GitHub アプリコメント](/images/guides/features/github-app-with-preview.png)

## 自動化 {#automations}

`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"
}
```


受信者は、ビルドシステム統合とは独立して、<.localized_link href="/guides/features/previews/run/macos">Tuist macOSアプリ</.localized_link>または<.localized_link href="/guides/features/previews/run/ios">iPhoneアプリ</.localized_link>を使用できます。iPhoneのガイドでは、Tuist SDKを使用した<.localized_link href="/guides/features/previews/run/ios#in-app-update-notifications">アプリ内更新通知</.localized_link>についても説明しています。
