|
@@ -1,2 +1,26 @@
|
|
|
-# missionplanner_appimage_builder
|
|
|
|
|
|
|
+# Mission Planner AppImage Builder for Linux
|
|
|
|
|
|
|
|
|
|
+A fully containerized build script that creates a self-contained, portable `.AppImage` for [ArduPilot's Mission Planner](https://ardupilot.org/planner/).
|
|
|
|
|
+
|
|
|
|
|
+## The Problem
|
|
|
|
|
+Running Mission Planner natively on Linux typically requires installing the `mono-complete` framework and a tangled web of Windows-to-Linux graphics shims (`libgdiplus`, `libMonoPosixHelper`, etc.). This often pollutes your host operating system and frequently breaks due to missing dependencies, broken symlinks, or mismatched library versions.
|
|
|
|
|
+
|
|
|
|
|
+## The Solution
|
|
|
|
|
+This script uses **Docker** to build the application in a temporary, isolated Ubuntu environment. It automatically fetches the latest Mission Planner binaries, downloads the Mono runtime, hunts down every required native graphics/POSIX dependency, and maps the DLLs correctly.
|
|
|
|
|
+
|
|
|
|
|
+It then squashes everything into a single, executable `MissionPlanner.AppImage`.
|
|
|
|
|
+* **Zero Host Pollution:** Your host machine stays completely clean. No Mono or Windows dependencies are installed.
|
|
|
|
|
+* **Fully Portable:** Move the resulting `.AppImage` to any compatible Linux machine and run it instantly.
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+## 🛠️ Prerequisites
|
|
|
|
|
+The only requirement to run this build script is that your system (or build server) has Docker installed.
|
|
|
|
|
+* [Docker Engine](https://docs.docker.com/engine/install/)
|
|
|
|
|
+
|
|
|
|
|
+## ⚙️ How to Build
|
|
|
|
|
+
|
|
|
|
|
+1. **Clone this repository** (or download the script):
|
|
|
|
|
+ ```bash
|
|
|
|
|
+ git clone [https://github.com/YOUR_USERNAME/MissionPlanner-AppImage.git](https://github.com/YOUR_USERNAME/MissionPlanner-AppImage.git)
|
|
|
|
|
+ cd MissionPlanner-AppImage
|
Nicole Portas