-
Notifications
You must be signed in to change notification settings - Fork 0
Developer Notes
The .app will be created by the Platypus command line tool. Platypus is a great tool to create Mac apps from command line scripts. Go to https://sveinbjorn.org/platypus, download and open Platypus, select "Settings..." from the Platypus menu and install the command line tool.
You need to install resp. update the Platypus command line tool explicitly. Open the Platypus app, go to Platypus, select Settings..., and update or install the command line tool.
Clone or download the sources from the GitHub project:
% git clone https://github.com/jonelo/jacksum-for-macos.git
% cd jacksum-for-macos/
Note: if you haven't installed git yet, Apple's Install Command Line Developer Tools will install it for you.
Open a Terminal and run
% ./bin/make_all.sh
That will build the .app and wrap it in a .dmg. You find both the .app and the .dmg in the folder called ./output/.
% open ./output/*.dmg
update config/update_app.cfg and run bin/update_app.sh
update config/update_jres.cfg and run bin/update_jres.sh
vi config/make_all.cfg
and change
APP_VERSION=3.7.0 <-- jacksum version
DMG_VERSION=2.4.0 <--- installer version
vi config/make_app.cfg
and change
APP_JAR_FILE_HASHGARTEN=...
APP_JAR_FILE_FLATLAF=...
vi resources/app/HashGarten.app/Contents/MacOS/bin/jacksum.sh
and change
HASHGARTEN_JAR=...
JACKSUM_JAR=...
and any other comment/code you want to change (Copyright year,
vi resources/app/HashGarten.app/Contents/MacOS/bin/launcher
and change
MAIN_JAR="HashGarten...
vi resources/app/install.command
and change
JACKSUM_VERSION=...
and any other old version number to the new one.
- Google Chrome
- GitHub Markdown Printer
% ./bin/make_all.sh
Finder will show the artefakt.
- Open the .dmg
- Select the Jacksum ... for macOS icon
- Type Fn+Blank on the keyboard
- Cmd+Shift+4, blank, mouse left click to store a picture
- Open the screenshot (it is stored on the Desktop) and copy the image
- Open Google Chrome
- Go to https://github.com/jonelo/jacksum-for-macos
- Edit the GitHub markup page
- Paste the new image and remove the old one
- Make other changes such as updating the verison number, updating other screenshots where the version number is visible
- Save the markup
- Print the Markup page using GitHub Markdown Printer (GMP)
- Save the pdf to
resources/dmg/readme.pdf
vi resources/dmg/release_notes.txt
% ./bin/make_all.sh
The core of the Jacksum for macOS.app is a bash script that installs both HashGarten and Jacksum to the Finder's Script Menu (and other file managers it can detect) by creating applescript scripts (in case of Finder and Path Finder), and compiling those on the system during the installation using osacompile.
The installation script requires Mac OS X 10.4 (Tiger) or later to run. The script does not require admin privileges. Credits: the installer app has been created by Platypus, a great app to wrap shell scripts into a macOS app.
Once the script has been compiled by Platypus, the installer app requires macOS 11 (Big Sur) or later. The script source can be revealed again by typing
% cd /Volumes/Jacksum\ for\ macOS/
% cat ./Jacksum\ 4.0.0\ for\ macOS.app/Contents/Resources/script
The source code of the generated and compiled applescripts can be relealed again by opening the .scpt files (located in the appropriate script folders) using the Apple Script Editor or osadecompile.