Files
libimobiledevice-notes/QUICKSTART.md
2026-04-15 13:25:54 +08:00

70 lines
1.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 快速上手
從零開始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`