openrocket/install4j/README.md

# OpenRocket Installer Files
Originally a separate repository of Justin Hanna's, now a directory
with its own commit history in the openrocket repository.

# OpenRocket Supported Installers
The [OpenRocket](http://www.openrocket.info) project will do its best
to publish installers for the following platforms.

* Windows, 64-bit
* macOS, 64-bit (Intel & Apple Silicon)
* Linux, 64-bit

# Maintainers
* Neil Weinstock 
* Justin Hanney
* Joe Pfeiffer
* Sibo Van Gool

# Instructions on updating the macOS drag-and-drop installer
This is an example of updating the installer from 22.02 to 23.09.beta.01:

If you use the `macOS_resources/template_dmg_rw.dmg` file, you can skip to step 4

1. Make sure install4j is not opened
2. Download the OpenRocket-22.02-macOS.dmg file 
3. Make a read/write .dmg file using the terminal command `hdiutil convert OpenRocket-22.02-macOS.dmg -format UDRW -o 22.02.beta.05_rw.dmg`

4. Enlarge the writable DMG, by first checking the current size: `hdiutil resize template_dmg_rw.dmg`, e.g. you get 430000 in the 'cur' column, then just resize it to e.g. 500000: `hdiutil resize -sectors 500000 template_dmg_rw.dmg`
5. Mount the DMG: `hdiutil attach template_dmg_rw.dmg`
6. Open the OpenRocket-disk from your desktop and change the app name from 22.02 to 23.09 
7. Copy the .DS_Store to `openrocket/install4j/23.09/macOS_resources` by running the command `cp /Volumes/OpenRocket/.DS_Store openrocket/install4j/23.09/macOS_resources/DS_Store`
8. Eject the OpenRocket DMG disk from your desktop (important step)
9. (optional) Delete `template_dmg_rw.dmg`
10. You're all done!
Add 'install4j/' from commit '5abaa6b9b3f6720cc6eba8b978efa288bf1a0b20' git-subtree-dir: install4j git-subtree-mainline: d614c77fa7cc3faf785f0a0dfccaa23b7efa2d60 git-subtree-split: 5abaa6b9b3f6720cc6eba8b978efa288bf1a0b20 2022-02-27 11:48:13 -07:00			`# OpenRocket Installer Files`
Describe as a directory under openrocket, not its own repository Add Linux to list of supoorted OSes Add myself to list of maintainers 2022-02-27 18:10:38 -07:00			`Originally a separate repository of Justin Hanna's, now a directory`
			`with its own commit history in the openrocket repository.`
Add 'install4j/' from commit '5abaa6b9b3f6720cc6eba8b978efa288bf1a0b20' git-subtree-dir: install4j git-subtree-mainline: d614c77fa7cc3faf785f0a0dfccaa23b7efa2d60 git-subtree-split: 5abaa6b9b3f6720cc6eba8b978efa288bf1a0b20 2022-02-27 11:48:13 -07:00
			`# OpenRocket Supported Installers`
Describe as a directory under openrocket, not its own repository Add Linux to list of supoorted OSes Add myself to list of maintainers 2022-02-27 18:10:38 -07:00			`The [OpenRocket](http://www.openrocket.info) project will do its best`
			`to publish installers for the following platforms.`

Add 'install4j/' from commit '5abaa6b9b3f6720cc6eba8b978efa288bf1a0b20' git-subtree-dir: install4j git-subtree-mainline: d614c77fa7cc3faf785f0a0dfccaa23b7efa2d60 git-subtree-split: 5abaa6b9b3f6720cc6eba8b978efa288bf1a0b20 2022-02-27 11:48:13 -07:00			`* Windows, 64-bit`
Prep OR for 22.02 release candidate 1 2023-01-09 08:57:16 +01:00			`* macOS, 64-bit (Intel & Apple Silicon)`
Describe as a directory under openrocket, not its own repository Add Linux to list of supoorted OSes Add myself to list of maintainers 2022-02-27 18:10:38 -07:00			`* Linux, 64-bit`
Add 'install4j/' from commit '5abaa6b9b3f6720cc6eba8b978efa288bf1a0b20' git-subtree-dir: install4j git-subtree-mainline: d614c77fa7cc3faf785f0a0dfccaa23b7efa2d60 git-subtree-split: 5abaa6b9b3f6720cc6eba8b978efa288bf1a0b20 2022-02-27 11:48:13 -07:00
			`# Maintainers`
			`* Neil Weinstock`
Describe as a directory under openrocket, not its own repository Add Linux to list of supoorted OSes Add myself to list of maintainers 2022-02-27 18:10:38 -07:00			`* Justin Hanney`
			`* Joe Pfeiffer`
Prep OR for 22.02 release candidate 1 2023-01-09 08:57:16 +01:00			`* Sibo Van Gool`
Update info for beta 04 2022-06-16 19:52:27 +02:00
			`# Instructions on updating the macOS drag-and-drop installer`
Update installer to 23.09.beta.01 2023-09-16 00:59:35 +02:00			`This is an example of updating the installer from 22.02 to 23.09.beta.01:`
Update installers for 23.09 2023-11-04 16:20:06 +01:00
			If you use the `macOS_resources/template_dmg_rw.dmg` file, you can skip to step 4

Prep OR for 22.02 release candidate 1 2023-01-09 08:57:16 +01:00			`1. Make sure install4j is not opened`
Update installer to 23.09.beta.01 2023-09-16 00:59:35 +02:00			`2. Download the OpenRocket-22.02-macOS.dmg file`
Update installers for 23.09 2023-11-04 16:20:06 +01:00			3. Make a read/write .dmg file using the terminal command `hdiutil convert OpenRocket-22.02-macOS.dmg -format UDRW -o 22.02.beta.05_rw.dmg`

Update installer to 23.09.beta.01 2023-09-16 00:59:35 +02:00			4. Enlarge the writable DMG, by first checking the current size: `hdiutil resize template_dmg_rw.dmg`, e.g. you get 430000 in the 'cur' column, then just resize it to e.g. 500000: `hdiutil resize -sectors 500000 template_dmg_rw.dmg`
			5. Mount the DMG: `hdiutil attach template_dmg_rw.dmg`
			`6. Open the OpenRocket-disk from your desktop and change the app name from 22.02 to 23.09`
			7. Copy the .DS_Store to `openrocket/install4j/23.09/macOS_resources` by running the command `cp /Volumes/OpenRocket/.DS_Store openrocket/install4j/23.09/macOS_resources/DS_Store`
Prep OR for 22.02 release candidate 1 2023-01-09 08:57:16 +01:00			`8. Eject the OpenRocket DMG disk from your desktop (important step)`
Update installers for 23.09 2023-11-04 16:20:06 +01:00			9. (optional) Delete `template_dmg_rw.dmg`
Prep OR for 22.02 release candidate 1 2023-01-09 08:57:16 +01:00			`10. You're all done!`