# 安裝

URL: https://flow.lanstar.dev/docs/installation

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

## 系統需求

- macOS 26 以上
- Apple Silicon

不支援 Intel Mac。

## Homebrew

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

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

## DMG

1. 從 [GitHub Releases](https://github.com/xlanstar/flow/releases/latest) 下載 `Flow-<version>.dmg`。
2. 打開 DMG，把 `Flow.app` 拖到 `Applications`。

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

## 更新

Flow 沒有自動更新。

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

## 解除安裝

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

```sh
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](https://github.com/xlanstar/flow/issues)