ATAK lisäosa

Johdanto

Tällä sivulla käsitellään lisäosan kehittämistä ja ohjelmointia. Olemassa olevista lisäosista sivulla: ATAK.

Lisäosilla voi lisätä haluttuja toimintoja ATAKiin ja yhdistää muihin sovelluksiin. Lisäosassa hyödynnetään ATKA-sovelluksen perustoimintoja tarpeen mukaan.

Omatekoista lisäosaa varten tarvitaan:

1. ATAK asennettuna päätelaitteeseen, esim. Android-puhelin
2. Android Studio tietokoneessa
3. ATAK SDK tietokoneessa
4. Lisäosan koodi, josta tehdään .apk -tiedosto ja asennetaan ATAK-päätelaitteeseen.

Lisäosaa voidaan kehittää ja testata Android Studioon asennetussa puhelimen emulaattorissa ja tarvittaessa/lopulta viedä se ATAK-päätelaitteeseen.

Android Studio

Lisäosia kehitetään Android Studion avulla.

Asennus macOS

1. Ladataan ja asennetaan Android Studio.
2. Myönnetään Android Studio.app:lle Full Disk Access: MacOS System Settings > Privacy & Security > Full Disk Access.

ATAK SDK

SDK:n avulla Android Studiossa tehdään ATAK-lisäosien kehittäminen.

1. Ladataan ja puretaan ATAK-CIV-XXX-SDK.zip: tak.gov > Login > Products > ATAK-CIV > Developer Resources > ATAK-CIV-XXX-SDK.zip > puretaan zip ja siirretään haluttuun hakemistoon omassa tiedostojärjestelmässä. Älä siirrä purettua tiedostoa tämän jälkeen toiseen kansioon!

ATAK SDK asennus emulaattoriin

• Seuraava kokoonpano toimii 12/2025

1. Tools > SDK Manager > SDK Platforms > Androis 11.0 ("R") > valitse AOSP ATD ARM 64 V8A System Image > Apply > OK
2. Tools > Device Manager > + > Create Virtual Device > Pixer 5 > Next > API: API 30 "R"; Android 11.0 > Services: Android Open Source > System Image ARM 64 v8a System Image > Additional Settings > Internal storage 8 GB > RAM 8 GB > Finish
3. Käynnistetään Pixel 5 emulaattori play-painikkeesta.
4. Ladataan tak.gov-sivulta ATAK-CIV-5.4.0.28-SDK.zip > puretaan zip-tiedosto > vedetään tiedosto atak.apk Pixel 5-ruudun päälle > avataan ATAK ja hyväksytään kaikki mitä edellytetään.
5. Jos sovellus kaatuu, eikä pysy päällä annetaan macOS pääteohjelmassa seuraavat komennot riveittäin ja käynnistetään ATAK-sovellus. Seuraavat rivit ovat erittäin tärkeitä, eikä muuta keinoa ole tähän mennessä löytynyt.

adb shell
mkdir -p /sdcard/atak
touch /sdcard/atak/opengl.broken
exit

ATAK SDK asennus Android-puhelimeen

HUOM! itse allekirjoitettuja (self-signed) lisäosia ei voi käyttää Play Storesta asennetussa ATAK-CIV-sovelluksessa. 

• Tällöin tulee asennettaessa virheilmoitus: The signature for the plugin is INVALID. ja lisäosa ei asennu.
• Perustiliin, kun tak.gov-sivustolle rekisteröidytään, ei kuulu ATAK Developer Build.
• ATAK SDK on atak.apk-tiedosto SDK-juurihakemistossa. Lähetä se sähköpostilla, siirrä Google Driven/OneDriven avulla päätelaitteeseen tai käytä Android Studion adb-komentoa pääteohjelmassa.

Rinnakkaisasennus

Tavoitteena käyttää Play Storesta asennettua ATAK-CIV -sovellusta ja tak.gov -sivuilta ladattua ATAK SDK -sovellusta samanaikaisesti samassa Android-päätelaitteessa.

• Shelter
  • Ei onnistunut asentaa F-Droid -> Shelter -sovelluksen kautta asentamalla työprofiili. ATAK-CIV-5.6.0.5-SDK.zip sisältyvä atak.apk ei asentunut Shelterin työprofiiliin. Play Storesta asennettu ATAK-CIV asentui työprofiiliin. Vaihtoehtona olisi poistaa varsinainen henkilökohtaisessa profiilissa oleva Play Storen ATAK ja yrittää asentaa siihen profiiliin SDK atak.apk. (12/2025)

• ATAK-CIV-5.6.0.5-SDK.zip sisältyvä atak.apk -paketin nimen muuttaminen ei onnistunut seuraavalla tavoin (macOS). Ilmeisesti syynä kovakoodatut viittaukset, jotka osuvat päällekkäin Play Store ATAKin kanssa. (12/2025)

1. brew install apktool
   1. apktool —version
   2. cd (vedetään tähän hakemisto Finderista, joka sisältää atak.apk -tiedoston ja painetaan enter. Odotetaan niin kauan, että menee läpi. Jos on F-Secure asennettuna, saattaa pyytää lupaa hakemistoon muutaman kerran heti alussa ponnahdusikkunoissa.
2. apktool d atak.apk -o atak_src
3. muutetaan tiedostossa atak_src/AndroidManifest.xml rivi muotoon package="com.atakmap.app.civsdk”
4. grep -rl "com/atakmap/app/civ" atak_src | xargs sed -i 's/com\/atakmap\/app\/civ/com\/atakmap\/app\/civsdk/g'
5. rm -rf atak_src/build
6. apktool b atak_src -o atak_mod.apk Jos on F-Secure asennettuna, saattaa pyytää lupaa hakemistoon, mutaman kerran ponnahdusikkunoissa.
7. keytool -genkey -v -keystore mykey.keystore -alias myalias -keyalg RSA -keysize 2048 -validity 10000 Keksi salasana, anna kysytyt tiedot ja vastaa yes
8. Asennetaan apksigner
   1. ls ~/Library/Android/sdk/build-tools/ vastaus esim. 35.0.0 36.1.0 josta lisätään seuraavaan riiviin viimeinen numerosarja.
      1. echo 'export PATH=$PATH:$HOME/Library/Android/sdk/build-tools/36.1.0' >> ~/.zshrc
   2. source ~/.zshrc
   3. apksigner --version
9. apksigner sign --ks mykey.keystore atak_mod.apk Annetaan edellä keytoolissa asetettu mykey:n salasana.