# 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
```

将 scheme、项目和 workspace 名称替换为你自己的。要分享 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"
```

请参阅<.localized_link href="/guides/features/previews#run-a-preview">运行预览</.localized_link>，了解如何运行已发布的构建、访问权限、渠道以及 README 徽章。

## 使用 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}

使用 `--json` 从 `tuist share` 获取 JSON 输出：

```bash
tuist share --json
```

将结果用于自定义自动化，例如从 CI 发布 Slack 消息。`url` 键包含完整的预览链接；`qrCodeURL` 指向用于在设备上打开预览的二维码图片：

```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>。
