无论是通过 iTunes Connect 账户（图书发行商或音乐提供商）、App Store Connect 账户（App 开发者）还是编码工作室账户来交付图书、视频、音乐或 App 内容，你都可以使用 Transporter 验证 Store 数据包是否符合 Apple 规范，从而确保元数据和素材（例如音频、视频、图书和 App 文件）能顺利交付至 iTunes Store、Apple Books 或 App Store。由于某些 Transporter 选项会受用户类型和内容类型的限制，因此在你交付 Store 数据包前，请务必明确要用于 Transporter 身份验证的账户是 iTunes Connect 账户、App Store Connect 账户还是编码工作室账户。有关更多信息，请参见概述。

Transporter 包含以下功能：

• 操作简单、即时可用的安装包，包括用于 Apple 的 macOS、Microsoft 的 Windows 和 Red Hat Enterprise Linux 的安装程序。

• 跟踪素材：Transporter 会根据你实际交付到 iTunes Store、Apple Books 和 App Store 的文件来验证你在元数据文件中引用的素材列表（例如封面图、音频文件、视频文件、App 内购买项目和 Game Center 素材）。

  通过 Web 服务，Transporter 可根据收到的元数据验证文件列表，且在列表与元数据中的信息不符时返回错误信息。例如，“Delivered file set does not contain expected file [34D17614CB805E8AB853CD5ABCBF3C0A-940AE112-01-18-mp4-128000.m4a] that is referenced in the metadata file”。

• 自动软件更新功能：Transporter 自带此功能。你启动并运行 Transporter 后，软件更新功能会自动检查 Transporter 版本，根据需要进行更新并在控制台中显示日志信息。

• 对素材进行校验和验证：请在发送到 iTunes Store、Apple Books 和 App Store 的元数据文件中包含每个交付文件的校验和。Transporter 使用此校验和信息，根据从 Transporter 动态生成的预期校验和来验证你发送的每个文件。

• 输出错误摘要：Transporter 会显示未成功上传的 Store 数据包的错误摘要信息。在尝试上传结束之时，Transporter 会显示未成功上传的数据包名称列表，还会显示包含错误信息的摘要文本。例如：

  Package Summary: 2 package(s) were not uploaded because they had problems: /Users/bsmith/Applications/Packages/Many/00000000001041.itmsp - Error Messages: Unable to find registered encoding house user for username "bsmith" (1001) /Users/bsmith/Applications/Packages/Many/00000000001042.itmsp - Error Messages: Unable to find registered encoding house user for username "bsmith" (1001)

• 进度指示器详细信息：Transporter 包含进度指示器选项，因此你可以指定在上传期间是否让 Transporter 显示进度详细信息。

• 恢复上传：如果在上传过程中网络连接失败或者服务器脱机，Transporter 可在稍后恢复上传。

本指南内容结构如下：

• 更新内容：列出当前版本包含的功能更新。

• 欢迎：总体介绍 Transporter 及其关键功能。

• 使用入门：阐述系统和网络要求，并概述安装和设置 Transporter 的步骤。

• 内容类型详细信息：介绍每种内容类型（图书、有声书、视频、App 和音乐）专用的功能和模式。

• 运行 Transporter：阐述如何使用 Transporter，包括使用各个模式、选项和值运行 Transporter。

• Transporter 示例：提供如何使用 Transporter 选项和值的详细示例。

• Transporter 信息：列出在使用 Transporter 时可能遇到的错误代码和信息。

• 更多资源：提供本指南涉及的术语解释、采用的记法约定、命令行 help 选项的使用帮助，以及常见问题解答和故障排除建议，以协助你诊断并解决可能遇到问题。

此外，还提供了修订历史供你参考。

【注】由于 Apple 会定期发布其软件的新版本和更新，因此本指南中所示的图像和输出可能与你在屏幕上看到的有所不同。

• macOS 10.11 或更高版本（64 位系统）

• Microsoft Windows 8、10、11 或更高版本（64 位系统）

• Red Hat Enterprise Linux（64 位系统）

安装和运行 Transporter 需要：

• 150 兆字节（MB）的可用磁盘空间和 2 GB 的 RAM

• 2048 MB 最大堆栈内存（默认情况下）

Transporter 使用面向服务的架构（SOA）收发数据和信息。它使用 HTTPS 协议与 Apple 的对象存储（HTTP）服务器进行通信。如果遇到问题，请联系你的 Apple 技术顾问。如果你使用的是 Signiant，Transporter 会使用传输控制协议／互联网协议（TCP／IP）和用户数据报协议（UDP）与 Signiant 服务器通信。如果你使用的是 Aspera，则除了使用 TCP／IP 和 UDP 之外，Transporter 还会使用 SSH 协议与 Aspera 服务器进行通信。

Transporter 可与下表所列的服务器通信。表中还提供了有关服务器的详细信息。默认情况下，若要使用 Transporter，只需通过端口 443 与 Apple 的 contentdelivery.itunes.apple.com 服务器进行通信。备注为“仅 Aspera”的服务器只适用于 Aspera 交付方法。当你使用 Aspera 交付方法时，必须另外打开“仅 Aspera”服务器。与 Aspera 服务器进行通信需要使用端口 33001。备注为“仅 Signiant”的服务器只适用于 Signiant 交付方法。当你使用 Signiant 交付方法时，必须另外打开“仅 Signiant”服务器。与 Signiant 服务器进行通信需要使用端口 44001。如果你建立了出站和入站防火墙规则，则必须针对相应的端口开放入站和出站连接。

若要使用 Aspera 或 Signiant 交付方法，你需要执行其他安装和配置步骤。有关更多信息，请参见使用 Upload 模式中的 Aspera 和 Signiant 示例。

• 先完成认证过程，再将内容交付到 Apple Books。

• 交付符合格式要求的素材。请参见图书格式要求和有声书格式要求。

• 使用最新版本的 Transporter，并遵循最新版本的 Apple Books Book Package Specification（《Apple Books 图书数据包规范》）、Apple Books Asset Guide（《Apple Books 素材指南》）和 Audiobooks Specification（《有声书规范》）。

• 存储 Transporter 的交付日志（使用 eXtreme 级信息）。如果你需要 Apple 提供交付帮助，日志是必不可少的。

你可以使用不同的模式、选项和值来运行 Transporter。然而，并不是所有模式都适用于发行商。请通过下表来了解与图书内容最相关的模式。

• 在交付视频内容前通过资格认证并获得编码工作室账户。

• 仅交付可接受的电影格式（请参见《iTunes 视频和音频素材指南》中的“影片内容描述文件”一章，以及在《iTunes 视频和音频素材指南》中的“电视内容描述文件”一章）。

• 使用最新版本的 Transporter，并遵循最新版本的 iTunes Package Film Specification（《iTunes 数据包电影规范》）、iTunes Package TV Specification（《iTunes 数据包电视节目规范》）和《iTunes 视频和音频素材指南》。

• 存储 Transporter 的交付日志（使用 eXtreme 级信息）。如果你需要 Apple 提供交付帮助，日志是必不可少的。

你可以使用不同的模式、选项和值来运行 Transporter。然而，并不是所有模式都适用于视频编码工作室。请使用下表来了解与视频内容最相关的模式。

• 在交付音乐内容前通过资格认证并获得一个编码工作室账户。

• 仅交付可接受的音乐格式（请参见《iTunes 视频和音频素材指南》中的“音乐音频内容描述文件”）。

• 使用最新版本的 Transporter，并遵循最新版本的《iTunes 数据包音乐规范》和《iTunes 视频和音频素材指南》。

• 存储 Transporter 的交付日志（使用 eXtreme 级信息）。如果你需要 Apple 提供交付帮助，日志是必不可少的。

你可以使用不同的模式、选项和值来运行 Transporter。然而，并不是所有模式都适用于音乐合作伙伴。请通过下表来了解与音乐内容最相关的模式。

• 仅交付可接受的 App 格式。

• 使用最新版本的 Transporter 并遵循最新版本的《App 元数据规范》。

• 在 Xcode 或 Application Loader 程序中使用 Transporter，或者手动下载和安装 Transporter。有关更多信息，请参见下面的 App 开发者的安装说明。

• 存储 Transporter 的交付日志（使用 eXtreme 级信息）。如果你需要 Apple 提供交付帮助，日志是必不可少的。

如果你用于登录 Transporter 的 Apple ID 关联了多个 App Store Connect 提供商，请务必使用 -asc_provider 指定要使用的提供商账户。你可以使用 Provider 模式来查看你有权限为哪些提供商账户交付内容。

你可以使用不同的模式、选项和值来运行 Transporter。然而，并不是所有模式都适用于 App 开发者。请通过下表来了解与 App 内容最相关的模式。

如只需获取使用信息，请勿在运行 Transporter 时使用任何命令行选项。例如，键入：

有关更多信息，请参见命令行帮助。

使用 Create Artist 模式时，必须指定以下命令行选项：

• -m createArtist

• -u<username>

• -p<password>

• -n<searchterm>

• -nativeLocale<nativelocalecode>

其他命令行选项如下（可选择性指定）：

• [-nameForSorting <sortingname>]

• [-forceCreateToken <forcecreationtoken>]

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

• [-outputFormat xml]

• [-escapeXML <true | false>]

在以下示例中，当 Transporter 执行完该命令后，由于不存在冲突艺人，会返回信息表明已创建名为“Jonny Doe”的艺人。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Create Artist 模式。

使用 Create Tickets 模式需要 iTunes Connect 账户。不支持通过编码工作室用户名和密码来使用 Create Tickets 模式。

使用 Create Tickets 模式时，必须指定以下命令行选项：

• -m createMetadataTicket

• -u<username>

• -p<password>

• -vendor_id <identifier> 或 -apple_id <identifier>

• -note<text>

其他命令行选项如下（可选择性指定）：

• [-itc_provider <shortname>]

• [-playlistGenre <newcode>] *

• [-playlistTitle <newtitle>] *

• [-playlistTitleTranslation <lang>:<translation>] *

• [-trackTitle <newtitle>] *

• [-trackTitleTranslation [<disc_number:>]<track_number>:<lang>:<translation>] *

• [-titleVersion <newtitle>] *

• [-trackTitleVersion <newtitle>] *

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

 App 开发者不能使用 Create Tickets 模式。

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回为标准错误，还会返回信息显示是否已成功创建更改专辑名称的元数据问题票单。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Create Tickets 模式。

运行 Diagnostic 模式时，Transporter 会根据你指定的 -t <transport> 值测试 Web 服务以及不同的主机和端口。因此，请指定传输选项和值（HTTP、Aspera、Signiant）以确保系统对相应的传输方式进行诊断。如果你指定了多个值（例如 -t HTTP,Aspera,Signiant），Transporter 将根据你指定的每个传输方式逐一检查 Web 服务及服务器的状态和可用性。

如果你未指定传输选项和值，Transporter 将使用自动传输发现来决定最适合你数据包的传输方式。目前，Transporter 默认 HTTP 为最佳传输方式。如果无法使用指定的传输方式（例如出现错误或服务器不可用），Transporter 将根据传输偏好顺序选择另一种传输方式。Transporter 将持续尝试其他传输方式。如果所有传输方式均无法使用，交付便会失败。你可以指定交付方法的偏好顺序，并用逗号（,）进行分隔，例如：-t HTTP,Aspera,Signiant。如果你仅指定一种传输方式（如 -t Aspera），则 Transporter 只会尝试该传输方式。如果该方式不可用，则诊断检查失败，并且没有回退选项。

如果你未指定用户名或密码，Transporter 将执行基本的诊断测试（例如，测试 TCP 连接性）。如果你指定了用户名和密码，Transporter 将执行增强的诊断测试（例如，Transporter 可以更准确地测试 TCP 和 UDP 与 Signiant 服务器和 Aspera 服务器的连接性）。

如果所有传输诊断失败，Transporter 则会在摘要信息中记录失败的原因。

使用 Diagnostic 模式时，必须指定以下命令行选项：

• -m diagnostic

• -t<transport>

其他命令行选项如下（可选择性指定）：

• [-u <username>]

• [-p <password>]

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回到控制台，还会返回有关 Web 服务以及你的电脑与 Aspera 服务器之间任何网络连接问题的诊断信息。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见以下章节：

• Transporter 的组件中发现了安全隐患。

• Transporter 需要更新 Java 虚拟机版本。

• 你在 Docker 镜像中运行 Transporter，但镜像不会自动更新到最新版本的 Transporter。

• 你希望快速将 Transporter 下载到新设备上。

默认情况下，Download Installer 模式会根据当前设备的构架和操作系统下载 Transporter 安装程序，并将其存储在当前目录。你也可以使用相应的命令行选项更改操作系统、设备构架或存储目录。

此模式还会针对所下载的安装程序版本显示安装说明。

使用 Download Installer 模式时，请指定以下命令行选项：

• -m downloadInstaller

其他命令行选项如下（可选择性指定）：

• [-arch <x86_64 | arm64 | aarch64>]

  指定安装程序的设备架构。有效值：x86_64、arm64、aarch64。

  如果省略此选项，则默认为当前设备的构架。

• [-destination<path>]

  指定安装程序的存储目录。

  如果省略此选项，则默认下载至当前目录。

• [-os <macOS | Linux | Windows>]

  指定安装程序的操作系统。有效值：macOS、Linux、Windows。

  如果省略此选项，则默认为当前设备的操作系统。

以下 JSON 输出示例中的 "id" 表示公共标识符。数组中的日期是具有时区偏移量的日期时间，按照 ISO-8601 格式列出：YYYY-MM-DDThh:mm:ssTZD，例如 2023-04-23T04:55:36-07:00。

使用 Get Asset List 模式时，必须指定以下命令行选项：

• -m getAssetList

• -u<username>

• -p<password>

• -s <shortname> 或 -itc_provider<shortname>

  请使用 -s 指定编码工作室提供商的简称，或使用 -itc_provider 指定 iTunes Connect 提供商的简称。

• -assetType"audiobook"

  只支持素材类型 "audiobook"。

• -startDate <date> 或 <timestamp>

  指定以下任一项：

  • 开始日期 <date>，使用 ISO-8601 格式 YYYY-MM-DD。指定日期时，系统会根据你的时区，将日期转换成具有时区偏移量的日期时间戳，且时间设置为 00:00:00。详情请参见指定选项和值中的 -startDate 选项。

  • 开始时间戳 <timestamp>，使用 ISO-8601 格式 YYYY-MM-DDThh:mm:ssTZD 或 ISO_ZONED_DATE_TIME。指定开始时间戳，以免处理重复内容。

其他命令行选项如下（可选择性指定）：

• [-endDate <date> 或 <timestamp>]

  指定以下任一项：

  • 结束日期 <date>，使用 ISO-8601 格式 YYYY-MM-DD。指定日期时，系统会根据你的时区，将日期转换成具有时区偏移量的日期时间戳，且时间设置为 23:59:59。详情请参见指定选项和值中的 -endDate 选项。

  • 结束时间戳 <timestamp>，使用 ISO-8601 格式 YYYY-MM-DDThh:mm:ssTZD 或 ISO_ZONED_DATE_TIME。

  若未指定 -endDate 选项，则输出的数组将包含自指定开始日期以来修改的所有素材文件。

• [-jsonFile]<output>

  系统会将 JSON 格式的数组写入指定的文件。如果文件已经存在，则会被覆盖。

  若未指定此项，则 JSON 格式的数组将执行标准输出。

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

请注意：

• 如需按计划系统性地下载素材，建议记录好最近下载素材的 lastUpdatedDate 值，然后使用该日期作为下次下载的开始日期。

• 由于经过加密，JSON 格式的素材数组中列出的文件大小可能与实际文件大小不同。请勿根据文件大小来判断文件是否更新，应根据 lastUpdatedDate 值。

JSON 输出示例

使用 List Reports 模式时，必须指定以下命令行选项：

• -m listReports

• -u<username>

• -p<password>

其他命令行选项如下（可选择性指定）：

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回为标准错误，还会返回过去 30 天该提供商所有产品报告的列表。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 List Reports 模式。

使用 List Report Types 模式时，必须指定以下命令行选项：

• -m listReportTypes

• -u<username>

• -p<password>

其他命令行选项如下（可选择性指定）：

• [-o  <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回为标准错误，还会返回可供提供商使用的报告类型的列表。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见电视节目提供商可用的报告类型和 App 开发者可用的报告类型。

• 名称、Apple 标识符、主要类型、语言和创建日期

• 作品名称（音乐艺人最近发布的至多 5 张专辑或 5 首歌曲，或电影艺人最近发布的至多 5 部影片）

• 作品的 Apple 标识符和内容提供商

• 艺人名称本地化、角色和 Store 网址（URL）（仅在 XML 输出中显示）

• 是否有独家提供商（只适用于音乐艺人和图书作者）

使用 Lookup Artist 模式时，必须指定以下命令行选项：

• -m lookupArtist

• -u<username>

• -p<password>

• -n <searchterm> 或 -apple_id <identifier>

其他命令行选项如下（可选择性指定）：

• [-searchLocale <localecode>]

• [-artistType <Music | Movie | Author>]

• [-outputFormat xml]

• [-escapeXML <true | false>]

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

在下面的示例中，当 Transporter 执行完命令时，会向控制台返回信息，包含与所指定搜索条件相符的艺人的名称、类型、Apple 标识符和语言。Transporter 会以 XML 格式返回输出信息。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Lookup Artist 模式、针对音乐艺人的 Lookup Artist 模式（显示 XML 输出）、针对电影艺人的 Lookup Artist 模式和针对图书作者的 Lookup Artist 模式。

使用 Lookup Metadata 模式时，你可以指定是按供应商标识符（-vendor_id）还是按 Apple 标识符（-apple_id）搜索元数据，Transporter 会向 Web 服务发送信息并在你指定的目录中生成元数据的存根数据包。你可以选择使用逗号分隔列表形式指定多个供应商标识符（-vendor_ids）或 Apple 标识符（-apple_id）来同时搜索多个数据包。

Transporter 检索当前元数据后，会创建存根数据包 <identifier_option_value>.itmsp 或 <app_SKU>.itmsp，其中包含一个 metadata.xml 文件，该文件包含由 Web 服务传递给 Transporter 的 XML 元数据。Transporter 会将存根数据包存储在你在 -destination 选项中指定的目录中。

如果适用，Transporter 还会在元数据中返回以下信息：

• 图案文件名信息：Transporter 包含类似如下的信息来提醒你在重新上传数据包之前替换你的图案和校验和文件名（如果需要）：“<!--NOTE: The file name 010058208723.jpg and its checksum may need to be changed to reflect their original values. Alternately, you may decide to remove this <album_artwork_files> block altogether to achieve a successful metadata-only upload.—>”。

• 质量控制编码信息：Transporter 包含类似如下的信息，为你提供素材的质量控制编码的网址（URL），以便你将问题与原始源进行比较并在重新上传数据包前修复所有问题：“<!--A quality control encode of this video was created. It may be downloaded at the following url: https://sample.apple.com/us/r10/Video/41/bd/1f/mzm.dijmlsrs.mov?downloadKey3=1243559291_23bae98151c8fe0dbfc054618993e0b5. Please note that the url will be available for 180 minutes.-->” 如果你要访问网址（URL）时网址已过期，请在 Lookup Metadata 模式下再次运行 Transporter，以获得新网址（URL）。

• Scratch 编码信息：Transporter 包含类似如下的信息，为你提供素材的 Scratch 编码的网址（URL），以便你在重新上传数据包前确认素材的同步情况：“<!--A scratch encode of this video was created. It may be downloaded at the following url: https://sample.apple.com/us/r10/Video/41/bd/1f/mzm.dijmlsrs.mov?downloadKey3=1243559291_23bae98151c8fe0dbfc054618993e0b5. Please note that the url will be available for 180 minutes.-->” 如果你要访问网址（URL）时网址已过期，请在 Lookup Metadata 模式下再次运行 Transporter，以获得新网址（URL）。

• 元数据令牌信息：Transporter 会将 <metadata_token> 元素放在 <package> 元素之后，以帮助 Apple 确定你上次使用 Lookup Metadata 模式检索之前上传的专辑或 App 的当前元数据的时间。例如：

  <package xmlns="http://apple.com/itunes/importer/publication" version="publication5.0"> <metadata_token>1405704088101-ae534236053dbb0b082dd6319857a403bce91396e5753fa6ff70f8b3047609fc</metadata_token>

  你不应编辑 <metadata_token> 元素中的任何信息。

【注】如果你更改了素材（例如，图案文件、音频文件、视频文件、EPUB 文件等）的文件名、大小或校验和，则必须提供与更新的文件名、大小和校验和匹配的新素材文件。

使用 Lookup Metadata 模式时，必须指定以下命令行选项：

• -m lookupMetadata

• -u<username>

• -p<password>

• -destination<path>

• -vendor_id <identifier> | -vendor_ids <"identifier,identifier,identifier"> | -apple_id <identifier> | -apple_ids <"identifier,identifier,identifier">

其他命令行选项如下（可选择性指定）：

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-app_platform <osx | ios | appletvos>]

• [-o <output>]

• [-outputType <metadata_only | asset_only | metadata_plus_assets>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

• [-subitemtype <None | GameCenterLeaderboard |GameCenterAchievement>] 或 [-subitemids]

• [-umc_catalog_id <identifier>]

• [-umc_content_id <identifier>]

• [-umc_variant_id <identifier>]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回为标准错误，还会创建包含 4463953 专辑当前元数据的存根数据包，并将其存储到 /tmp/packages 目录。

使用 -subitemtype 和 -subitemids 来查找子项。例如，你可以查找以下子项的元数据：

• 使用 -subitemtype GameCenterLeaderboard -subitemids com.mycompany.Leaderboard01,com.mycompany.Leaderboard02 命令查找两个特定 Game Center 排行榜的元数据；

• 使用 -subitemtype GameCenterAchievement -subitemids com.mycompany.Achievement01,com.mycompany.Achievement02 命令查找两个特定 Game Center 成就的元数据。

如需查询订阅视频的元数据，请指定其 UMC 目录 ID（-umc_catalog_id）、内容 ID（-umc_content_id）和版本 ID（-umc_variant_id）。

• -umc_catalog_id 选项用于指定目录 ID。你可以多次指定此选项的值。如果你只指定了一次，则系统默认将该值应用于所有内容 ID 和版本 ID；如果你指定了多次，则指定的次数必须与内容 ID 和版本 ID 的数量相匹配。

• -umc_content_id 选项用于指定内容 ID。如果你指定了多次内容 ID，则指定的次数必须与版本 ID 的数量相匹配。

• -umc_variant_id 用于指定版本 ID。如果你指定了多次版本 ID，则指定的次数必须与内容 ID 的数量相匹配。

以下是指定单个订阅视频的示例：

以下是指定多个订阅视频的示例：

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Lookup Metadata 模式（单个 Store 数据包）和 Lookup Metadata 模式（多个 Store 数据包）。

使用 Provider 模式时，必须指定以下命令行选项：

• -m provider

• -u<username>

• -p<password>

其他命令行选项如下（可选择性指定）：

• [-account_type <encoding_house | itunes_connect>]

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回到控制台，还会列出你有权为哪些提供商交付内容：

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Provider 模式。

使用 Query Tickets 模式时，必须指定以下命令行选项：

• -m queryTickets

• -u<username>

• -p<password>

其他命令行选项如下（可选择性指定）：

• [-s <shortname>]

• [-itc_provider<shortname>]

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-vendor_id<identifier>] 或 [-apple_id<identifier>]

要限制返回的问题票单的数量，请指定 -vendor_id 或 -apple_id。Transporter 仅会返回与指定 ID 关联的问题票单。

注：如果你是编码工作室用户，则未经 Apple 事先授权，不得使用该模式。有关更多信息，请联系你的 Apple 技术顾问。

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回为标准错误，还会返回有关你仍然需要关注的所有尚未解决的 iTunes 问题票单的信息。Transporter 会以 XML 格式返回输出信息。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Query Tickets 模式。

Repair Assets 模式无法修改现有的 Store 数据包。使用 Repair Assets 模式修复你的素材文件后，必须使用已修复的新素材文件替换 Store 数据包中当前未修复的素材文件，并相应地更新 XML 元数据文件（metadata.xml）。

Apple 当前仅支持 EPUB 文件（.epub）修复。

使用 Repair Assets 模式时，请注意：

• -assetFile 选项必须包含具有相应文件扩展名（.epub）的文件。

• -assetFolder 目录和 -destination 目录不能相同。

• -assetFile 父目录和 -destination 目录不能相同。

• 如果你使用 -assetFolder，Transporter 仅会修复目录中具有相应文件扩展名（.epub）的文件。

• Transporter 使用与原始文件相同的文件名将修复的文件存储到目标目录中。

使用 Repair Assets 模式时，必须指定以下命令行选项：

• -m repairEpubAssets

• -assetFolder <path> 或 -assetFile <path>

• -destination<path>

其他命令行选项如下（可选择性指定）：

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-removeUnmanifestedFiles]

此模式仅对发行商有效，App 开发者不可使用 Repair Assets 模式。

在以下示例中，当 Transporter 执行完命令后，会显示信息以说明 /tmp/epub 目录中的哪些文件已修复并存储在目标目录（/tmp/epub/repair/）中，还会显示已修复文件的校验和信息，以及 eXtreme 级日志信息。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Repair Assets 模式。

如果你在过去 24 小时内请求了报告，并且该报告可供下载，Transporter 会立即将其下载到指定目录。如果你在过去 24 小时内请求了报告，但该报告不可下载，Transporter 会显示状态信息，提示该报告不可下载。另外，如果你在过去 24 小时内未请求报告，Transporter 会创建新报告请求。

使用 Request Report 模式时，必须指定以下命令行选项：

• -m requestReport

• -u<username>

• -p<password>

• -destination<path>

• -type<type>

其他命令行选项如下（可选择性指定）：

• [-reportDate <date>]

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回为标准错误，还会返回过去 30 天该提供商的所有产品报告。如果适用，Transporter 会将报告存储在 /tmp/RequestReport/ 目录中。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Request Report 模式。

Retrieve Asset 模式会把每个素材文件和关联的元数据下载到输出目录。有关输出路径，请查看 -destination 选项的说明。

【注】Transporter 会检查目标目录的文件系统是否有足够的可用磁盘空间来写入所有请求的文件，包括与之相关的额外开销。开销大小相当于要下载的最大文件。素材会先写入加密文件，然后逐一解密。写入解密文件后，系统将删除加密文件。

使用 Retrieve Asset 模式时，必须指定以下命令行选项：

• -m retrieveAsset

• -u<username>

• -p<password>

• -s <shortname> 或 -itc_provider <shortname>

  请使用 -s 指定编码工作室提供商的简称，或使用 -itc_provider 指定 iTunes Connect 提供商的简称。

• -assetType"audiobook"

  只支持素材类型 "audiobook"。

• -vendor_id <identifier>、-vendor_ids<”identifier,identifier,identifier”> 或 -vendor_id_file<path>

  -vendor_id：用于指定内容提供商的一个供应商标识符。

  -vendor_ids：用于指定内容提供商的多个供应商标识符，用逗号分隔，并用引号括起所有标识符。

  -vendor_id_file：用于指定一个包含多个供应商标识符的文件，每个标识符占一行。

• -public_id <identifier>、-public_ids<”identifier,identifier,identifier”> 或 -public_id_file<path>

  -public_id：用于指定内容提供商的一个公共标识符。

  -public_ids：用于指定内容提供商的多个公共标识符，用逗号分隔，并用引号括起所有标识符。

  -public_id_file：用于指定一个包含多个公共标识符的文件，每个标识符占一行。

  请注意：

  •  Get Asset List 模式返回的 JSON 格式数组中包含一个 "id" 值。"id" 值可用于 Retrieve Asset 模式的 <identifier>。

  • 公共标识符选项比供应商标识符选项更有效，因为公共标识符减少了中间调用 Web 服务的次数。

• -destination<path>

  <path> 用于指定下载素材的最上层目录。完整路径的格式如下：

  文件夹：<path>/<identifier>.<asset-type>，其中 <identifier> 是供应商标识符。

  • 示例：<path>/9781728280660.audiobook/

  元数据：<path>/<identifier>.<asset-type>/metadata.json，其中 <identifier> 是供应商标识符。

  • 示例：<path>/9781728280660.audiobook/metadata.json

  素材：<path>/<identifier>.<asset-type>/<asset-file>.<ext>，其中 <identifier> 是供应商标识符。

其他命令行选项如下（可选择性指定）：

• [-includeCoverArt]

  若未指定 -includeCoverArt，则默认不下载封面图。

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

在提交 XML 元数据之前，iTunes 建议你检查文件是否存在任何结构和格式错误。iTunes 会拒绝包含错误的文件，可能导致交付内容时出现延迟。iTunes 已选择 Relax NG（RNG）作为内容交付的 Schema 语言。要检查是否存在错误，你需要使用可验证 RNG Schema 的工具。

【注】Schema 文件是动态文件，并且通常在一个文件中包含多种 Schema 类型（例如，音乐或电视节目）。

使用 Schema 模式时，必须指定以下命令行选项：

• -m generateSchema

• -u<username>

• -p<password>

• -schema <typeversion> | “jp-itt-v2"

• -schemaType <transitional | strict>

其他命令行选项如下（可选择性指定）：

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-o <output>]

• [-destination <path>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回到控制台。Transporter 还会将 4.7 版 Store 数据包影片规范的 Transitional（过渡）Schema 文件返回到控制台。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Schema 模式。

使用 Status 模式时，你可以查看数据包状态以及你的数据包是否包含任何错误（例如，内部传输错误或导入错误）。你也可以查看数据包的供应商标识符或 Apple 标识符、内容状态信息（例如，Live、Other、Not Live、In Review）以及内容审核状态（例如，NotLive-WaitingForReview）。此外，对于所有内容类型（音乐、电视节目、图书、有声书、App 等），Transporter 将会显示：

• “Upload state（上传状态）”和“Upload state id（上传状态 ID）”字段，以说明你数据包的状态，包括：“Internal Transfer（内部传输）”、“Uploading（正在上传）”、“Ready to Import（准备导入）”、“Importing（正在导入）”、“Import Error（导入错误）”、“Imported（已导入）”或“Not to be Processed（不处理）”。

• “Content state（内容状态）”和“Content state id（内容状态 ID）”字段，以说明你的数据包在 iTunes Connect 中是处于“Polished（已修改）”还是“Unpolished（未修改）”状态。

• “On Store（已上架）”、“Ready For Store（准备上架）”和“Not On Store（未上架）”字段，以说明你的数据包在各个国家或地区的状态。对于每种状态，Transporter 会显示以逗号分隔的国家／地区代码列表或 N/A 列表。N/A 表示没有适用该状态的国家／地区。此状态信息不适用于应用程序或铃声。

• “Upload created（上传创建时间）”字段，提供 Transporter 上传数据包时的日期和时间。

数据包可能已成功上传到 Apple，但仍没有成功通过 Apple 的服务器端流程。Status 模式选项可以帮助你查看你的数据包在 Apple 流程中的状态。

如果你要请求包含电影或电视组件的数据包的状态信息，则 Status 模式除返回数据包状态外，还会返回组件状态信息。组件状态信息仅适用于电影或电视节目。例如，对于每个组件（视频、音频、完整字幕等），Transporter 会返回按组件类型标记的以下信息：

如果有组件被拒绝，Transporter 会返回信息以解释拒绝的原因。请参考以下示例：

如果你要请求包含应用程序或铃声的数据包的状态信息，则 Status 模式仅会返回上传和内容信息。Status 模式不支持提供应用程序和铃声的状态信息（已上架、准备上架和未上架）。

使用 Status 模式时，必须指定以下命令行选项：

• -m status 或 -m statusAll

• -u<username>

• -p<password>

• -vendor_id <identifier> | -vendor_ids <"identifier,identifier,identifier"> | -apple_id <identifier> | -apple_ids <"identifier,identifier,identifier">

其他命令行选项如下（可选择性指定）：

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

• [-outputFormat xml]

• [-umc_catalog_id <identifier>]

• [-umc_content_id <identifier>]

• [-umc_variant_id <identifier>]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息和供应商（00028947576600）最近上传的数据包的状态信息返回到控制台。

如需查询订阅视频的状态信息，请指定其 UMC 目录 ID（-umc_catalog_id）、内容 ID（-umc_content_id）和版本 ID（-umc_variant_id）。

• -umc_catalog_id 选项用于指定目录 ID。你可以多次指定此选项的值。如果你只指定了一次，则系统默认将该值应用于所有内容 ID 和版本 ID；如果你指定了多次，则指定的次数必须与内容 ID 和版本 ID 的数量相匹配。

• -umc_content_id 选项用于指定内容 ID。如果你指定了多次内容 ID，则指定的次数必须与版本 ID 的数量相匹配。

• -umc_variant_id 用于指定版本 ID。如果你指定了多次版本 ID，则指定的次数必须与内容 ID 的数量相匹配。

以下是指定单个订阅视频的示例：

以下是指定多个订阅视频的示例：

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Status 模式（音乐示例）、Status 模式（视频示例）和 StatusAll 模式。

当你测试数据包的传输性能时，Transporter 会创建测试数据包以利用现有的行为和统计信息。成功上传数据包后，Transporter 会显示该数据包的总传输时间和详细信息（-throughput）。如果上传失败，Transporter 会返回 informational 级别消息、警告或错误信息以指示问题。

默认情况下，无论你是否指定 -throughput 选项，Transporter 均会显示数据包的总传输时间和详细信息（-throughput）。

使用 Transfer Test 模式时，必须指定以下命令行选项：

• -m transferTest

• -u<username>

• -p<password>

• -k <kilobits_per_second>*

其他命令行选项如下（可选择性指定）：

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-o <output>]

• [-errorLogs <path>]

• [-t <transport>] **

• [-size <value>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-indicator <true | false>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回到控制台，同时返回 10 兆字节数据包的总传输时间和详细信息（-throughput）。上传过程中，Transporter 以 10000 Kbit／s 的限速将指定提供商的文件传输到 Signiant 服务器。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Transfer Test 模式。

除 macOS 外，你还可以使用 Linux 和 Windows 上传 App。你可以使用 -assetFile 或 -f。Linux 和 Windows 必须使用 -assetDescription 参数指定文件（即从 Xcode 导出的 AppStoreInfo.plist 文件）。有关生成该文件的信息，请参见“Archive export files（归档导出文件）”。

如果你在尝试上传内容时收到以下信息：“1023: Encoding house is not yet authorized to deliver content (verify mode only)”，这表示 Apple 尚未开启你的上传权限。请咨询你的 Apple 技术顾问，确保你已获得上传内容的权限。

Apple 建议你不要指定 -t transport，而是允许 Transporter 使用自动传输发现来决定最适合你数据包的传输方式。目前，Transporter 默认 HTTP 为最佳传输方式。如果你需要指定 -t transport，请尽快回退到自动传输发现模式。如果无法使用指定的传输方式（例如出现错误或服务器不可用），Transporter 将根据传输偏好顺序选择另一种传输方式。Transporter 将持续尝试其他传输方式。如果所有传输方式均无法使用，交付便会失败。你可以指定交付方法的偏好顺序，并用逗号（,）进行分隔，例如：-t HTTP,Aspera,Signiant。如果你仅指定了一个传输选项（-t Aspera），则 Transporter 只会尝试该传输方式。如果该方式不可用，则交付失败且没有回退选项。

Apple 建议每次向 iTunes Store、Apple Books 或 App Store 交付的 Store 数据包不超过 1000 个。

使用 Upload 模式时，必须指定以下命令行选项：

• -m upload

• -f <dir | pkg> 或 -assetFile <.ipa | .pkg>（用于在 macOS、Linux 和 Windows 系统中上传内容）

• -assetDescription AppStoreInfo.plist（在 Linux 和 Windows 中上传必须使用 -assetDescription）

• -u<username>

• -p<password>

• -k <kilobits_per_second> *

其他命令行选项如下（可选择性指定）：

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-asc_provider<shortname>]

• [-o <output>]

• [-summaryFile <output>]

• [-errorLogs <path>]

• [-eventFile <path>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-t <transport>]

• [-success <path>]

• [-failure <path>]

• [-throughput]

• [-loghistory <path>]

• [-delete]

• [-Xmx4096m]

• [-indicator <true | false>]

• [-WONoPause <true | false>]

• [-deleteFastTransportLog <true | false>] **

• [-assetReplacementVerification <true | false>]

• [-outputFormat xml]

• [-vp <text | json>]

Apple 当前仅支持 EPUB 文件（.epub）和 iBooks 格式文件（.ibooks）验证。

使用 Validate Assets 模式时，必须指定以下命令行选项：

• -m validateRawAssets

• -u<username>

• -p<password>

• -assetFolder <path> 或 -assetFile <path>

其他命令行选项如下（可选择性指定）：

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-success <path>]

• [-failure <path>]

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

此模式仅对发行商有效，App 开发者不可使用 Validate Assets 模式。

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回到控制台，包括有关 /tmp/assets 目录中的每个指定提供商的素材文件是否有效的信息。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Validate Assets 模式。

当你将数据包发送至 Apple 进行验证时，Transporter 会解析元数据文件，并验证该文件结构是否完整、数据（包括日期、产品等）是否正确。Transporter 还会验证你发送至 Apple 的所有素材（例如音频文件、视频文件、图书文件、App）。

使用 Verify 模式时，必须指定以下命令行选项：

• -m verify

• -f<dir | pkg>

• -u<username>

• -p<password>

其他命令行选项如下（可选择性指定）：

• [-s <shortname>]

• [-itc_provider <shortname>]

• [-disableAssetVerification]

• [-o <output>]

• [-summaryFile <output>]

• [-errorLogs <path>]

• [-eventFile <path>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

• [-outputFormat xml]

• [-vp <text | json>]

在以下示例中，当 Transporter 执行完命令后，会将 eXtreme 级日志信息返回到控制台，包括有关 /tmp/packages 目录中的每个指定提供商的数据包、文件、元数据和素材是否有效的信息。

有关更详细的示例，包括 Transporter 输出和日志信息，请参见 Verify 模式。

在以下示例中，用户 bob 在 Create Artist 模式下运行 Transporter，并指定 Transporter 创建姓名为“Juan Pérez”的新音乐艺人。

Transporter 返回信息，表示并未创建艺人“Juan Pérez”，因为该艺人现已存在。Transporter 还会返回一个 force-creation 令牌（"1d82c6f6-26ef-3e28-8a97-558c7c5717da"），你可以使用该令牌强制 Transporter 创建新的音乐艺人。

若要强制 Transporter 创建新的音乐艺人，请添加 -forceCreateToken "1d82c6f6-26ef-3e28-8a97-558c7c5717da" 至命令：

Transporter 返回信息，表示艺人“Juan Pérez”已创建。

Transporter 返回信息，表示已成功创建元数据问题票单，并显示 eXtreme 级日志信息。

Transporter 会返回过去 30 天该提供商的所有产品报告的列表，并显示 eXtreme 级日志信息。

在本示例中，Transporter 显示请求日期（03/21/2013 12:11 PDT）、请求该报告的用户的名称（bob）、内容类型（电视节目）以及报告请求成功的状态（Succeeded）。

当 Transporter 执行完命令后，会显示一个列表，其中包含 bob 有权交付内容的提供商的长名称和简称，但不会显示任何其他日志信息。

在本示例中，bob 有权为一位提供商交付内容：Apple Computer（长名称）、Apple（简称）。为该提供商上传素材时，可以将简称（Apple）与 -s 选项一起使用。

Transporter 会返回有关仍然需要关注的所有待解决的 iTunes 问题票单的信息，并显示 eXtreme 级日志信息。

在本示例中，Transporter 显示了 2 个尚未解决的问题票单（ticketId=97202 和 ticketId=135986）的信息，并提供有关所需操作的详细信息：“The wrong cover art has been submitted for this album.（为该专辑提供的封面图有误。）”和“Wrong cover art. Album title and artist name do not match.（封面图有误。专辑名称与艺人名称不匹配。）”。

Transporter 会尝试修复 unmanifested.epub EPUB 文件，从你的 EPUB 文件中移除未列入清单的文件，并将修复的文件存储在 /tmp/repairEpubAssetsUnmanifested/ 目录中。当 Transporter 执行完命令后，会显示是否可以修复该文件。

在本示例中，Transporter 修复了 unmanifested.epub EPUB 文件。Transporter 显示修复的文件路径（/tmp/repairEpubAssetsUnmanifested/unmanifested.epub）和校验和 （8dd1e064ae5cdde7b1b3c8d766db92ee）。

Transporter 会将过去 30 天该提供商的所有产品报告下载到 /tmp/ 目录中，并显示 eXtreme 级日志信息。

在本示例中，Transporter 显示已将以下产品报告下载到 /tmp/ 目录：Apple_TV.ljjwjfgf.zip 和 Apple_TV.ljjwjfgf.zip。

Transporter 会返回 4.7 版 Store 数据包影片规范的 Transitional（过渡）Schema 文件，并显示 eXtreme 级日志信息。

在本示例中，Transporter 将 Transitional（过渡）Schema 文件存储为 /tmp/schema/film4.7-transitional.rng。

Transporter 使用 10000 Kbit/s 限制速度将 10 兆字节的数据包上传至 Signiant 服务器，它会显示数据包元数据、总传输时间、详细信息（-throughput）以及 eXtreme 级日志信息。Transporter 执行完命令后，会显示信息说明文件是否成功上传。

在本示例中，Transporter 显示已成功上传一个 10 兆字节的数据包（APPLE2812F6A232B944FD91CCA2C10A1F0C8C.itmsp），总传输时间为 15839（[2014-03-14 12:30:51 PDT] <main> DBG-X: parameter TransferTime = 15839），Transporter 还会显示成功上传数据包的摘要吞吐量信息（0 分钟，15.84 秒，10.01 MB，647.01 KB/s）。