WinTAK-Plugin-Entwicklung: SDK, Plugin-Aufbau und Bereitstellung für .NET-Teams

Ein WinTAK-Plugin ist eine Klassenbibliothek für das .NET Framework, in C# mit WPF geschrieben, die WinTAK über das Managed Extensibility Framework (MEF) findet und in den eigenen Prozess lädt. Es kann Menüband-Schaltflächen, andockbare Bereiche, Kartenwerkzeuge, Cursor-on-Target (CoT)-Handler und Hintergrunddienste hinzufügen. Sie erstellen es in Visual Studio gegen das WinTAK SDK, das zur exakten WinTAK-Version Ihrer Nutzer passt, und liefern es als .wpk-Paket aus.

Dieser Leitfaden richtet sich an .NET-Teams, die mit der WinTAK-Plugin-Entwicklung beginnen, und an Programmmitarbeiter, die WinTAK-Plugins beschaffen. Er ergänzt unsere Übersicht zum Plugin-Engineering für ATAK und WinTAK und WinTAK im TOC. Klassen- und Schnittstellennamen stammen aus der veröffentlichten WinTAK-SDK-API-Referenz und deren Leitfaden „Extending WinTAK“; die API entwickelt sich zwischen Releases weiter, prüfen Sie also jeden Namen gegen die SDK-Version, mit der Sie bauen.

Was ist WinTAK?

WinTAK ist das Windows-Mitglied der Team-Awareness-Kit-Familie (TAK): eine behördliche Standardsoftware (GOTS) und ein Karten-Framework, das laut Benutzerhandbuch „sowohl in einem taktischen Umfeld als auch in einer Führungs- und Kommandoumgebung“ läuft. Es teilt das CoT-Ereignismodell mit ATAK und iTAK (siehe TAK-Protokoll: CoT XML und protobuf), verbindet sich mit dem TAK Server und verarbeitet Overlays, Datenpakete, Video und Chat. Signierte WinTAK-Installer nennen PAR Government als verifizierten Herausgeber, und aktuelle 5.x-Releases zielen auf .NET Framework 4.8.1 unter 64-Bit-Windows.

Die Produktseiten auf tak.gov führen zwei WinTAK-Produktlinien. WinTAK-CIV, „Windows OS Team Awareness Kit for Civilians“, ist die Edition, die Sie nach Registrierung auf tak.gov erhalten; TAK-CIV-Binaries werden nach Freigabe öffentlich zugänglich, ausgenommen Embargoländer und Parteien auf der Denied Persons List. WinTAK-MIL (das Windows Tactical Assault Kit) ist auf die militärische Nutzung der USA beschränkt, und ausländische Regierungen erhalten TAK-MIL ausschließlich über Foreign Military Sales. tak.gov stuft ATAK-CIV als EAR99 ein, weist aber darauf hin, dass andere TAK-CIV-Produktlinien noch bewertet werden — gehen Sie also nicht davon aus, dass WinTAK-CIV dieselbe Einstufung hat. Der Einsatz über Test und Evaluation hinaus braucht eine Betriebserlaubnis (ATO) Ihrer Organisation.

Die WinTAK-Versionsnummern folgen denen von ATAK. Der öffentliche Release-Fahrplan von tak.gov listet WinTAK 5.8 für August 2026 und 5.9 für Dezember 2026, jeweils mit Feature-Freeze einen Monat zuvor. tak.gov listet außerdem TAKX, „die Krönung zweier führender Windows-basierter Führungs- und Kommandoplattformen: WinTAK und RaptorX“, mit eigenen Varianten und Plugin-Verzeichnis. Wenn Sie einen Desktop-Client für die nächsten Jahre wählen, fragen Sie zuerst, welchen Ihre Nutzer einführen werden, bevor Sie ein Plugin-Ziel festlegen.

Woher bekommt man WinTAK-Plugins

Wenn Sie bestehende WinTAK-Plugins brauchen statt eines neuen, gibt es vier Anlaufstellen:

• Der WinTAK-Installer. Optionale Plugins, die zum Build passen, sind mitgeliefert und werden beim Setup in einer Checkliste angehakt; führen Sie den Installer erneut aus und wählen Sie Modify, um weitere hinzuzufügen. Der Schnellstartleitfaden nennt Data Sync und ExCheck als Beispiele.
• Die Plugin-Listen auf tak.gov. tak.gov pflegt eine WinTAK-Plugins-Seite, und manche Plugins werden als separate .wpk-Dateien ausgeliefert. Sie brauchen ein Konto, und was Sie herunterladen dürfen, hängt von Ihrer Rolle ab.
• Hardware- und Softwarehersteller. Viele Plugins existieren, weil ein Unternehmen seinen Sensor, sein Funkgerät oder seinen Dienst in TAK haben möchte; das TAK Product Center merkt an, dass solche außerhalb von Verträgen laufenden Arbeiten (IRAD) meist den Verkauf eines verbundenen Systems zum Ziel haben.
• Community-Projekte. Die gibt es, aber deutlich weniger als für ATAK; unser Leitfaden zum Open-Source-TAK-Ökosystem behandelt, was kostenlos ist.

Das WinTAK-Benutzerhandbuch nennt drei Wege, ein Plugin zu installieren: den Plug-in Manager im Anwendungsmenü, das Ziehen einer .wpk-Datei auf das WinTAK-Fenster (Doppelklick funktioniert ebenfalls) oder die Auswahl während der WinTAK-Installation. Der Plug-in Manager bezieht Plugins aus einem lokalen Verzeichnis oder von einem Web-Update-Server, für den ein Administrator das Werkzeug wpkbuilder ausführt, um einen plugins.json-Katalog anzulegen; Plugins in einem konfigurierten lokalen Verzeichnis installieren sich beim Start von WinTAK automatisch. Zwei Prüfungen wiegen schwerer als Features: Das .wpk muss für Ihren exakten WinTAK-Build gebaut und für Ihre Variante und Ihr Netzwerk freigegeben sein.

Das WinTAK SDK: Zugang, Stack und Werkzeuge

Das WinTAK SDK stammt von tak.gov, und der Zugang hängt davon ab, wer Sie sind. Ein öffentlicher Entwickler-Workthrough von März 2025 lud das WinTAK-CIV SDK (damals Version 5.3) und Visual-Studio-Projektvorlagen (eine .vsix-Datei) aus den Entwicklerressourcen der WinTAK-CIV-Produktseite herunter. Die tak.gov-FAQ ist strenger: „Wenn Sie einen staatlichen Sponsor haben, ist Ihnen der Zugang zu den ATAK- oder WinTAK-Software-Development-Kits (SDKs) gestattet.“ Der veröffentlichte Entwicklungsprozess des TAK Product Center gibt staatlichen Entwicklern und ihren Auftragnehmern Repository-Zugang zu einem Standard SDK (Nicht-DoD-Sponsoren) oder einem Military SDK (DoD-Sponsoren). Beide enthalten Schnittstellenkontrolldokumente, Beispielquellcode und einen unverschlüsselten Entwickler-Build der Host-Anwendung, der einen „Development Build“-Wasserzeichen zeigt.

Der Stack ist klassischer Windows-Desktop, nicht modernes .NET:

• .NET Framework und C#. Plugins zielen auf das Framework des Hosts ab (4.8.1 in aktuellen Releases). Bibliotheken, die nur für .NET 6 oder 8 gebaut sind, laden nicht im Prozess; .NET-Standard-2.0-Bibliotheken schon.
• WPF und XAML für jede Ansicht, gebunden an View-Modelle.
• MEF (System.ComponentModel.Composition) für Discovery und Dependency Injection: WinTAK durchsucht Plugin-Assemblys nach exportierten, attributierten Klassen — „Konvention vor Konfiguration“, mit Worten des SDK-Leitfadens.
• Prism für Module und den Event-Aggregator.
• NuGet-Pakete mit den WinTAK-Assemblys. Ältere SDK-Leitfäden nutzten ein WinTak-Dependencies-Paket aus einem TAKMaps-Artifactory-Feed; aktuelle SDK-Installationen legen einen NuGet-Ordner in der WinTAK-Installation ab, den Sie als lokale Paketquelle hinzufügen.

Weil das Plugin innerhalb von WinTAK.exe läuft, wird eine unbehandelte Ausnahme, ein blockierter UI-Thread oder ein Speicherleck in Ihrem Code zu WinTAKs Problem — direkt vor dem Operator.

Anatomie eines WinTAK-Plugins

Ein Produktions-Plugin kombiniert mehrere Erweiterungspunkte. MEF-Attribute registrieren jeden Teil, und WinTAK erzeugt Schaltflächen und Bereiche verzögert (eine Schaltfläche beim ersten Klick, ein Bereich bei der ersten Anforderung), was den Start schnell hält.

Ein minimales Modul, das feindliche Tracks beobachtet und an ein externes System übergibt, nach dem eigenen Modulbeispiel des SDK:

using System.ComponentModel.Composition;
using Prism.Mef.Modularity;
using Prism.Modularity;
using WinTak.Common.CoT;
using WinTak.CursorOnTarget.Services;

[ModuleExport(typeof(SensorBridgeModule), InitializationMode = InitializationMode.WhenAvailable)]
public class SensorBridgeModule : IModule
{
    private readonly ICotMessageReceiver _receiver;

    [ImportingConstructor]
    public SensorBridgeModule(ICotMessageReceiver receiver)
    {
        _receiver = receiver;
    }

    public void Initialize()
    {
        _receiver.MessageReceived += OnMessageReceived;
        // start the connector to the external sensor or C2 API here, off the UI thread
    }

    private void OnMessageReceived(object sender, CoTMessageArgument e)
    {
        if (e.Type == null || !e.Type.StartsWith("a-h-"))
            return; // not ours: leave e.Handled alone so other listeners still see it

        // validate e.Uid, e.Stale and the point, then queue the track for the bridge
    }
}

Achten Sie auf das Handled-Flag: Die SDK-Referenz sagt, eine Nachricht genau dann als behandelt zu markieren, „wenn und nur wenn andere Listener diese Nachricht nicht mehr prüfen müssen“. Ein Plugin, das CoT lautlos verschluckt, beschädigt andere Plugins und Kernwerkzeuge.

Workflow der WinTAK-Plugin-Entwicklung

1. Werkzeugkette. Installieren Sie Visual Studio 2022 (Community genügt), den WinTAK-SDK-Build, der zu Ihrem Ziel-Release passt, und die WinTAK-Projektvorlagen.
2. Projekt. Starten Sie mit der WinTAK-Plugin-Vorlage oder — wie im SDK-Leitfaden — mit einer WPF User Control Library für .NET Framework 4.8.1. Fügen Sie den NuGet-Ordner des SDK als Paketquelle hinzu und pinnen Sie die Paketversionen auf den Ziel-Build.
3. Debuggen. Setzen Sie Start external program auf WinTAK.exe mit dem WinTAK-Installationsordner als Arbeitsverzeichnis, sodass F5 WinTAK mit Ihrem Plugin startet und Haltepunkte greifen; Attach to Process deckt eine laufende Instanz ab. WinTAK meldet neu gefundene Plugins beim Start; aktivieren Sie Ihres, und es erscheint auf der Registerkarte Plugins des Menübands.
4. Testen. Verbinden Sie sich mit einem Labor-TAK Server und spielen Sie aufgezeichnete CoT-Ereignisse zurück, darunter fehlerhafte und überfällige, neben dem externen Feed. Aktivieren Sie Log Debug Information (Anwendungsmenü, Support) für mehr Details.
5. Paketierung. Erzeugen Sie ein .wpk pro unterstütztem WinTAK-Build, mit Plugin-Version und Ziel-Build im Dateinamen.
6. Signierung. Signieren Sie Assemblys und Installer mit dem Code-Signaturzertifikat Ihrer Organisation; abgesicherte Arbeitsplätze mit Anwendungs-Allowlisting können unsignierten Code verweigern. Für operative Baselines beschreibt tak.gov Plugins, die über die Pipeline des TAK Product Center gebaut, signiert und verschlüsselt werden, mit einem Drittanbieter-Signaturdienst für Entwickler außerhalb von Verträgen. Klären Sie früh, welchen Weg Ihr Sponsor und Ihre Variante erwarten.
7. Verteilung. Kleine Bestände installieren über den Plug-in Manager aus einem freigegebenen Ordner; größere betreiben einen internen Update-Server oder eine geskriptete WinTAK-Installation. Der Installer unterstützt stille Installationen mit ausgewählten Komponenten (ADDLOCAL), aber der Schnellstartleitfaden warnt, dass sich diese Werte zwischen Versionen ändern können.

Was Teams als WinTAK-Plugins bauen

• Sensor- und Drohnenfeeds. Telemetrie, Sensormarkierungen und Footprints von UAS, Radaren, akustischen oder RF-Sensoren. tak.gov beschreibt, dass sein UAS Tool Position, Sensormarkierung, Sichtfeld und Video mit ATAK- und WinTAK-Geräten teilt; ein öffentlicher Workthrough von 2025 baut ein MAVLink-Positionspanel für WinTAK. Siehe Muster der Sensorintegration und Drohnentelemetrie in TAK.
• C2-Brücken. Übersetzung von Tracks, Aufträgen und Führungsmaßnahmen zwischen einem nationalen oder Koalitions-C2-System und CoT in beide Richtungen, mit einer einzigen Quelle der Wahrheit pro Datentyp.
• Datenimport und -export. WinTAK importiert bereits KML/KMZ, GPX, Shapefiles, DTED und CoT-Dateien; ein Plugin ergänzt ein proprietäres Format oder exportiert in ein Berichtssystem. Pakete folgen der Struktur von Datenpaketen und Missionspaketen.
• Missionsplanungswerkzeuge. Gitterbezugsgrafiken, Routen und Checklisten. Standard-Plugins wie GRG Builder und ExCheck decken einen Teil davon ab, daher kodiert ein eigenes Werkzeug meist eine verbandsspezifische Prozedur.
• Video. WinTAK hat einen eingebauten Videoplayer und die Anzeige von Live-Video auf der Karte; Plugins ergänzen die Steuerung von Herstellerströmen oder metadatengesteuerte Footprints. Unser Leitfaden zur TAK-Video-Integration behandelt die Stream-Seite.

WinTAK-Plugins gegen ATAK-Plugins

Beide SDKs legen ähnliche Konzepte offen (eine Karte, einen CoT-Bus, UI-Flächen, einen Importpfad), teilen aber keine Binärdateien: Eine ATAK-.apk lädt nie in WinTAK — und umgekehrt.

Muss eine Fähigkeit auf beiden Clients existieren, teilen Sie die Spezifikation statt des UI-Codes: CoT-Mappings, den Vertrag der externen API und goldene Testnachrichten, die beide Implementierungen bestehen müssen. Schwere Algorithmen können in einem nativen C- oder C++-Kern leben, der unter Android über JNI und unter Windows über P/Invoke aufgerufen wird. Unser Leitfaden zur ATAK-Plugin-Entwicklung behandelt die Android-Seite.

Absicherung von WinTAK-Plugins

Ein WinTAK-Plugin läuft mit den vollen Rechten des WinTAK-Prozesses und sieht jede CoT-Nachricht auf dem Arbeitsplatz — behandeln Sie es als Teil der vertrauenswürdigen Rechenbasis.

• Eingaben validieren. WinTAK hat das CoT, das es Ihnen übergibt, bereits geparst, aber prüfen Sie die Werte: Koordinaten außerhalb des Bereichs, veraltete Zeitstempel, unbekannte Typ-Präfixe und überlange UIDs oder Rufzeichen abweisen sowie je Quelle raten, damit ein entgleister Feed die UI nicht einfriert. Eigene Eingaben (Feeds, Dateien, API-Antworten) mit einem XmlReader und DtdProcessing.Prohibit parsen, ohne XmlResolver und mit Größenlimit. Annotierte CoT-Nachrichtenbeispiele sind gute Testfixtures.
• Minimalrechte. Operatoren sollten WinTAK als Standardnutzer ausführen. Plugin-Daten im Nutzerprofil oder im ProgramData-Ordner von WinTAK ablegen, niemals zur Laufzeit in Program Files, und nach der Installation keine Rechteanhebung verlangen. API-Zugangsdaten im Windows-Zertifikatsspeicher oder unter DPAPI verwahren, nicht im Klartext in Einstellungen.
• Keine neue Angriffsfläche. Ausgehende Verbindungen vor lokalen Listenern bevorzugen. In DoD-Programmen muss jeder Port, jedes Protokoll und jeder Dienst, den eine TAK-Anwendung nutzt, über DoD PPSM registriert sein — ein neuer Listener ist also Papierkram wie Risiko. Keine Telemetrie vom Arbeitsplatz senden.
• Kontrollierte Updates. .wpk-Dateien von einem internen HTTPS-Update-Server oder einer kontrollierten Freigabe ausliefern, die Vorgängerversion zum Rollback behalten und signieren, was Sie ausliefern. Ein Plugin-Update ist eine Codeänderung auf einem akkreditierten System.
• Bekannte Abhängigkeiten. Jedes NuGet-Paket, das Sie hinzufügen, läuft innerhalb von WinTAK: gegen die OSV-Hinweisdatenbank prüfen und eine Software-Stückliste führen. .NET-Assemblys lassen sich leicht dekompilieren — halten Sie Geheimnisse und sensible Logik aus dem Client heraus.

Zur Manipulationsresistenz auf der Android-Seite siehe Absicherung von TAK-Plugins.

Stolperfallen der WinTAK-Versionskompatibilität

• Ein Build, ein Ziel. Betrachten Sie ein .wpk nur für den WinTAK-Build als gültig, gegen den es kompiliert wurde. Wenn Nutzer von 5.8 auf 5.9 wechseln, bauen Sie gegen die 5.9-SDK-Pakete neu und testen erneut.
• Mehrere Releases pro Jahr. Das TAK Product Center arbeitet in einem 120-Tage-Entwicklungszyklus mit veröffentlichten Feature-Freezes — jedes Release braucht eine geplante Neubildung und einen Regressionsdurchlauf.
• Varianten-Mismatch. CIV- und MIL-Builds unterscheiden sich. Ein Plugin kann die von ihm bedienten Varianten (TakVariant) und die SDK-Version, mit der es gebaut wurde (TakSdkVersion), deklarieren; testen Sie auf der Variante, die Ihre Nutzer einsetzen.
• Abhängigkeits-Drift. Zielen Sie exakt auf die .NET-Framework-Version des Hosts und liefern Sie keine eigene Kopie einer Assembly, die WinTAK bereits lädt — etwa Prism — in anderer Version aus. Bindungskonflikte zeigen sich als Plugins, die still nicht laden; lesen Sie zuerst die Dateien Errors, Log und Fatal in %AppData%\WinTAK\Logs.
• TAKX. Gehen Sie nicht davon aus, dass ein WinTAK-Plugin unverändert in TAKX läuft; bis das TAK Product Center einen Migrationspfad für Ihre Variante veröffentlicht, planen Sie ein Portierungsbudget ein.

Bauen oder kaufen: schnell zu einem WinTAK-Plugin

Wenn Sie die Fähigkeit in Wochen statt Quartalen brauchen, arbeiten Sie diese Liste ab:

1. Prüfen Sie, was existiert. Sehen Sie sich die optionalen Komponenten des Installers und die WinTAK-Plugin-Liste auf tak.gov an; ein Plugin in Bundesbesitz deckt womöglich schon den Kern der Aufgabe ab.
2. Fragen Sie den Hersteller. Sensor- und C2-Hersteller liefern oft TAK-Integrationen für ihre eigenen Produkte mit.
3. Hinterfragen Sie das Plugin. Wenn Ihre Daten als CoT den TAK Server oder das lokale Netz erreichen können, zeigt WinTAK sie ohne Plugin. Bauen Sie eines für neue UI, lokale Verarbeitung, ein neues Dateiformat, Gerätesteuerung oder eine Zwei-Wege-Brücke.
4. Lebenszyklus einplanen. Planen Sie pro WinTAK-Release einen Rebuild und Regressionsdurchlauf, einen Signierungs- und Verteilungsweg passend zu Ihrer Akkreditierung und Support für jede Variante im Feld. Ein Team, das MEF-Komposition, CoT-Randfälle, Paketierung und Version-Pinning schon gelöst hat, nimmt den Großteil des Terminrisikos früh heraus.