# 快速上手

從零開始，5 分鐘完成安裝並與 iPhone 通訊。

## 1. 安裝

```bash
brew install libimobiledevice ideviceinstaller
```

## 2. 接上 iPhone

用 USB 線接上 iPhone，確認偵測到裝置：

```bash
idevice_id -l
```

應該會顯示一串 UDID，例如 `00008130-000249A4046B8D3A`。

## 3. 配對

```bash
idevicepair pair
```

iPhone 螢幕會跳出「信任這部電腦？」：
1. 點「信任」
2. 輸入密碼確認

驗證配對成功：

```bash
idevicepair validate
```

## 4. 試試看

```bash
# 看裝置是什麼型號、跑什麼 iOS
ideviceinfo -k ProductType
ideviceinfo -k ProductVersion

# 電池狀態
ideviceinfo -q com.apple.mobile.battery

# 電池循環次數
idevicediagnostics diagnostics All

# 列出你裝了哪些 App
ideviceinstaller list --user

# 即時系統日誌（Ctrl+C 停止）
idevicesyslog
```

## 常見問題

**Q: 出現 `Invalid HostID` 或 `SSL error`**
A: 重新執行 `idevicepair pair`，在 iPhone 上點信任。

**Q: 出現 `Mux error`**
A: iPhone 剛重開機需要先解鎖螢幕，再重新配對。

**Q: 截圖 `Invalid service`**
A: 需要用 Xcode 掛載 Developer Image，詳見 [完整指南](libimobiledevice-guide.md)。

**Q: GPS 模擬失敗**
A: iOS 17+ 已不支援 `idevicesetlocation`。