Kuuchi's Blog

首頁 | 文章列表 | 關於本站 | 友情網址


修復 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 可能覆蓋修改,屆時應重新確認問題。

返回文章列表


返回完整 HTML 版