JAL-3577 Added existing and new Application IDs for Windows. Fixed Desktop shortcut...
[jalview.git] / utils / install4j / DMG_creation_README.md
index b03657a..e6511c9 100644 (file)
@@ -1,22 +1,38 @@
-## ALSO SEE https://www.ej-technologies.com/resources/install4j/help/doc/#install4j.concepts.dmgStyling
+# Information for making the DMG
 
-cp ../../build/install4j/11/Jalview-OFFLINE_macos-app_DEVELOPMENT-j11.dmg ./temp.dmg
+## How to make the DS_Store file needed for the DMG prettification
+
+> ALSO SEE https://www.ej-technologies.com/resources/install4j/help/doc/concepts/dmgStyling.html
+
+First create a dmg with no DS_Store (or an existing one if you just want to edit one)
 
+```
+cp ../../build/install4j/11/Jalview-OFFLINE_macos-app_DEVELOPMENT-j11.dmg ./temp.dmg
 hdiutil convert temp.dmg -format UDRW -o temp_rw.dmg
+```
 
-CURSIZE=`hdiutil resize temp_rw.dmg | perl -n -e 'm/^\s*\d+\s+(\d+)\s+\d+$/ && print "$1\n";'`
+If you are creating a new dmg, or want to add more files than remaining space, then you will need to add some capacity to the dmg.  If you're just doing small edits then you might get away without the following block of commands used to resize the dmg.
 
+```
+CURSIZE=`hdiutil resize temp_rw.dmg | perl -n -e 'm/^\s*\d+\s+(\d+)\s+\d+$/ && print "$1\n";'`
 NEWSIZE=$(( CURSIZE + 20000))
-
 hdiutil resize -sectors $NEWSIZE temp_rw.dmg
-
+```
+Continue by opening the dmg in Finder.  The `/Volumes/...` folder will depend on the dmg you're editing.
+```
+open temp_rw.dmg
 open /Volumes/Jalview\ Installer
+```
 
+Then manually position/resize icons, extend size of Finder window, etc so that the Finder window looks how you want it.
+You can use the
 
-### Position/resize icons, extend size of Finder window, etc
-
-
+```
 cp /Volumes/Jalview\ Installer/.DS_Store ./DS_Store_N
 
 umount /Volumes/Jalview\ Installer
+```
+
+## Background image
 
+See file `DMG_background_image_creation_README.md` on how to create the background image.