處理書籍、影片、音樂或 App 內容時，無論你使用的是 iTunes Connect 帳號（書籍出版商、音樂供應商）、App Store Connect 帳號（App 開發者）或編碼公司帳號，你都可以使用 Transporter 來驗證商店套件是否符合 Apple 的規格，藉此確保音訊、影片、書籍和 App 檔案等素材及後設資料正確傳送到 Apple。由於有些 Transporter 選項會因使用者類型和內容類型而受到限制，因此在你傳送商店套件之前，請先確定是否要讓 Transporter 使用 iTunes Connect 或 App Store Connect 帳號或編碼公司帳號來對你進行身分驗證。如需更多資訊，請參閱概覽。

Transporter 包括下列功能：

• 簡單易用的現成安裝套件，包括適用於 macOS、Microsoft Windows 和 Red Hat Enterprise Linux 的安裝程式。

• 素材追蹤功能。Transporter 會比對你實際傳送的檔案來驗證你在後設資料檔案中參照的素材列表（例如封面圖、音訊檔案、影片檔案、App 內購買項目、Game Center）。

  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 版本、視需要更新你安裝的軟體，並在主控台顯示記錄資訊。

• 對素材進行核對碼驗證。在你要傳送的後設資料檔案中，你應該包含所傳送的每個檔案的核對碼。Transporter 會使用核對碼資訊，比對 Transporter 算出的核對碼來驗證你傳送的每個檔案。

• 錯誤摘要輸出。Transporter 會顯示未成功上傳的商店套件的錯誤摘要資訊。除了未成功上傳的套件名稱列表外，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 11 或以上版本（64 位元系統）。

• Red Hat Enterprise Linux（64 位元系統）。

若要安裝並執行 Transporter，你要有：

• 150MB 可用磁碟空間和 2GB RAM。

• 依預設，最大為 2048MB 的堆積大小。

Transporter 使用服務導向架構（SOA）來傳送和接收資料及訊息，並透過 HTTPS 通訊協定來與 Apple 的物件儲存（HTTP）伺服器進行通訊。如果有任何問題，請聯絡你的 Apple 技術代表。如果你使用 Signiant，Transporter 會透過傳輸控制通訊協定/網際網路通訊協定（TCP/IP）和使用者資料包通訊協定（UDP）與 Signiant 伺服器進行通訊。如果你使用 Aspera，除了使用 TCP/IP 與 UDP 之外，Transporter 還會使用 SSH 通訊協定與 Aspera 伺服器進行通訊。

下表列出關於 Transporter 能夠通訊的伺服器的詳細資訊。依預設，若要使用 Transporter，你只需要連接埠 433 就能與 Apple 的 contentdelivery.itunes.apple.com 伺服器通訊。當你使用 Aspera 傳送方法時，你只能使用「僅限 Aspera」伺服器，且必須打開額外的「僅限 Aspera」伺服器。與 Aspera 伺服器進行通訊時，需要使用連接埠 33001。當你使用 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。然而，並非所有模式都適用於出版商。請透過下表來瞭解與書籍內容最相關的模式。

• 先通過資格認證並獲得一個編碼公司帳號，才能傳送影片內容。

• 僅限傳送可接受的電影格式。請參閱 Apple 影片和音訊素材指南中的「影片內容描述檔」章節，以及 Apple 影片和音訊素材指南中的「電視內容描述檔」章節。

• 使用最新版的 Transporter、Apple Transactional Film Specification（Apple 影片傳輸處理規格）、Apple Transactional TV Specification（Apple 電視傳輸處理規格）以及 Apple 影片和音訊素材指南。

• 儲存 Transporter 傳送記錄（使用 eXtreme 詳細程度）。如果你需要向 Apple 請求傳送作業方面的協助，必須提供記錄。

你可以使用多種模式、選項和值來執行 Transporter。然而並非所有模式都適用於影片編碼公司。請透過下列表格來瞭解與影片內容最相關的模式。

• 先通過資格認證並獲得一個編碼公司帳號，才能傳送音樂內容。

• 僅限傳送可接受的音樂格式。請參閱 Apple 影片和音訊素材指南中的「音樂音訊內容描述檔」章節。

• 使用最新版的 Transporter、Apple Music 規格和 Apple 影片和音訊素材指南。

• 儲存 Transporter 傳送記錄（使用 eXtreme 詳細程度）。如果你需要向 Apple 請求傳送作業方面的協助，必須提供記錄。

你可以使用多種模式、選項和值來執行 Transporter。然而，並非所有模式都適用於音樂夥伴。請透過下表來瞭解與音樂內容最相關的模式。

使用 Transporter 的 App 開發者必須：

• 傳送 IPA 檔案（.ipa）（iOS、tvOS 和 visionOS App），或 PKG 套件檔案（.pkg）（macOS App）。

• 使用最新版的 Transporter。

• 手動下載並安裝 Transporter。如需更多資訊，請參閱下方的 App 開發者安裝。

• 儲存 Transporter 傳送記錄（使用 eXtreme 詳細程度）。如果你需要向 Apple 請求傳送作業方面的協助，必須提供記錄。

如果你用來登入 Transporter 的 Apple 識別碼與超過一個 App Store Connect 供應商相關聯，你就必須使用 -asc_provider 指定要用於目前階段作業的供應商帳號。你可以使用 provider 模式來取得你有權限傳送內容的供應商帳號的列表。

你可以使用多種模式、選項和值來執行 Transporter。然而，並非所有模式都適用於 App 開發者。請透過下表來瞭解與 App 內容最相關的模式。

如果只要獲得使用資訊，執行 Transporter 時不用任何命令列選項。例如輸入：

如需更多資訊，請參閱命令列輔助說明。

除了 macOS，asset pack status 模式也支援 Linux 和 Windows。此模式支援兩種格式：

• 格式 1：指定素材包版本識別碼。

• 格式 2：指定 App 的 Apple 識別碼和素材包的開發者識別碼。

格式 1：你必須指定以下命令列選項：

• -m assetPackStatus

• -assetPackVersionId <id>

• -u <username>

• -p <password>

• -asc_provider <shortname>（須經使用者名稱和密碼驗證）

格式 2：你必須指定以下命令列選項：

• -m assetPackStatus

• -apple_id <id>（App 的 Apple 識別碼）

• -assetPackId <id>（此素材包的開發者識別碼；Linux 和 Windows 上傳作業必須提供 -assetPackId）

• -version <string>（此素材包的版本字串）

• -u <username>

• -p <password>

• -asc_provider <shortname>（須經使用者名稱和密碼驗證）

範例：格式 1

範例：格式 2

在 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 模式。

你必須擁有 iTunes Connect 帳號才能使用 create tickets 模式。你不能以編碼公司的使用者名稱密碼來使用 create tickets 模式。

在 create tickets 模式中，你必須指定以下命令列選項：

• -m createMetadataTicket

• -u <username>

• -p <password>

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

• -note <text>

• [-itc_provider<shortname>]

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

你也可以選擇指定下列其他的命令列選項：

• [-playlistGenre <newcode>]

• [-playlistTitle <newtitle>]

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

• [-trackTitle <newtitle>] *

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

• [-titleVersion <newtitle>]

• [-trackTitleVersion <newtitle>]

• [-o <output>]

如果你是 App 開發者，就不能使用 create tickets 模式。

在以下範例中，當 Transporter 執行命令完畢後，就會傳回 eXtreme 記錄資訊至標準錯誤，以及是否成功建立後設資料工作單以變更播放列表標題的相關資訊。

如需更詳細的範例（包含 Transporter 的輸出與記錄資訊），請參閱 create ticket 模式。

當你以 diagnostic 模式執行時，Transporter 會根據你指定的 -t <transport> 值來測試網頁服務和不同的主機與連接埠。請指定傳輸選項和值（HTTP、Aspera、Signiant）來執行正確診斷。如果你指定了多個值（例如 -t HTTP,Aspera,Signiant），Transporter 就會針對你指定的各個傳輸模式，檢查網頁服務以及伺服器的狀態與可用性。

如果你未指定傳輸選項和值，Transporter 會使用自動傳輸尋找模式來決定你套件的最佳傳輸模式。目前 Transporter 預設 HTTP 為最佳傳輸模式。如果因為錯誤或伺服器不可用而無法使用指定的傳輸模式，Transporter 會根據傳輸模式的偏好順序來選擇其他傳輸模式。Transporter 會選擇其他傳輸方式，直到耗盡所有可用的傳輸選項為止，這時傳送作業會失敗。你可以依照所需的順序來指定傳送方法（中間以逗號（,）區隔。例如 -t HTTP,Aspera,Signiant）。如果你僅指定一個傳輸選項（-t Aspera），Transporter 只會使用該選項。如果這個選項失敗，診斷檢查就會因為沒有備用選項而失敗。

如果你未指定使用者名稱或密碼，Transporter 會執行基本的診斷測試（例如測試 TCP 連線）。如果你指定了使用者名稱與密碼，Transporter 就會執行增強的診斷測試（例如 Transporter 可以更精確測試 Signiant 和 Aspera 伺服器的 TCP 與 UDP 連線）。

若所有傳送診斷均失敗，Transporter 會將失敗的理由登錄在摘要資訊中。

在 diagnostic 模式中，你必須指定以下命令列選項：

• -m diagnostic

• -t <transport>

你也可以選擇指定下列其他的命令列選項：

• [-u <username>]

• [-p <password>]

• [-o <output>]

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

• [-Xmx4096m]

• [-WONoPause <true | false>]

於以下範例，Transporter 執行完命令後，會傳回 eXtreme 記錄資訊到控制台，以及有關網路服務和任何你的電腦與 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 assets pack 模式中，你必須指定以下命令列選項：

• -m listAssetPacks

• -apple_id <id>（App 的 Apple 識別碼）

• -u <username>

• -p <password>

• -asc_provider <shortname>（須經使用者名稱和密碼驗證）

範例

在 list asset pack versions 模式中，你必須指定以下命令列選項：

• -m listAssetPackVersions

• -apple_id <id>（App 的 Apple 識別碼）

• -assetPackId <id>（此素材包的開發者識別碼；Linux 和 Windows 上傳作業必須提供 -assetPackId）

• -u <username>

• -p <password>

• -asc_provider <shortname>（須經使用者名稱和密碼驗證）

範例

在 list reports 模式中，你必須指定以下命令列選項：

• -m listReports

• -u <username>

• -p <password>

你也可以選擇指定下列其他的命令列選項：

• [-o <output>]

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

• [-WONoPause <true | false>]

• [-outputFormat xml]

在以下範例中，當 Transporter 執行命令完畢，就會傳回 eXtreme 記錄資訊至標準錯誤，以及列出供應商的所有可用報告。

如需更詳細的範例（包含 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 的輸出與記錄資訊），請參閱適用於電視供應商的報告類型與適用於書籍供應商的報告類型。

• 名稱、Apple 識別碼、主要類型、地區設定和建立日期。

• 作品（音樂藝人最多五張最新發行的專輯或歌曲，或電影藝人最多五部最新發行的電影）。

• 作品的 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，就會針對該後設資料在你指定的目錄中產生一個虛設常式套件。你能在逗號分隔的列表中指定多個廠商識別碼（-vendor_ids）或 Apple 識別碼（-apple_id），來選擇要一次搜尋多個套件。

Transporter 擷取目前的後設資料之後，就會建立一個虛設常式套件 <identifier_option_value>.itmsp 或 <app_SKU>.itmsp（由單一的 metadata.xml 檔案組成），內含以網頁服務傳給 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。

• 初步編碼資訊。Transporter 會納入類似下方的訊息，以提供你素材初步編碼的 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 模式擷取先前上傳的播放列表的目前後設資料。例如：

  <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>]

• [-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 來查詢子項目。舉例來說，你可以查詢下列內容的後設資料：

• 兩個特定 Game Center 排行榜，使用：-subitemtype GameCenterLeaderboard -subitemids com.mycompany.Leaderboard01,com.mycompany.Leaderboard02。

• 兩個特定 Game Center 成就，使用：-subitemtype GameCenterAchievement -subitemids com.mycompany.Achievement01,com.mycompany.Achievement02。

若要查詢訂閱制影片的後設資料，請指定 UMC 目錄（-umc_catalog_id）、內容（-umc_content_id）和變體（-umc_variant_id）識別碼。

• -umc_catalog_id 選項會指定目錄識別碼。你可以多次指定此值。如果僅指定一次，則該值適用於所有內容識別碼和變體識別碼。但是，如果多次指定，則指定的次數必須與內容識別碼和變體識別碼的數量相符。

• -umc_content_id 選項會指定內容識別碼。如果多次指定此值，則指定的次數必須與變體識別碼的數量相符。

• -umc_variant_id 選項會指定變體識別碼。如果多次指定此值，則指定的次數必須與內容識別碼的數量相符。

以下範例指定了單一訂閱制影片。

以下範例指定了多個訂閱制影片。

如需更詳細的範例（包含 Transporter 的輸出與記錄資訊），請參閱 lookup metadata 模式（單一商店套件）和 lookup metadata 模式（多個商店套件）。

在 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 記錄資訊至標準錯誤，以及仍需要你留意的所有未結工作單的相關資訊。Transporter 會以 XML 格式傳回輸出資訊。

如需更詳細的範例（包含 Transporter 的輸出與記錄資訊），請參閱 query tickets 模式。

repair assets 模式不會修改現有的商店套件。在你使用 repair assets 模式來修復素材檔案之後，你就必須用新的、修復過的素材檔案，來替換商店套件中現有的、未修復的素材檔案，並適當更新 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 模式。

在 report help 模式中，你必須指定以下命令列選項：

• -m reportHelp

• -u<username>

• -p<password>

• -type "Book Sales and Trends"

你也可以選擇指定下列其他的命令列選項：

• -sub_type <”Sales Summary” | “Sales Detailed” | “PreOrder Summary” | “PreOrder Detailed”>

• [-outputFormat <text | json>]

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

在以下範例中，當 Transporter 執行命令完畢，就會傳回 eXtreme 記錄資訊至標準錯誤，並以預設的文字輸出格式，提供「書籍銷售與趨勢」報告所有子類型的相關詳細資訊。

如果你在最近 24 小時內要求過報告，而且報告已供下載，Transporter 便會立即將報告下載到指定的目錄。如果你在最近 24 小時內要求過報告，但報告尚未提供下載，Transporter 就會顯示狀態訊息指出報告不可下載。或者，如果你在最近 24 小時內並未要求過報告，Transporter 就會建立對新報告的要求。

在 request report 模式中，你必須指定以下命令列選項：

• -m requestReport

• -u <username>

• -p <password>

• -destination <path>

• -type <type>

若為「Book Sales and Trends」（書籍銷售與趨勢）類型，還須指定下列命令列選項：

• -sub_type <”Sales Summary” | “Sales Detailed” | “PreOrder Summary” | “PreOrder Detailed”>

• -additional_args “vendor_id=<SAP vendor number>; granularity=<Daily | Weekly | Monthly | Yearly>”

• -reportDate<date>

注意：僅書籍會有「Sales Detailed」（銷售詳細資訊）和「PreOrder Detailed」（預訂詳細資訊）報告，有聲書沒有這兩種報告。

你也可以選擇指定下列其他的命令列選項：

• -reportDate<date>（此為「書籍銷售與趨勢」報告的必要項目；其他情況下為選填項目）

• [-o <output>]

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

• [-WONoPause <true | false>]

• [-outputFormat xml]

在以下範例中，當 Transporter 執行命令完畢，就會傳回 eXtreme 記錄資訊至標準錯誤，以及列出供應商的所有可用目錄報告。若有，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" 值。你可以在 retrieve asset 模式的命令中使用該 "id" 值作為 <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 後設資料之前，Apple 建議你檢查檔案是否有任何結構及格式上的錯誤。系統會拒絕有錯誤的檔案，這樣會讓你的內容傳送發生延遲。內容傳送的描述語言為 Relax NG（RNG）。若要檢查錯誤，你需要 RNG 描述語言的驗證工具。

注意：描述語言檔案是動態的，而且常常一個檔案混合了多種描述語言類型（例如音樂或電視）。

在 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 Package 影片規格的「transitional」（可轉換）描述語言檔案到控制台。

如需更詳細的範例（包含 Transporter 的輸出與記錄資訊），請參閱 schema 模式。

當你執行速度檢測來測量上傳作業的傳輸效能時，Transporter 會以指定大小建立一個隨機二進位檔案，並上傳到 Apple 的伺服器。除非你指定特定的傳輸通訊協定，否則 Apple 支援的每種傳輸通訊協定都會經過測試。

建議你使用預設值，執行所有傳輸通訊協定的檢測。對所有通訊協定都執行速度檢測，較好比較結果。

在你順利執行速度檢測後，Transporter 會顯示每次上傳的結果，報告輸送量及總傳輸時間。如果上傳失敗，Transporter 會傳回資訊性、警告性或錯誤性訊息，說明失敗的情況。除了記錄中呈現的摘要之外，Transporter 還會建立一個輸出檔案，你可以將該檔案傳送給 Apple 以尋求上傳速度問題的診斷。

產生的輸出檔案名稱為 SpeedCheck-<YYYY-MM-DD-HH-mm-ss>.zip，其中 <YYYY-MM-DD-HH-mm-ss> 是執行速度檢測的時間戳記。此檔案的名稱會顯示在主控台記錄輸出中的摘要報告之後。此 ZIP 檔案包含下列內容：

• 作業系統檔案夾：包含的檔案或檔案夾對應到執行過的每個命令。輸出結果會描述上傳作業所使用的網路介面。

• 「network-interfaces.json」檔案：有關網路介面的訊息。

• 「networkQuality」檔案夾：networkQuality 程式的輸出結果。此資訊可以協助你決定測試檔案的最佳大小。

• 「speed-check-info.json」檔案：有關 Transporter 啟動方式的資訊。此資訊可以協助你研究伺服器端的問題。

• 「speed-checks.json」檔案：各傳輸類型的統計資料。

• 「traceroute」檔案夾：traceroute（路由追蹤）命令的輸出結果。此資訊可以協助你確定網路流量使用公共網路以及進入 Apple 內部網路的位置。

• 「transport-log.txt」檔案：速度檢測執行期間產生的 Transporter 主控台輸出結果的副本。

此模式與使用 transfer test 模式（傳輸測試）的不同之處在於，它著重於檔案的上傳，而不是上傳套件的整個過程。

在 speed check 模式中，你必須指定以下命令列選項：

• -m speedCheck

• -u<username>

• -p<password>

• -k<kilobits_per_second>

你也必須指定下列選項之一：

• [-asc_provider<WWDR_team_ID>]

• [-itc_provider<shortname>]

• [-s<shortname>]

你也可以選擇指定下列其他的命令列選項：

• [-f<file>] *

• [-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 執行命令完畢後，就會在「Speed Check Summary」（速度檢測摘要）中傳回 eXtreme 記錄資訊、總傳輸時間，以及 1 GB 測試檔案的詳細資訊。速度檢測摘要包含下列資訊：

• 為各傳輸通訊協定上傳的檢測檔案名稱。

• 所上傳檔案的大小。

• 偵測到的網路介面。

• 各傳輸通訊協定的傳輸統計數據。這些結果會依照傳輸速度，由快到慢排序。

輸出結果範例

使用 status 模式，可以看見你套件的狀態以及你的套件是否有任何錯誤（例如內部傳輸錯誤或輸入錯誤）。你也可以看見你套件的廠商或 Apple 識別碼、內容狀態資訊（例如「活動中」、「其他」、「非活動中」、「審查中」）以及內容審查狀態（例如 NotLive-WaitingForReview）。此外，對於所有內容類型（音樂、電視、書籍、App 等），Transporter 會顯示：

• 「上傳狀態」和「上傳狀態 id」欄位表示你的套件是否處於「內部傳輸」、「正在上傳」、「準備輸入」、「正在輸入」、「輸入錯誤」、「已輸入」或「不會處理」狀態。

• 「內容狀態」和「內容狀態 id」欄位可指出你的套件在 iTunes Connect 中為「Polished」或「Unpolished」狀態。

• 「已於商店上架」、「準備於商店上架」和「未於商店上架」欄位，依國家或地區來顯示你套件的狀態。針對每個狀態，Transporter 會顯示以逗號分隔的國碼列表或 N/A。N/A 代表沒有國家/地區符合此狀態。此狀態資訊對應用程式或鈴聲不可用。

• 「上傳建立於」表示 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 目錄（-umc_catalog_id）、內容（-umc_content_id）和變體（-umc_variant_id）識別碼。

• -umc_catalog_id 選項會指定目錄識別碼。你可以多次指定此值。如果僅指定一次，則該值適用於所有內容識別碼和變體識別碼。但是，如果多次指定，則指定的次數必須與內容識別碼和變體識別碼的數量相符。

• -umc_content_id 選項會指定內容識別碼。如果多次指定此值，則指定的次數必須與變體識別碼的數量相符。

• -umc_variant_id 選項會指定變體識別碼。如果多次指定此值，則指定的次數必須與內容識別碼的數量相符。

以下範例指定了單一訂閱制影片。

以下範例指定了多個訂閱制影片。

如需更詳細的範例（包含 Transporter 的輸出與記錄資訊），請參閱 status 模式（音樂範例）、status 模式（影片範例）與 statusAll 模式。

當你針對傳輸效能而測試套件時，Transporter 會建立測試用套件來利用現有的行為及統計資料。在你成功上傳套件之後，Transporter 會顯示該套件的總傳輸時間與詳細資料（-throughput）。如果上傳失敗，Transporter 會傳回告知性、警告性或錯誤性訊息指出問題。

不論你是否指定 -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 記錄資訊到主控台，還有 10MB（10,000,000 位元組）套件的總傳輸時間與詳細資訊（-throughput）。Transporter 會在上傳期間使用 10,000 Kbit/s 的節流速度，傳送指定的供應商檔案到 Signiant 伺服器。

如需更詳細的範例（包含 Transporter 的輸出與記錄資訊），請參閱 transfer test 模式。

除了 macOS 之外，App 上傳作業也支援 Linux 和 Windows。你可以使用 -assetFile 或 -f。如使用 Linux 和 Windows 系統，則你必須提供 -assetDescription 引數，這會指定從 Xcode 匯出時產生的檔案（即 AppStoreInfo.plist 檔案）。如需產生該檔案的相關資訊，請參閱 Archive export files（封存輸出檔案）。

如果你在嘗試上傳內容時收到下列訊息：“1023: Encoding house <encoding house name> 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 建議你一次不要傳送超過 1000 個商店套件。

在 upload 模式中，你必須指定以下命令列選項：

• -m upload

• -f <dir | pkg> 或 -assetFile <.ipa | .pkg>（適用於 macOS、Linux 和 Windows 上傳作業）

  注意：-f 選項無法用來上傳 App。若為 App，請改用 -assetFile 選項。

• -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>]

除了 macOS，upload asset pack 模式也支援 Linux 和 Windows。使用 -assetFile 來指定背景素材的壓縮封存檔案，並使用 -assetPackId 提供背景素材所關聯的識別碼（使用 Linux 和 Windows 者必須提供）。使用 -apple_id 來指定與此背景素材包關聯的 App。

在 upload asset pack 模式中，你必須指定以下命令列選項：

• -m uploadAssetPack

• -assetFile <path_to_aar_file>

• -assetPackId <id>（此素材包的開發者識別碼；Linux 和 Windows 上傳作業必須提供 -assetPackId）

• -apple_id <id>（App 的 Apple 識別碼）

• -u <username>

• -p <password>

• -asc_provider <shortname>（須經使用者名稱和密碼驗證）

你也可以選擇指定下列其他的命令列選項：

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

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> 或 -assetFile <.ipa | .pkg>（適用於 macOS、Linux 和 Windows 上傳作業）

  注意：-f 選項無法用來驗證 App。若為 App，請改用 -assetFile 選項。

• -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 以列表形式傳回供應商的所有報告，然後顯示 eXtreme 記錄資訊。

在本範例中，Transporter 顯示要求日期（03/21/2013 12:11 PDT）、要求報告的使用者名稱（bob）、內容類型（TV Show）和狀態（Succeeded），代表已成功執行報告要求。

Transporter 執行命令完畢後，會顯示包含供應商長名稱和短名稱的清單，其中 bob 有權限提供內容，但不含任何其他記錄資訊。

在此範例中，bob 擁有為一個供應商傳送內容的權限：Apple Computer（全名），Apple（簡稱）。當上傳這個供應商的素材時，請使用簡稱（Apple）搭配 -s 選項。

Transporter 傳回仍需要你留意的所有未結工作單的相關資訊，以及顯示 eXtreme 記錄資訊。

在此範例中，Transporter 會顯示兩個待處理工作單（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 傳回商店套件影片規格 4.7 版的「transitional」（可轉換）描述語言，以及顯示 eXtreme 記錄資訊。

在此範例中，Transporter 會將可轉換描述語言檔案儲存到 /tmp/schema/film4.7-transitional.rng。