Tophat

Tophat 是什麼？

Tophat 是一款可單鍵安裝與測試行動應用程式的工具。它旨在協助團隊從 CI 成品分發建置、建立安裝連結，並在不需要貢獻者於本機複製或建置分支的情況下，直接在裝置或模擬器上啟動應用程式。

此專案也提供擴充與命令列功能，可整合自訂的建置與快取系統。Tophat 透過安裝 URL、Quick Launch 與 artifact provider 支援 iOS 和 Android 工作流程，並可使用包含多個 artifact、對應不同目標的 recipe。

主要功能

• CI artifact 的一鍵安裝連結，讓測試人員與貢獻者無需本機建置步驟即可安裝建置版本。
• 基於 artifact provider 的下載，可讓 Tophat 從內建 provider 或透過擴充新增的 provider 取得建置版本。
• 支援多種請求類型，包括 URL、Quick Launch 與 tophatctl 命令列介面。
• 可在單一請求中封裝多個 artifact 的 recipe，適合需要為模擬器與實體裝置提供不同建置版本的情境。
• 用於將自訂建置與快取系統整合進安裝流程的 TophatKit SDK 擴充。
• 可快速啟動常用應用程式的 Quick Launch 捷徑，能下載最新建置、更新應用程式圖示，並在選定裝置上啟動應用程式。
• 裝置釘選與基於設定的自訂，可更快存取常用裝置與特定環境的工具路徑。
• 支援啟動參數，且文件中有說明 iOS 與 Android 的傳遞方式。

如何使用 Tophat？

一般設定流程是先將 Tophat 與你的建置或 artifact provider 整合，讓它能解析可下載的應用程式建置版本。接著，你可以建立安裝連結、Quick Launch 項目，或使用 tophatctl 來為指定裝置或模擬器觸發安裝。

對於有自訂基礎架構的團隊，可使用 TophatKit SDK 與 shell-script provider 選項，將 Tophat 調整為符合既有的建置與快取系統。設定完成後，使用者只要點擊安裝連結或在 Tophat 中選擇應用程式，即可將建置下載、安裝並在目標裝置上開啟。

使用情境

• 與 QA 分享 CI 建置，讓測試人員可直接透過連結安裝特定版本的應用程式。
• 讓外部貢獻者在不複製儲存庫或不於本機建置應用程式的情況下測試 pull request。
• 當發佈流程為不同目標產生不同 artifact 時，能從單一請求安裝模擬器與裝置的分別建置。
• 為經常在多個專案或裝置間切換的開發人員提供常用應用程式的快速存取。
• 透過擴充或 shell-script provider 將 Tophat 連接到自訂的內部建置系統或快取。

FAQ

Tophat 只能搭配單一 artifact 來源使用嗎？
不是。來源說明了內建 artifact provider，以及可透過 Tophat 擴充安裝的額外 provider。

Tophat 可以同時處理裝置與模擬器嗎？
可以。文件指出單一請求可包含多個 artifact，而 Tophat 會根據所選目的地選取適當的 artifact。

可以將啟動參數傳給已安裝的 app 嗎？
可以。來源文件提到安裝 URL 的 arguments 查詢參數，並註明 iOS 與 Android 的平台特定處理方式。

有可供整合的命令列選項嗎？
有。頁面提到 tophatctl，並指出使用者可從命令列列出 artifact provider。

Tophat 一定需要自訂工具才有用嗎？
不一定。來源提到內建 provider 與基本 HTTP 支援，而擴充則可用於更客製化的設定。

替代方案

• 透過直接下載建置版本或分享連結進行手動應用程式分發：較簡單，但不提供 Tophat 的裝置感知安裝流程或 Quick Launch 功能。
• CI artifact 檢視器與下載入口：有助於取得建置版本，但通常著重於儲存與存取，而非直接一鍵安裝到裝置。
• 行動裝置測試平台：更完整的端對端測試套件，可能包含建置分發，但通常涵蓋的範圍比 Tophat 專注的安裝與啟動流程更多。
• 自訂腳本或內部分發工具：對特定流程很有彈性，但通常比標準化的安裝連結工作流程需要更多維護。