首頁 › 文章列表 › 本文

修復 Meshtastic Desktop 一般地圖空白問題

2026-10-07・Kuuchi

本文處理的是 Meshtastic Desktop 的一般「地圖」分頁，不是 Traceroute Map。

問題現象

在 Apple Silicon Mac 上使用 Meshtastic Desktop 2.8.2 時，其他功能可以正常運作，但一般地圖分頁只顯示 MapLibre 控制按鈕和版權標示，OpenStreetMap 底圖、節點標記與節點群組都沒有出現。

診斷與修復

檢查後發現問題並不只是下載不到圖磚。MapLibre 使用 Metal 繪製地圖時，未能完成第一個影格。進一步檢查應用程式封裝與啟動 classpath，發現改用官方 Maven Central 的 lwjgl-3.4.2-unsafe.jar 後可以正常初始化。

1. 備份原始設定與相關 JAR。
2. 加入官方的 lwjgl-3.4.2-unsafe.jar。
3. 修改 Meshtastic Desktop.cfg 的 classpath。
4. 重新套用 macOS 本機簽章。
5. 使用 OpenStreetMap Direct 圖磚來源測試。

- app.classpath=$APPDIR/lwjgl-3.4.2-65b179f5412869a477ca1ad7155bf3.jar
+ app.classpath=$APPDIR/lwjgl-3.4.2-unsafe.jar

工作檔 SHA-256：ce2b316414bed6eff8d6a5ed8d0caf5137018afb9cc7a012c3c92805cd27b679

結果

修補後，MapLibre 成功使用 Metal 畫出第一個影格；一般地圖分頁能顯示世界底圖、比例尺、節點標記與節點群組。以一般方式重新啟動應用程式後，結果仍然正常。

注意事項

這是針對目前安裝環境的診斷性修補，不是官方更新。重新安裝或升級 Meshtastic Desktop 可能覆蓋修改，屆時應重新確認問題。

← 返回文章列表