跳到主要內容
Flow

安裝

以 Homebrew 或 DMG 安裝 Flow，以及更新、解除安裝與從原始碼建置。

開啟 .md在 GitHub 編輯

系統需求

  • macOS 26 以上
  • Apple Silicon

不支援 Intel Mac。

Homebrew

brew install --cask xlanstar/tap/flow-player

flow 已被 homebrew/core 的 formula 使用，所以 Cask 名稱為 flow-player。

DMG

  1. 從 GitHub Releases 下載 Flow-<version>.dmg。
  2. 打開 DMG，把 Flow.app 拖到 Applications。

App 以 Developer ID 簽章並通過 Apple notarization，可直接開啟。

更新

Flow 沒有自動更新。

  • Homebrew：brew upgrade --cask flow-player
  • DMG：下載新版，覆蓋 /Applications/Flow.app

解除安裝

brew uninstall --cask flow-player          # 只移除 app
brew uninstall --zap --cask flow-player    # 一併移除設定

以 DMG 安裝時，刪除 /Applications/Flow.app；要一併移除設定時，再刪除：

  • ~/Library/Preferences/dev.lanstar.flow.plist
  • ~/Library/Saved Application State/dev.lanstar.flow.savedState

從原始碼建置

需要 Xcode（版本見 .xcode-version）與 XcodeGen（brew install xcodegen）。

git clone https://github.com/xlanstar/flow.git
cd flow
scripts/build-ffmpeg.sh       # 建置 FFmpeg XCFramework 到 Vendor/
scripts/generate-project.sh   # 產生 Flow.xcodeproj
scripts/build.sh              # 產出 build/release/Flow.app
  • 開發時改以 Xcode 開啟 Flow.xcodeproj，執行 FlowMac scheme；首次建置須信任 Metal4 的 build tool plugin。
  • 本機建置為 ad hoc 簽章，只適合在自己的 Mac 使用；在其他 Mac 開啟須到「系統設定 › 隱私權與安全性」手動允許。

疑難排解

  • 開啟後顯示錯誤、無法播放任何影片：確認系統與晶片符合系統需求。
  • 啟動與錯誤 log：log stream --predicate 'subsystem == "Flow"'
  • 回報問題：GitHub Issues