Files

Timmy 4feb33f514 Initial commit: libimobiledevice 操作筆記與參考文件

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-15 13:25:54 +08:00

功能總表

以 iPhone 15 Pro Max (iOS 26.4.1) 實測結果。

直接可用

USB 連線 + 配對即可，不需要額外條件。

功能	指令	備註
列出裝置	`idevice_id -l`
配對管理	`idevicepair pair/validate/unpair`	iPhone 需解鎖並點信任
裝置名稱	`idevicename`
裝置資訊	`ideviceinfo`	型號、iOS 版本、Wi-Fi MAC 等
裝置日期	`idevicedate`
電池狀態	`ideviceinfo -q com.apple.mobile.battery`	電量%、充電狀態
儲存空間	`ideviceinfo -q com.apple.disk_usage`
診斷資訊	`idevicediagnostics diagnostics All`	電池循環次數、設計容量
系統日誌	`idevicesyslog`	即時串流，Ctrl+C 停止
Crash 報告	`idevicecrashreport -e <目錄>`	App 當機、Jetsam、Panic 等
App 列表	`ideviceinstaller list --user`	需另裝 `ideviceinstaller`
App 安裝	`ideviceinstaller install <ipa>`	需另裝 `ideviceinstaller`
App 移除	`ideviceinstaller uninstall <BundleID>`	需另裝 `ideviceinstaller`
備份	`idevicebackup2 backup --full <目錄>`	iPhone 需輸入密碼確認
還原	`idevicebackup2 restore <目錄>`
Provisioning Profile	`ideviceprovision list`
同步資料查詢	`ideviceinfo -q com.apple.mobile.sync_data_class`	聯絡人/行事曆/書籤/備忘錄
通知監聽	`idevicenotificationproxy observe <事件>`
藍牙封包擷取	`idevicebtlogger <檔案>`	可輸出 pcap 給 Wireshark
Wi-Fi 同步查詢	`ideviceinfo -q com.apple.mobile.wireless_lockdown`
開發者模式查詢	`idevicedevmodectl list`
限制查詢	`ideviceinfo -q com.apple.mobile.restriction`
重新開機	`idevicediagnostics restart`	會真的重開機
關機	`idevicediagnostics shutdown`	會真的關機
睡眠	`idevicediagnostics sleep`

需先安裝 Xcode 並掛載 Developer Disk Image。

功能	指令	掛載方式
螢幕截圖	`idevicescreenshot <檔案>`	Xcode > Devices and Simulators 開啟裝置
遠端除錯	`idevicedebug run <BundleID>`	同上
除錯伺服器代理	`idevicedebugserverproxy <port>`	同上
掛載映像檔	`ideviceimagemounter <dmg>`	需要 DeveloperDiskImage.dmg

功能	指令	說明
GPS 模擬定位	`idevicesetlocation <緯度> <經度>`	Apple 已移除 simulatelocation 服務

替代方案：Xcode 內建 Simulate Location 或第三方工具。

以下指令請謹慎使用：

指令	風險
`idevicediagnostics restart`	裝置立即重開機，重開後需重新解鎖並配對
`idevicediagnostics shutdown`	裝置立即關機
`ideviceenterrecovery <UDID>`	進入恢復模式，需用 iTunes/Finder 回復