WinTAK-liitännäisen kehitys: SDK, liitännäisen rakenne ja käyttöönotto .NET-tiimeille

WinTAK-liitännäinen on .NET Framework -luokkakirjasto, joka on kirjoitettu C#:lla ja WPF:llä, jonka WinTAK löytää Managed Extensibility Frameworkin (MEF) kautta ja lataa omaan prosessiinsa. Se voi lisätä valintanauhan painikkeita, telakoitavia paneeleja, karttatyökaluja, Cursor on Target (CoT) -käsittelijöitä ja taustapalveluita. Rakennat sen Visual Studiolla WinTAK SDK:ta vasten, joka vastaa käyttäjiesi tarkkaa WinTAK-julkaisua, ja toimitat sen .wpk-pakettina.

Tämä opas on .NET-tiimeille, jotka aloittavat WinTAK-liitännäisten kehityksen, sekä ohjelmistoa hankkivalle henkilöstölle. Se täydentää meidän yleiskatsaustamme ATAK- ja WinTAK-liitännäisinsinööriin sekä WinTAKia esikunnassa. Luokka- ja rajapintanimet ovat peräisin julkaistusta WinTAK SDK -API-viitteestä ja sen oppaasta ”Extending WinTAK”; API muuttuu julkaisujen välillä, joten tarkista jokainen nimi sitä SDK-versiota vasten, jolla rakennat.

Mikä WinTAK on?

WinTAK on Team Awareness Kit (TAK) -perheen Windows-jäsen: valtion hankintavalmis (GOTS) sovellus ja karttakehys, joka käyttäjäkäsikirjansa mukaan toimii ”sekä taktisessa ympäristössä että johtamis- ja hallintaympäristössä”. Se jakaa ATAK:n ja iTAK:n kanssa CoT-tapahtumamallin (katso TAK-protokolla: CoT XML ja protobuf), yhdistyy TAK Serveriin ja käsittelee peitteitä, datapaketteja, videota ja keskustelua. Allekirjoitetut WinTAK-asennukset nimeävät PAR Governmentin varmennetuksi julkaisijaksi, ja uusimmat 5.x-julkaisut tähtäävät .NET Framework 4.8.1:een 64-bittisessä Windowsissa.

tak.govin tuotesivut listaavat kaksi WinTAK-tuoteperhettä. WinTAK-CIV, ”Windows OS Team Awareness Kit for Civilians”, on versio, joka saadaan rekisteröitymällä tak.goviin; TAK-CIV-binäärit tulevat julkisiksi hyväksynnän jälkeen pois lukien embargomaat ja Denied Persons List -osapuolet. WinTAK-MIL (Windows Tactical Assault Kit) on rajoitettu Yhdysvaltain sotilaskäyttöön, ja vieraat hallitukset saavat TAK-MIL:ää vain Foreign Military Sales -kanavan kautta. tak.gov luokittelee ATAK-CIV:n EAR99:ksi mutta toteaa muiden TAK-CIV-tuoteperheiden olevan vielä arvioinnissa, joten älä oleta WinTAK-CIV:llä olevan sama luokitus. Käyttö testauksen ja arvioinnin ulkopuolella vaatii organisaatiosi toimiluvan (ATO).

WinTAKin versionumerot seuraavat ATAK:ia. Julkinen tak.govin julkaisuaikataulu listaa WinTAK 5.8:n elokuulle 2026 ja 5.9:n joulukuulle 2026, kummallekin ominaisuusjäädytys kuukautta aiemmin. tak.gov listaa myös TAKX:n, ”kahden johtavan windowspohjaisen johtamis- ja hallintaympäristön, WinTAKin ja RaptorX:n, yhteenvedon”, omilla varianteillaan ja liitännäislistauksellaan. Jos valitset työpöytäasiakasta seuraaviksi vuosiksi, kysy ensin, kumman käyttäjäsi ottavat kentälle, ennen kuin lukitset liitännäisen kohteen.

Mistä saa WinTAK-liitännäisiä

Jos tarvitset olemassa olevia WinTAK-liitännäisiä etkä uutta, katso neljästä paikasta:

• WinTAK-asennusohjelma. Käännöstä vastaavat valinnaiset liitännäiset tulevat mukana ja rastitetaan tarkistuslistalta asennuksen aikana; aja asennus uudelleen ja valitse Modify lisätäksesi muita. Pikaopas käyttää Data Synchia ja ExCheckiä esimerkkeinä.
• tak.govin liitännäislistaukset. tak.gov ylläpitää WinTAK-liitännäissivua, ja osa liitännäisistä toimitetaan erillisinä .wpk-tiedostoina. Tarvitset tilin, ja ladattavissa oleva määrä riippuu roolistasi.
• Laitteisto- ja ohjelmistotoimittajat. Monet liitännäiset syntyvät, koska yritys haluaa anturinsa, radionsa tai palvelunsa TAK:iin; TAK Product Center toteaa, että tällainen sopimusten ulkopuolinen työ (IRAD) tähtää yleensä liittyvän järjestelmän myyntiin.
• Yhteisöprojektit. Niitä on, mutta selvästi vähemmän kuin ATAK:ille; avoimen TAK-ekosysteemin oppaamme kattaa ilmaisen.

WinTAKin käyttäjäkäsikirja listaa kolme tapaa asentaa liitännäinen: Plug-in Manager sovellusvalikossa, .wpk-tiedoston raahaus WinTAK-ikkunaan (kaksoisnapsautuskin toimii) tai valinta WinTAK-asennuksen aikana. Plug-in Manager hakee liitännäisiä paikallisesta hakemistosta tai verkon päivityspalvelimelta, jota varten ylläpitäjä ajaa wpkbuilder-työkalun luomaan plugins.json-luettelon; määritettyyn paikallishakemistoon asetetut liitännäiset asentuvat automaattisesti WinTAKin käynnistyessä. Kaksi tarkistusta painavat enemmän kuin ominaisuudet: .wpk on rakennettava täsmälleen käännöksesi varaan ja se on oltava hyväksytty variantillesi ja verkollesi.

WinTAK SDK: pääsy, pino ja työkalut

WinTAK SDK tulee tak.govista, ja pääsy riippuu siitä, kuka olet. Julkinen maaliskuun 2025 kehittäjähavainnointi latasi WinTAK-CIV SDK:n (silloin versio 5.3) ja Visual Studion projektipohjat (.vsix-tiedosto) WinTAK-CIV-tuotesivun kehittäjäresursseista. tak.govin UKK on tiukempi: ”Jos sinulla on valtion tukija, sinulla on pääsy ATAK- tai WinTAK-ohjelmistokehityspaketteihin (SDK).” TAK Product Centerin julkaistu kehitysprosessi antaa valtion kehittäjille ja heidän alihankkijoilleen pääsyn Standard SDK:n (ei-DoD-tukijat) tai Military SDK:n (DoD-tukijat) repositorioihin. Molemmat sisältävät rajapintojen valvontadokumentit, esimerkkilähdekoodin ja avaimettoman kehityskäännöksen isäntäsovelluksesta, joka näyttää ”Development Build”-vesileiman.

Pino on klassinen Windows-työpöytä, ei moderni .NET:

• .NET Framework ja C#. Liitännäiset tähtäävät isännän kehykseen (4.8.1 uusimmissa julkaisuissa). Vain .NET 6:lle tai 8:lle kootut kirjastot eivät lataudu prosessiin; .NET Standard 2.0 -kirjastot latautuvat.
• WPF ja XAML jokaiseen näkymään, sidottuina näkymämalleihin.
• MEF (System.ComponentModel.Composition) löytämiseen ja riippuvuusinjektioon: WinTAK skannaa liitännäiskokoonpanot vieduistä, attribuutoiduista luokista — ”konventio ennen konfiguraatiota”, SDK-opaan sanoin.
• Prism moduuleille ja tapahtuma-aggregaattorille.
• NuGet-paketit, jotka sisältävät WinTAK-kokoonpanot. Vanhemmat SDK-oppaat käyttivät WinTak-Dependencies-pakettia TAKMaps Artifactory -syötteestä; nykyiset SDK-asennukset asettavat NuGet-kansion WinTAK-asennukseen, jonka lisäät paikalliseksi pakettilähteeksi.

Koska liitännäinen toimii WinTAK.exe:n sisällä, käsittelemätön poikkeus, tukittu UI-säie tai muistivuoto koodissasi muuttuu WinTAKin ongelmaksi operaattorin silmien edessä.

WinTAK-liitännäisen anatomia

Tuotantoliitännäinen yhdistää useita laajennuspisteitä. MEF-attribuutit rekisteröivät jokaisen osan, ja WinTAK luo painikkeet ja paneelit laiskasti (painikkeen ensimmäisellä napsautuksella, paneelin ensimmäisellä pyynnöllä), mikä pitää käynnistymisen nopeana.

Minimaalinen moduuli, joka tarkkailee vihamielisia jälkiä ja välittää ne ulkoiselle järjestelmälle, SDK:n oman moduuliesimerkin mukaisesti:

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
    }
}

Huomioi Handled-lippu: SDK-viite kehottaa merkitsemään viestin käsitellyksi ”jos ja vain jos muiden kuuntelijoiden ei tarvitse tarkastella sitä”. Liitännäinen, joka nielee CoT:n hiljaa, rikkoo muita liitännäisiä ja perustyökaluja.

WinTAK-liitännäisen kehityksen työnkulku

1. Työkaluketju. Asenna Visual Studio 2022 (Community riittää), kohdejulkaisua vastaava WinTAK SDK -käännös ja WinTAK-projektipohjat.
2. Projekti. Aloita WinTAK-liitännäispohjasta tai WPF User Control Library -kirjastosta, joka tähtää .NET Framework 4.8.1:een, kuten SDK-opas tekee. Lisää SDK:n NuGet-kansio pakettilähteeksi ja kiinnitä pakettiversiot kohdekäännökseen.
3. Debuggaus. Aseta Start external program kohteeseen WinTAK.exe ja työhakemistoksi WinTAK-asennuskansio, jolloin F5 käynnistää WinTAKin liitännäisesi kanssa ja keskeytyskohdat toimivat; Attach to Process kattaa käynnissä olevan instanssin. WinTAK ilmoittaa uusista liitännäisistä käynnistyksessä; ota omasi käyttöön ja se ilmestyy valintanauhan Plugins-välilehdelle.
4. Testaus. Yhdistä laboratorio-TAK Serveriin ja toista nauhoitettuja CoT-viestejä, mukaan lukien vioittuneet ja vanhentuneet tapahtumat, ulkoisen syötteen rinnalla. Rastita Log Debug Information (sovellusvalikko, Support) saadaksesi lisätietoja.
5. Paketointi. Tuota .wpk jokaista tuettua WinTAK-käännöstä kohden, liitännäisen version ja kohdekäännöksen tiedostonimessä.
6. Allekirjoitus. Allekirjoita kokoonpanot ja asennusohjelmat organisaatiosi koodin allekirjoitusvarmenteella; lukitut työasemat sovellusten sallittujen luetteloiden kanssa voivat kieltäytyä allekirjoittamattomasta koodista. Operatiivisiin peruslinjoihin tak.gov kuvaa liitännäisiä, jotka rakennetaan, allekirjoitetaan ja avainnetaan TAK Product Centerin putken kautta kolmannen osapuolen allekirjoituspalvelulla sopimusten ulkopuolisille kehittäjille. Vahvista ajoissa, mitä polkua tukijasi ja varianttisi odottavat.
7. Jakelu. Pienet laivueet asentavat jaetusta kansiosta Plug-in Managerilla; suuremat pyörittävät sisäistä päivityspalvelinta tai skriptattua WinTAK-asennusta. Asennusohjelma tukee hiljaisia asennuksia valituilla komponenteilla (ADDLOCAL), mutta pikaopas varoittaa näiden arvojen muuttuvan versioiden välillä.

Mitä tiimit rakentavat WinTAK-liitännäisinä

• Anturi- ja droonisyötteet. Telemetria, anturin kiintopisteet ja jäljet lennokeilta (BPA:ilta), tutkilta, akustisilta tai RF-antureilta. tak.gov kuvaa UAS Tool -työkalunsa jakavan sijainnin, anturin kiintopisteen, näkökentän ja videon ATAK- ja WinTAK-laitteiden kanssa; vuoden 2025 julkinen läpikäynti rakentaa MAVLink-sijaintipaneelin WinTAKille. Katso anturiintegraation mallit ja droonitelemetria TAK:ssa.
• C2-sillat. Jälkien, tehtävien ja johtamismerkintöjen kääntäminen kansallisen tai koalition C2-järjestelmän ja CoT:n välillä molempiin suuntiin, yksi totuuden lähde per tietotyyppi.
• Datan tuonti ja vienti. WinTAK tuo jo KML/KMZ-, GPX-, shapefile-, DTED- ja CoT-tiedostot; liitännäinen lisää omisteisen muodon tai vie raportointijärjestelmään. Paketit noudattavat datapakettien ja tehtäväpakettien rakennetta.
• Tehtävän suunnittelutyökalut. Ruudukkoviittausgrafiikka GRG, reitit ja tarkistuslistat. Vakiotyökalut kuten GRG Builder ja ExCheck kattavat osan tästä, joten räätälöity työkalu yleensä koodaa joukko-osastokohtaisen menettelyn.
• Video. WinTAKissa on sisäänrakennettu videosoitin ja livevideon karttanäyttö; liitännäiset lisäävät valmistajan virtauksen hallintaa tai metadatan ohjaamia jälkiä. TAK-videointegraation oppaamme kattaa virtauspuolen.

WinTAK- ja ATAK-liitännäiset vertailuna

Molemmat SDK:t paljastavat samankaltaisia ideoita (kartta, CoT-väylä, UI-pinnat, tuontipolku), mutta eivät jaa binäärejä: ATAKin .apk ei koskaan lataudu WinTAKiin — eikä päinvastoin.

Jos kyvyn on oltava molemmissa asiakkaissa, jaa spesifikaatio eikä UI-koodia: CoT-kartoitukset, ulkoisen API:n sopimus ja kultaiset testiviestit, jotka molempien toteutusten on läpäistävä. Raskaat algoritmit voivat elää natiivissa C- tai C++-ytimessä, jota kutsutaan JNI:llä Androidissa ja P/Invokella Windowsissa. ATAK-liitännäisen kehitysoppaamme kattaa Android-puolen.

WinTAK-liitännäisten tietoturvan vahvistaminen

WinTAK-liitännäinen toimii WinTAK-prosessin täysillä oikeuksilla ja näkee jokaisen CoT-viestin työasemalla, joten kohtele sitä luotetun laskentapohjan osana.

• Validoi syötteet. WinTAK on jo jäsennyt sinulle antamansa CoT:n, mutta tarkista arvot: hylkää alueen ulkopuoliset koordinaatit, menneisyydessä olevat vanhentuneet aikaleimat, tuntemattomat tyyppietuliitteet ja ylisuuret UID:t tai kutsutunnukset, ja rajoita taajuutta lähdettä kohden, jotta yksi karkaava syöte ei jäädytä UI:ta. Jäsennä omat syötteesi (virrat, tiedostot, API-vastaukset) XmlReaderilla asetuksella DtdProcessing.Prohibit, ilman XmlResolveria ja kokorajalla. Kommentoidut CoT-viestiesimerkit ovat hyviä testikiinnikkeitä.
• Vähimmäisoikeudet. Operaattoreiden tulisi ajaa WinTAK tavallisina käyttäjinä. Kirjoita liitännäisen data käyttäjäprofiilin tai WinTAKin ProgramData-kansioon, ei koskaan ajon aikana Program Files -kansioon, äläkä vaadi oikeuksien korotusta asennuksen jälkeen. Pidä API-tunnukset Windowsin varmennesarjassa tai DPAPI:n alla, ei selkokielisinä asetuksina.
• Ei uutta hyökkäyspintaa. Suosi lähteviä yhteyksiä paikallisiin kuuntelijoihin nähden. DoD-ohjelmissa jokainen TAK-sovelluksen käyttämä portti, protokolla ja palvelu on rekisteröitävä DoD PPSM:n kautta, joten uusi kuuntelija on sekä paperityötä että riski. Älä lähetä telemetriaa pois työasemalta.
• Ohjatut päivitykset. Tarjoa .wpk-tiedostot sisäiseltä HTTPS-päivityspalvelimelta tai hallitusta jaosta, säilytä edellinen versio palautusta varten ja allekirjoita toimittamasi. Liitännäisen päivitys on koodimuutos akkreditoidussa järjestelmässä.
• Tunnetut riippuvuudet. Jokainen lisäämäsi NuGet-paketti toimii WinTAKin sisällä: tarkista se OSV-neuvotietokantaa vasten ja pidä ohjelmiston osaluettelo. .NET-kokoonpanot dekompiloituvat helposti, joten pidä salaisuudet ja arkaluonteinen logiikka pois asiakkaasta.

Suojausta manipulaatiota vastaan Androidin puolella katso TAK-liitännäisten tietoturvan vahvistaminen.

WinTAK-versioiden yhteensopivuuden sudenkuopat

• Yksi käännös, yksi kohde. Pidä .wpk:tä voimassa vain sille WinTAK-käännökselle, jota vasten se käännettiin. Kun käyttäjät siirtyvät 5.8:sta 5.9:ään, käännä uudelleen 5.9 SDK -paketteja vasten ja testaa uudelleen.
• Useita julkaisuja vuodessa. TAK Product Center toimii 120 päivän kehityssyklissä julkaistuine ominaisuusjäädytyksineen, joten jokainen julkaisu vaatii suunnitellun uudelleenkääntämisen ja regressioläpikäynnin.
• Varianttien ero. CIV- ja MIL-käännökset eroavat. Liitännäinen voi ilmoittaa variantit, joihin se tähtää (TakVariant), ja SDK-version, jolla se on rakennettu (TakSdkVersion); testaa variantilla, jota käyttäjäsi ajavat.
• Riippuvuuksien ajautuminen. Tähtää täsmälleen isännän .NET Framework -versioon äläkä toimita omaa kopiota kokoonpanosta, jonka WinTAK jo lataa, kuten Prism, eri versiossa. Sidoskonfliktit näkyvät liitännäisinä, jotka eivät lataudu hiljaisesti; lue ensin tiedostot Errors, Log ja Fatal hakemistosta %AppData%\WinTAK\Logs.
• TAKX. Älä oleta WinTAK-liitännäisen toimivan muuttumattomana TAKX:ssä; kunnes TAK Product Center julkaisee siirtymäpolun variantillesi, varaa budjetti porttaukselle.

Rakenna vai osta: WinTAK-liitännäinen nopeasti

Jos kyky tarvitaan viikoissa eikä vuosineljänneksissä, käy tämä lista läpi:

1. Tarkista olemassa oleva. Käy läpi asennusohjelman valinnaiset komponentit ja tak.govin WinTAK-liitännäislistaus; valtion omistama liitännäinen voi jo kattaa työn ytimen.
2. Kysy toimittajalta. Anturi- ja C2-toimittajat toimittavat usein TAK-integraatioita omille tuotteilleen.
3. Kyseenalaista liitännäinen. Jos datasi saavuttaa TAK Serverin tai paikallisverkon CoT:na, WinTAK näyttää sen ilman liitännäistä. Rakenna sellainen uudelle käyttöliittymälle, paikalliselle käsittelylle, uudelle tiedostomuodolle, laitteiden hallinnalle tai kaksisuuntaiselle sillalle.
4. Budjetoij elinkaari. Suunnittele uudelleenkäännös ja regressioläpikäynti per WinTAK-julkaisu, akkreditointiisi sopiva allekirjoitus- ja jakelupolku sekä tuki jokaiselle kentällä olevalle variantille. Tiimi, joka on jo ratkaissut MEF-koosteen, CoT-reunatapaukset, paketoinnin ja versiokiinnityksen, poistaa suurimman osan aikatauluriskistä ajoissa.