使用說明
Android 連線
透過 FlyTo Lander helper App 與 adb 通道，將虛擬座標推送至 Android 實機或 Android Emulator。
Android 怎麼接？
FlyTo 從 1.0.38 起正式支援 Android。可以連 Android 實機（USB 或 Wi-Fi）或 Android Studio 內的手機模擬器；手機端則由 FlyTo 自家的小工具「FlyTo Lander」負責執行定位模擬。
| 用詞 | 白話意思 |
|---|---|
| FlyTo Lander | 放在手機端的輔助 App，由它負責讓手機相信「現在的位置」。Mac 端的 FlyTo 透過連線通知它要切到哪裡。 |
| USB / 無線偵錯 | Android 內建的「讓電腦連到手機」開關，必須開啟 FlyTo 才連得到。可以類比成 iPhone 的「信任這部電腦」。 |
| 模擬位置應用 | Android 設定裡的一個選項：手機允許「哪個 App」可以模擬定位。指定為 FlyTo Lander 才能用。 |
| Android Platform Tools (adb) | Google 官方提供的連線工具包，是 Mac ↔ Android 之間的橋樑。FlyTo 會自動找，使用者通常不需要直接接觸。 |
| Android Emulator / AVD | Android Studio 內的「手機軟體模擬器」，不是實機；對應 iPhone 那邊的 iPhone 模擬器。 |
需要準備什麼
- Android 10 以上的實機（手機 / 平板）或手機模擬器
- Mac 上有 Android Platform Tools（Google 官方連線工具包）。若你裝過 Android Studio 就已有；沒有的話之後依錯誤訊息提示去下載即可
- 實機需在手機上安裝 FlyTo Lander；手機模擬器由 FlyTo 全自動安裝
- 手機端開啟「開發人員選項 → USB 偵錯」或「無線偵錯」
Android 9 之後，系統規定「模擬定位」只能由「事先被使用者明確指定的 App」執行，從電腦端直接送座標進去是不被允許的。FlyTo Lander 就是這個被指定的 App：你在 Android 設定裡選它作為「模擬位置應用」後，Mac 端的 FlyTo 才能透過它把虛擬座標送進手機。
由於 Google Play 政策禁止這類 App 上架，Lander 採開源方式發布（原始碼公開於 GitHub），需自行下載安裝。
一、Mac 端：安裝 Android Platform Tools
「Android Platform Tools」是 Google 官方的連線工具包，FlyTo 需要靠它跟 Android 對話。如果你裝過 Android Studio 就已經有了，FlyTo 會自動找到；若沒有，FlyTo 找不到時會顯示三段式錯誤訊息（發生什麼 / 可能原因 / 解決方式）引導你下載。
下載 Platform Tools（若還沒有）
到 Android Developers - SDK Platform Tools 下載 macOS 版本的 ZIP，解壓後將 platform-tools 整個資料夾放到你習慣的位置（例如 ~/Library/Android/sdk/platform-tools/）。
若你已經有 Android Studio，工具包已隨附在 ~/Library/Android/sdk/platform-tools/，直接跳到下一步即可。
FlyTo 會自動找到
FlyTo 啟動與連線時會自動找上述位置或 Homebrew 預設位置，找到就直接用，無需手動指定。一般使用者到這裡就完成了。
進階：把工具裝在其他路徑（多數使用者用不到）
FlyTo 啟動時依下列順序尋找 adb：
$ANDROID_HOME/platform-tools/adb$ANDROID_SDK_ROOT/platform-tools/adb~/Library/Android/sdk/platform-tools/adb（Android Studio 預設位置）/usr/local/bin/adb（Intel Mac 上 Homebrew 預設位置）/opt/homebrew/bin/adb（Apple Silicon 上 Homebrew 預設位置）
若你把工具裝在其他路徑，請在 ~/.zshrc 加入 export ANDROID_HOME=/path/to/sdk（指向你的 SDK 根目錄）後重啟終端機，再重啟 FlyTo 即可。
二、實機：USB 連線 Android 實機
開啟開發人員選項
「設定 → 關於手機」連點「組建編號」7 次解鎖開發人員選項；接著進入「系統 → 開發人員選項」開啟 USB 偵錯。
各廠商 ROM 的選單路徑略有差異（MIUI 在「我的裝置 → 全部參數」、One UI 在「軟體資訊」），通常文字差不多。
USB 連到 Mac 並信任此電腦
使用 USB 傳輸線連到 Mac。Android 端會跳出「允許 USB 偵錯？」對話框（中間會顯示一串電腦的識別碼），請勾選「永遠允許此電腦進行偵錯」再按「允許」。
安裝 FlyTo Lander
到 FlyTo Lander Releases 下載最新的安裝檔（flyto-lander.apk）到 Mac 的「下載項目」。打開 Mac 上的「終端機」App（Spotlight 搜「終端機」即可），貼上下面這行並按 Enter：
adb install -r ~/Downloads/flyto-lander.apk看到 Success 訊息就完成了。這行指令會把 APK 透過 USB 線安裝到手機上，跟手動把檔案複製進去再點安裝是同樣效果。
設定 FlyTo Lander 為「模擬位置應用」
Android 端「設定 → 系統 → 開發人員選項 → 選取模擬位置應用」（英文版叫 Select mock location app），選擇 FlyTo Lander。
這一步只需要設定一次。若日後重新安裝或更新 Lander 後選項被清空，FlyTo 會跳出「模擬位置應用未指定」提示並引導你回來重選。
在 FlyTo 選擇裝置
切到 FlyTo「設備」頁籤，在「Android 設備」群組中應該會看到剛接上的手機，點擊即連線。進度列會依序顯示「尋找裝置 → 升級輔助 App（若需要）→ 建立連線」，完成後即可在地圖上瞬移、播放路線、收藏地點。
三、實機：Wi-Fi 無線偵錯 Android 實機
無需 USB 線即可連線，前提是 Mac 與 Android 處於同一個 Wi-Fi。流程依 Android 版本略有不同。
Android 11 以上（用配對碼配對）
在 Android 開啟「無線偵錯」
「開發人員選項 → 無線偵錯」打開後，點「與電腦配對 (Pair device with pairing code)」，畫面會顯示一組 IP / 配對 Port / 6 位配對碼。同個畫面下方還會列出實際連線用的「IP 位址與連線 Port」（號碼會跟配對 Port 不一樣）。
在 FlyTo 開啟配對視窗
「設備」頁籤的「Android 設備」群組標題列，點右上角的 + 按鈕。FlyTo 會彈出配對視窗，把上一步看到的「IP / 配對 Port / 配對碼 / 連線 Port」四項依序填進去。
FlyTo 自動完成配對
按下確認後 FlyTo 會自動完成配對與連線。成功後裝置會出現在「Android 設備」群組，後續使用與 USB 連線相同。
Android 10（先 USB 配對一次，之後 Wi-Fi 連）
Android 10 還沒有配對碼功能，需先用 USB 配對過一次：
- USB 連到 Mac，按「永遠允許此電腦進行偵錯」完成信任。
- 打開 Mac 終端機，貼上
adb tcpip 5555按 Enter（請手機之後改走 Wi-Fi）。 - 拔掉 USB 線，到手機「設定 → 關於手機 → 狀態」記下 IP 位址。
- 在 FlyTo 配對視窗切到「重新連線」模式，只填 IP + Port（5555）即可。
四、Android Emulator（AVD）連線 Android Emulator
如果你用 Android Studio 建好的手機模擬器（AVD），FlyTo 提供「點一下全自動」流程，不必先啟動模擬器、也不必手動安裝 Lander，全交給 FlyTo。
確認模擬器已建立
透過 Android Studio 的「Device Manager」建立任一手機模擬器（推薦 Pixel 6 / Android 13 或更新）即可，不需事先啟動。FlyTo 會自動列出所有已建立的模擬器（不論啟動與否）。
在 FlyTo 直接點模擬器名稱
FlyTo「設備」頁籤 → 「模擬器」群組中可看到所有手機模擬器（與 iPhone 模擬器並列）。點擊後 FlyTo 會跳出對話框問你要不要啟動該模擬器，按「啟動」就進入自動流程。
等待全自動完成
FlyTo 會自動依序執行：啟動模擬器 → 安裝 / 升級 Lander → 授權「模擬位置應用」 → 建立連線。第一次跑大約 18 秒、之後同個模擬器約 10 秒。完成後即可開始模擬。
FlyTo 1.0.38 起內建 Lander 安裝檔，啟動時會在背景檢查 GitHub 是否有新版本，下載後存到 Mac 本機。可在「設定 → 設備」分頁找到「自動升級 Lander」開關與「立即檢查」按鈕。模擬器連線時若偵測到 Lander 過舊會自動升級；實機目前需手動更新（重新跑一次安裝指令即可）。
五、常見錯誤排除
連線出問題時，FlyTo 會跳出三段式錯誤訊息：發生什麼 / 可能原因 / 解決方式，照著做即可。下方整理最常見的幾種狀況。
未授權 USB 偵錯
多半是「允許 USB 偵錯」對話框被忽略或拒絕。請拔掉 USB 重接，留意手機螢幕，勾「永遠允許此電腦進行偵錯」再按「允許」。若連對話框都沒跳，到手機「開發人員選項 → 撤銷 USB 偵錯授權」清掉舊紀錄再重新連接。
裝置未安裝 FlyTo Lander
FlyTo 連線時找不到手機端的 Lander。實機請依本頁「二、實機：USB 連線」的第 3 步重新跑安裝指令；手機模擬器則應由 FlyTo 自動裝好，若仍報錯請確認模擬器是否已完整啟動。
未指定模擬位置應用
Lander 已安裝但 Android 設定裡沒指定它，定位模擬無法生效。請到「設定 → 系統 → 開發人員選項 → 選取模擬位置應用」明確選擇 FlyTo Lander。若選項是空白，往下拉確認 Lander 是否在清單中；若不在，多半是該手機品牌（例如 MIUI）對來源不明 App 額外做了限制，需先到該手機設定關閉相關保護。
Wi-Fi 配對失敗 / 連線失敗
- 確認 Mac 與 Android 連到同一個 Wi-Fi
- 配對碼僅在 Android 端「與電腦配對」視窗開啟時有效，視窗關掉即失效；逾時請重新點開以取得新的 IP / Port / 配對碼
- 注意「連線 Port」與「配對 Port」不同：配對 Port 是一次性的、連線 Port 才是長期使用；Android 11+ 首次使用必須先完成配對才能連線
- 公司 / 公共 Wi-Fi 有時會阻擋裝置互連，可改用手機熱點或家用網路
- 手機可能已被其他電腦配對：在 Android「無線偵錯」內可清除既有配對後重來
▸ 進階：Lander 檔案完整性驗證失敗 / 觀察手機端訊息
Lander 檔案完整性驗證失敗
FlyTo 下載 Lander 後會驗證檔案完整性，對不上時會拒絕安裝。請到「設定 → 設備 → 立即檢查 Lander 更新」按鈕重新下載；若仍失敗，可手動刪除快取目錄 ~/Library/Application Support/com.mingyuan.FlyTo/lander-cache/ 後重啟 FlyTo。
觀察手機端 Lander 訊息（Logcat）
把「設定 → 一般 → 開發者模式」打開後，在設備清單上對該手機按右鍵，會多出「開啟 Logcat」選項。FlyTo 會用終端機自動執行觀察指令，即時顯示手機端 Lander 的運作訊息。懷疑 Lander 沒收到模擬指令時，這是最快的除錯入口。
六、注意事項與已知限制
- 銀行 / 支付 / 防詐 App：會偵測模擬位置並拒絕運作。使用 FlyTo 模擬時建議關閉這類 App 或先停止模擬。
- Google Play Protect：可能對 Lander 顯示「不認識的 App」警示，需手動允許安裝。Lander 為開源軟體，原始碼公開於 GitHub，可自行檢視。
- 不同品牌手機差異：MIUI（小米）、One UI（三星）、ColorOS（OPPO）等品牌客製系統的「模擬位置應用」選單位置與行為略有差異。目前 Google Pixel 與 Android 13 / 14 模擬器已完整驗證；三星、小米、OPPO 等實機尚在補測中。
- 最低 Android 版本：Android 10（含）以上。
- 連線工具請保持最新：Android Platform Tools 建議使用較新版本，舊版可能不支援部分新指令。
- 功能與 iPhone 一致：瞬移、單次行進、儲存路線（重複、折返、暫停、繼續、進度拖曳）、收藏點、行進模式皆與 iPhone 端相同。
部分依賴定位的 App（例如位置型遊戲、運動紀錄、行動支付）會偵測模擬位置，啟用後可能停權、拒絕運作或產生其他後果。FlyTo 僅供開發、測試與隱私保護用途，使用後果由使用者自行承擔。