Provide compiled binaries as GitHub releases assets

Author: Steffen

ChangeLog.md

@@ -1,6 +1,6 @@
 ## ChangeLog
 
-## 0.8.2 nightly
+## 0.8.2 - 2025/08/08
 
 ### Changed
 * Switch to SDK-B288-6.8
@@ -13,6 +13,7 @@
 * Remove unused infrastructure to print a game
 * Remove unused cursor controls infrastructure
 * Remove unused debug statements
+* Provide compiled binaries now as GitHub releases assets
 
 ### Added
 * Supports dark mode on firmware >= 6.8 devices

DOWNLOAD.md

@@ -0,0 +1,32 @@
+## Pre-compiled app binaries
+
+You can find pre-compiled binaries ready for installation here.
+
+* [V0.8.2 (latest stable)](https://github.com/SteffenBauer/PocketPuzzles/releases/download/0.8.2/SGTPuzzles.app.zip)
+* [V0.8.1](https://github.com/SteffenBauer/PocketPuzzles/releases/download/0.8.1/SGTPuzzles.app.zip)
+* [V0.8.0](https://github.com/SteffenBauer/PocketPuzzles/releases/download/0.8.0/SGTPuzzles.app.zip)
+* [V0.7.11](https://github.com/SteffenBauer/PocketPuzzles/releases/download/0.7.11/SGTPuzzles.app.zip)
+* [V0.7.10](https://github.com/SteffenBauer/PocketPuzzles/releases/download/0.7.10/SGTPuzzles.app.zip)
+* [V0.7.9](https://github.com/SteffenBauer/PocketPuzzles/releases/download/0.7.9/SGTPuzzles.app.zip)
+
+### Installation
+
+Download `SGTPuzzles.app.zip` from one of the above links. Unzip the file. Connect your PocketBook to your PC with an USB cable. Copy `SGTPuzzles.app` to the folder `/applications` on your device. Unmount the USB connection, and reboot the PocketBook. You should now see an entry `@SGTPuzzles` among your apps.
+
+### Upgrading
+**Important notes on upgrading the app**
+
+#### From version lower than 0.7.12
+In the nightly release and upcoming stable releases (0.7.12 and higher) the *loopy* puzzle will not contain all grid types anymore. The app may crash when trying to launch a *loopy* game configured to one of the unsupported grid types.
+
+To prevent a crash, configure the *loopy* game to a *squares* grid type before upgrading.
+
+#### From version lower than 0.8.2
+In the nightly version and stable versions >= 0.8.2, I switched to compile with the current SDK 6.8, which only supports devices with firmware 6. For devices with firmware 5, install 0.8.1.
+
+### Important Note!
+
+Lots of hacking and reverse-engineering, as documentation for PocketBook app development is very, very sparse.
+
+Build and installation is completely **on your own risk**! You must be aware that this software could brick your device.
+

README.md

@@ -6,7 +6,7 @@ Port of [Simon Tatham's Portable Puzzle Collection](http://www.chiark.greenend.o
 
 [More screenshots](https://github.com/SteffenBauer/PocketPuzzles/blob/master/screenshots/screenshots.md)
 
-[**Download the app here**](https://github.com/SteffenBauer/PocketPuzzles/blob/master/release/README.md)
+[**Download the app here**](https://github.com/SteffenBauer/PocketPuzzles/blob/master/DOWNLOAD.md)
 
 Inspired by and building on the work of [Port to Android by Chris Boyle](https://github.com/chrisboyle/sgtpuzzles) and [Puzzles for pocketbook by mnk](https://github.com/svn2github/pocketbook-free/tree/master/puzzles)
 
@@ -41,7 +41,7 @@ I'm interested in reports from more devices; especially how it looks like on col
 
 ### Binary app ready to install
 
-See here [release/README.md](https://github.com/SteffenBauer/PocketPuzzles/blob/master/release/README.md) for already compiled app files ready for installation on a PocketBook Firmware 5 and higher device.
+See here [DOWNLOAD.md](https://github.com/SteffenBauer/PocketPuzzles/blob/master/DOWNLOAD.md) for already compiled app files ready for installation on a PocketBook Firmware 5 and higher device.
 
 **Memory usage**: The app itself is around 1.5 MB. It additionally stores the game preferences and the status of the last played game in a separate configuration file, which is usually less than 100 KB. So in total the app will take the space of a few eBooks.