DX HUNTER — RELEASE 1.0 SOURCE
==============================

DX Hunter V6.3
Release 1.0
© 2026 Steve MacDonald-Brown (M7SQI)

This archive contains the corresponding source and build material for the
Linux, Windows and Android editions of DX Hunter 1.0.

LICENCE
-------
DX Hunter is free software released under the GNU General Public License
version 3 (GPLv3).

See:
    LICENSE
    THIRD_PARTY_LICENSES.txt

Separate commercial/proprietary licensing may also be available from the
copyright holder.

SOURCE LAYOUT
-------------
src/dx_hunter.py
    Python / pywebview desktop application wrapper.

src/web/
    Common desktop HTML/CSS/JavaScript game source and runtime assets.

build_linux.sh
    Linux PyInstaller build script.

build_windows.bat
    Windows PyInstaller build script.

install.sh
    Linux release installation script.

requirements-linux.txt
    Python dependencies used by the Linux desktop build.

android/
    Android / Capacitor source project.

android/www/
    Android edition of the web game.

android/android/
    Native Android / Gradle project generated for Capacitor.

The Android web edition differs slightly from the desktop edition because
it accesses the live conditions service through Capacitor's native HTTP
support rather than the desktop Python proxy.

LINUX BUILD
-----------
A recent Python 3 installation with venv support is required.

From the source archive root:

    chmod +x build_linux.sh
    ./build_linux.sh

The resulting application is created under:

    dist/DX-Hunter/

WINDOWS BUILD
-------------
Build on a Windows system with Python 3 installed.

From the source archive root:

    build_windows.bat

The resulting application is created under:

    dist\DX-Hunter\

ANDROID BUILD
-------------
Requirements used for DX Hunter 1.0:

    Node.js 22 or later
    npm
    JDK 21
    Android SDK / API 36

From:

    android/

install the JavaScript dependencies:

    npm ci

Synchronise the Capacitor Android project:

    npx cap sync android

Then:

    cd android
    ./gradlew assembleDebug

The debug APK is created under:

    app/build/outputs/apk/debug/

For release builds:

    ./gradlew assembleRelease bundleRelease

Release signing credentials are deliberately NOT included in this source
archive. A distributor must provide their own signing key and local
keystore.properties file.

SAVED DATA
----------
Desktop editions store user data in the platform's normal local
application-data directory.

The Android edition stores its application data using the Android WebView /
application storage facilities.

NETWORK FEATURES
----------------
Internet access is used for:

- OpenStreetMap map tiles
- Live propagation / solar-condition information from macalchemist.net

The game itself and its primary runtime assets are bundled locally.

CONTACT
-------
Bug reports, feedback or propagation anomalies:

    DX-Hunter [at] macalchemist [dot] net

73

Steve MacDonald-Brown
M7SQI
