#
# Hinweise für das THP
#
# $Id$
# $HeadURL$
# $Author$
#
N. Thoden, 12.03.2020
Das TakeHomePackage (für Windows) besteht aus 3 Komponenten:
============================================================
1) den THP-Viewer / THP-Starter
(inkl. Qt ; ohne MSVCRuntime, z.B. msvcr120.dll, in C:\Windows\system32 !?)
http://jenkins-master.sl.defence-elec.de:8080/job/ahtc_OC-Tablet/
thp.tgz
2) die Kartendaten
(evtl. für den Datenträger reduziert in Bezug auf die Speichergröße)
3) die Topic-Daten (Video, Audio, DB-Abzug...)
Woher kommt was?
================
1) Der THP-Viewer / THP-Starter
Kann aus der CI-Umgebung (Jenkins) heruntergeladen werden (thp.tgz)
Am besten mit 7Zip entpackt werden:
(tgz -> gepackt und anschliessend komprimiert)
- Per Kontext-Menue "entpacken nach hier"
- die resultierende Datei "thp' "entpacken nach thp~".
Dann sollte ein Verzeichnis "thp" MIT diversen Unterverzeichnissen entstehen.
Das THP-Verzeichnis wird auf jeder Workstation im Ordner /opt/THP als Quelle für den USB-Datentraeger bereitgestellt.
2) Diese werden manuell für das THP bereitgestellt (meist als tpk-Datei).
3) Die Topic-Daten werden in der OpApp mit "Präsentation exportieren" erzeugt.
Sie werden unter /tmp/THP-Export generiert.
Woher kommt das Verzeichnis 'Maps'?
===================================
Der Verzeichnisname 'Maps' ist fest und darf nicht verändert werden.
Es müssen die für das Medium (CD, DVD, Stick..) passenden Basiskarten/Kartendaten hinein.
Das sind also z.B.
- 2020-03-03_UaeAerial_32639_Lvl6.tpk
- 2020-03-03_UaeAerial_WebMerc_Lvl15.tpk
- 2020-03-03_UaeTopo_32639_Lvl6.tpk
- 2020-03-03_UaeTopo_WebMerc_Lvl15.tpk
- AHTC_utm_dgm_surface_wgs84.tif
Das layerMapping.json hat nun die Aufgabe, diese (für das Übungsgebiet) spezifischen
Dateinamen zu abstrahieren.
Die bei der Ausführung des THPs geforderten Basiskarten (Annahme: eine Topo und zwei Aerial)
können mit Hilfe der layerMapping.json auf eine geringere Anzahl Dateien gemappt werden.
Basiskarten: Mapping per layerMapping.json
in der WS-App: Dateien in Dir 'Maps'
-------------- ---------------------
- Aerial2 -> 2020-03-03_UaeAerial_32639_Lvl6.tpk
- Aerial1 -> 2020-03-03_UaeAerial_32639_Lvl6.tpk
- Topo -> 2020-03-03_UaeTopo_32639_Lvl6.tpk
Best Practise:
Daher ergibt es Sinn, eine layerMapping.json in dem Verzeichnis 'Maps' vorzubereiten
und beim Zusammengefügen in die darüberliegende Dateiebene zu kopieren.
Wie müssen die 3 Komponenten zusammengefügt werden?
===================================================
Device:
- Excersise_6
- 1 <- Übungsdaten (Komponenten 3)
- ...
- index.html <- Übungsdaten (Komponenten 3)
- ... <- Übungsdaten (Komponenten 3)
- Maps <- Kartendaten (Komponenten 2)
- *.tpk
- [layerMapping.json] <- Sonderfall AHTC 03/2020: Diese Datei in
die darüberliegende Ebenen verschieben.
- layerMapping.json <- Übungsdaten (Komponenten 2/3)
(generiert, Sonderfall AHTC 03/2020:
aus 'Maps' hierher transferieren)
- thp <- thp (Komponenten 1)
- resources <- thp (Komponenten 1), hat mal gefehlt)
- thv_viewer.exe <- thp (Komponenten 1)
- vc.redist.x64.exe <- thp (Komponenten 1), für MSVCRuntime
- thp_starter.exe <- thp (Komponenten 1)
- autorun.inf <- thp (Komponenten 1)
- [wappen.png] <- thp (Komponenten 1 oder 3) optional !?
Logfiles zuir Fehlersuche
=========================
Ein Logfile befindet sich unter ~Benutzer\AppData\Local\Temp\.
Bsp: C:\User\thoden\AppData\Local\Temp\thoden_thp.log
C:\User\thoden\AppData\Local\Temp\thoden_thp.log.1