JAL-3577 cleaned up old DMG files. Added NON-RELEASE DMG files. Changed how Jalview...
[jalview.git] / utils / install4j / DMG_creation_README.md
index eeb10d4..e6511c9 100644 (file)
@@ -4,23 +4,28 @@
 
 > 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
+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
 
 ```
 cp /Volumes/Jalview\ Installer/.DS_Store ./DS_Store_N
@@ -30,12 +35,4 @@ umount /Volumes/Jalview\ Installer
 
 ## Background image
 
-The vector version of this is made in Adobe Illustrator and saved as the pdf jalview_dmg_background_layers.pdf
-
-This is then exported as 300dpi PNG to jalview_dmg_background_large.png
-
-This is then converted to the right size, with DPI information removed with ImageMagick
-
-```
-convert -geometry 500x461 utils/install4j/jalview_dmg_background_large.png  -strip  utils/install4j/jalview_dmg_background.png
-```
+See file `DMG_background_image_creation_README.md` on how to create the background image.