# Gradle プレビュー

Android アプリとネイティブなコマンドラインツールを Gradle から直接ビルドして共有します。プロジェクトの接続と認証は <.localized_link href="/guides/get-started/gradle-project">Gradle プロジェクトガイド</.localized_link> から始めましょう。

## Android アプリ

```bash
./gradlew :app:tuistShareDebug
```

`dev.tuist` 設定プラグインは、Android Gradle Plugin（8.8.2 以降）の各アプリケーションバリアントに対して `tuistShare<Variant>` タスクを登録します。`app` と `Debug` は、お使いのアプリケーションモジュールとバリアントに置き換えてください。例えば、プロダクトフレーバーの場合は `:app:tuistShareDemoDebug` のようになります。このタスクは、公開前に Gradle の宣言されたアーティファクト依存関係を通じて APK をビルドします。ビルド出力が最新の状態である場合や、ビルドキャッシュから復元された場合にも動作します。

署名付きの単一かつユニバーサルなアプリケーション APK のみがサポートされます。Android のデバッグバリアントは通常、デバッグ署名鍵を使用します。リリースバリアントでは独自の署名設定が必要です。このタスクは、認証やアップロードの前に APK の署名を検証します。署名なし、無効、インストゥルメンテーション、分割 APK は拒否されます。ライブラリモジュール、テスト APK、Android App Bundle（`.aab`）は公開対象ではありません。

## ネイティブなコマンドラインツール

Gradle の `cpp-application` または `swift-application` プラグインを使用するプロジェクトでは、各ネイティブバイナリに対して共有タスクが用意されます。

```bash
./gradlew :app:tuistShareMainDebug
```

このタスクは、ランチャーとランタイムライブラリを含むインストール済みディストリビューションをビルドしてパッケージ化します。リリースバイナリには `tuistShareMainRelease` を使用してください。複数のマシンを対象とするプロジェクトでは、各バイナリに対してタスクが用意されています。`./gradlew :app:tasks --all` を実行して名前を確認してください。

arm64 または x86_64 向けのネイティブ macOS および Linux 実行ファイルがサポートされます。Gradle プラグインが必要とするツールチェーンを使用して、ターゲットプラットフォーム上でビルドしてください。JVM アプリケーションとその生成されたランチャースクリプトは、この統合ではサポートされません。

## 公開の動作

共有タスクは、Tuist CLI を呼び出さずに、プラグインの既存の Tuist 認証情報を使用して公開を行います。通常の `assemble`、`build`、およびテストタスクはプレビューを公開しません。

共有後、プロジェクトで **プレビュー** を開いてリンクをコピーしてください。同じビルドとトラックでの共有を繰り返すと、ビルドキャッシュヒット後を含めて、その公開が再利用されます。アップロードに失敗した場合や確認されていない場合は共有タスクが失敗し、成功したプレビューとして報告されることはありません。

## CI とトラック

プラグインの他の認証済み機能と同じ認証情報を使用して <.localized_link href="/guides/integrations/continuous-integration">CI 認証</.localized_link> を設定し、明示的に公開をリクエストします。

```bash
./gradlew :app:tuistShareDebug --track nightly
```

同様に、ネイティブ共有タスクに `--track nightly` を追加します。タスクは、設定された Tuist プロジェクト、サーバー URL、およびプロキシ設定を使用します。プレビューの公開には常に認証が必要です。Git リビジョンメタデータ、リリースノート、自動プルリクエストコメントは、これらのタスクによって添付されません。

ホストされた Tuist では、アーティファクトの公開は 30 日後に期限切れになります。セルフホストインスタンスでは `TUIST_APP_PREVIEW_RETENTION_DAYS` を使用します。これを未設定のままにすると、このファミリーの有効期限が無効になります。期限切れの公開は、同じ意図を繰り返すことで復活させることはできません。

## 既存の APK を共有する

このワークフローの外でビルドされた APK や、レガシーなアップロードフローでリリースノートを含める場合には、CLI が引き続き利用できます。

```bash
tuist share app/build/outputs/apk/debug/app-debug.apk \
  --track nightly --release-notes "Improve checkout"
```

公開されたビルドの実行、アクセス、トラック、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"
}
```

