サポートされているプレビューのタイプ
プレビューのタイプは、それを生成するビルドシステムとは独立して、パッケージ化する内容と実行可能な場所を決定します。各公開ワークフローには、独自の署名および eligibility 要件があります。
モバイルアプリ#
- Android: 署名付きアプリケーション APK。受信側には互換性のある Android デバイスまたはエミュレータが必要です。Android App Bundle (
.aab) はプレビューインストールパッケージではありません。 - Apple: シミュレータ用のアプリケーションバンドル、または物理デバイス用のエクスポート済み IPA。デバイスビルドには、受信側のデバイスへのインストールを許可するプロビジョニングプロファイルが必要です。
Xcode、Gradle、および Bazel のガイドでは、各ワークフローが公開できる出力について説明しています。例えば、Bazel と Once の公開は、対象となる Apple シミュレータおよび macOS アプリケーションをサポートしますが、物理デバイス用ビルドはサポートしません。
デスクトップアプリ#
ビルド済みの macOS アプリケーションバンドルを共有します:
tuist share path/to/MyApp.app
署名および公証の要件は引き続き適用されます。デスクトップアプリケーションバンドルは、受信者がプレビューを実行するために使用できる Tuist macOS アプリとは異なります。
コマンドラインツール#
macOS または Linux でスタンドアロンの実行可能ファイルを共有します:
tuist share path/to/my-tool
CLI がリソースバンドル、動的ライブラリ、またはヘルパー実行ファイルを必要とする場合は、配布ディレクトリを作成し、そのディレクトリに対するエントリポイントを指定します:
tuist share path/to/distribution --executable bin/my-tool
配布ディレクトリ全体がアップロードされます。ツールが必要とするライブラリ、リソース、およびヘルパーを含め、ビルドディレクトリの外でも実行できるようにしてください。スクリプトには shebang と、受信側のシステムにインストールされたインタプリタが必要です。
実行可能ファイル自体にはアイコンが含まれていません。--icon で PNG を渡すと、プレビューでアイコンを表示できます。例えば、Linux デスクトップアプリの場合:
tuist share path/to/distribution --executable bin/my-app --icon path/to/icon.png
複数の CLI ターゲット#
プレビューは、1 つのコミットに対する同じ CLI のビルドをグループ化します。各ビルドには、1 つのオペレーティングシステムと 1 つ以上の CPU アーキテクチャ用の配布物が含まれます。例えば、1 つのプレビューに macOS arm64、macOS x86_64、および Linux x86_64 の配布物を含めることができます。ユニバーサル macOS 実行可能ファイルは、1 つのビルドで両方の Mac アーキテクチャをカバーします。
各ターゲットを個別にビルドし、同じエントリポイントのベース名とトラックを使用して、同じ Git チェックアウトから配布物を順次公開します:
tuist share dist/macos-arm64 --executable bin/tuist --track pr
tuist share dist/macos-x86_64 --executable bin/tuist --track pr
tuist share dist/linux-x86_64 --executable bin/tuist --track pr
これらのアップロードにより、ビルドが同じプレビューリンクに追加されます。プロジェクト、コミット、公開アカウント、CLI 名、およびトラックをすべてのアップロード間で同一に保ってください。Tuist は、受信者のオペレーティングシステムと CPU アーキテクチャに一致するビルドを選択します。
クライアントとサーバーの互換性#
デスクトップおよびコマンドラインのプレビューを実行するには、最新の Tuist CLI を使用してください。Tuist をセルフホストしている場合は、これらのタイプを公開する前にサーバーを更新してください。モバイルプレビューは、古いクライアントでも引き続き動作します。
受信者のオペレーティングシステムと CPU アーキテクチャ向けにビルドしてください。Tuist はアプリのクロスコンパイルや依存関係のインストールを行いません。Linux ツールには互換性のあるシステムライブラリも必要です。
プレビューはサンドボックス内ではなく、ユーザーアカウントの権限で実行されます。信頼できる作者やプルリクエストからのビルドのみを実行してください。
実行時の動作と引数の転送については CLI でプレビューを実行する を、アクセス、トラック、および README バッジについては プレビューの概要 を参照してください。