Gradle プレビュー
Android アプリとネイティブなコマンドラインツールを Gradle から直接ビルドして共有します。プロジェクトの接続と認証は Gradle プロジェクトガイド から始めましょう。
Android アプリ#
./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 プラグインを使用するプロジェクトでは、各ネイティブバイナリに対して共有タスクが用意されます。
./gradlew :app:tuistShareMainDebug
このタスクは、ランチャーとランタイムライブラリを含むインストール済みディストリビューションをビルドしてパッケージ化します。リリースバイナリには tuistShareMainRelease を使用してください。複数のマシンを対象とするプロジェクトでは、各バイナリに対してタスクが用意されています。./gradlew :app:tasks --all を実行して名前を確認してください。
arm64 または x86_64 向けのネイティブ macOS および Linux 実行ファイルがサポートされます。Gradle プラグインが必要とするツールチェーンを使用して、ターゲットプラットフォーム上でビルドしてください。JVM アプリケーションとその生成されたランチャースクリプトは、この統合ではサポートされません。
公開の動作#
共有タスクは、Tuist CLI を呼び出さずに、プラグインの既存の Tuist 認証情報を使用して公開を行います。通常の assemble、build、およびテストタスクはプレビューを公開しません。
共有後、プロジェクトで プレビュー を開いてリンクをコピーしてください。同じビルドとトラックでの共有を繰り返すと、ビルドキャッシュヒット後を含めて、その公開が再利用されます。アップロードに失敗した場合や確認されていない場合は共有タスクが失敗し、成功したプレビューとして報告されることはありません。
CI とトラック#
プラグインの他の認証済み機能と同じ認証情報を使用して CI 認証 を設定し、明示的に公開をリクエストします。
./gradlew :app:tuistShareDebug --track nightly
同様に、ネイティブ共有タスクに --track nightly を追加します。タスクは、設定された Tuist プロジェクト、サーバー URL、およびプロキシ設定を使用します。プレビューの公開には常に認証が必要です。Git リビジョンメタデータ、リリースノート、自動プルリクエストコメントは、これらのタスクによって添付されません。
ホストされた Tuist では、アーティファクトの公開は 30 日後に期限切れになります。セルフホストインスタンスでは TUIST_APP_PREVIEW_RETENTION_DAYS を使用します。これを未設定のままにすると、このファミリーの有効期限が無効になります。期限切れの公開は、同じ意図を繰り返すことで復活させることはできません。
既存の APK を共有する#
このワークフローの外でビルドされた APK や、レガシーなアップロードフローでリリースノートを含める場合には、CLI が引き続き利用できます。
tuist share app/build/outputs/apk/debug/app-debug.apk \
--track nightly --release-notes "Improve checkout"
公開されたビルドの実行、アクセス、トラック、README バッジについては、プレビューを実行する を参照してください。
tuist share でトラックを指定する#
tuist share を使って公開するワークフローでは、--track を使用してトラックを選択します:
tuist share App --track beta
tuist share App --track nightly
リリースノート#
環境グループにはトラックを、個々のビルドの目的にはリリースノートを使用します:
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 フォージと統合してください: GitHub、Cursor Origin、または Entire。
Tuist プロジェクトが Git プラットフォームと接続されたら、CI でのアプリケーションビルド成功後に tuist share を追加します。Tuist はプレビューリンクをプル/マージリクエストに直接投稿するため、レビュアーはローカルでビルドせずにテストできます:

自動化#
tuist share から JSON 出力を取得するには --json を使用します:
tuist share --json
結果をカスタム自動化(例: CI から Slack メッセージを投稿)に利用できます。url キーには完全なプレビューリンクが含まれ、qrCodeURL はデバイスでプレビューを開くための QR コード画像を指します:
{
"id": 1234567890,
"url": "https://tuist.dev/preview/1234567890",
"qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}