doc/README-DMG_creation.md

   1 # Information for making the DMG
   2
   3 ## How to make the DS_Store file needed for the DMG prettification
   4
   5 > ALSO SEE https://www.ej-technologies.com/resources/install4j/help/doc/concepts/dmgStyling.html
   6
   7 First create a dmg with no DS_Store (or an existing one if you just want to edit one)
   8
   9 ```
  10 cp ../../build/install4j/11/Jalview-OFFLINE_macos-app_DEVELOPMENT-j11.dmg ./temp.dmg
  11 hdiutil convert temp.dmg -format UDRW -o temp_rw.dmg
  12 ```
  13
  14 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.
  15
  16 ```
  17 CURSIZE=`hdiutil resize temp_rw.dmg | perl -n -e 'm/^\s*\d+\s+(\d+)\s+\d+$/ && print "$1\n";'`
  18 NEWSIZE=$(( CURSIZE + 20000))
  19 hdiutil resize -sectors $NEWSIZE temp_rw.dmg
  20 ```
  21 Continue by opening the dmg in Finder.  The `/Volumes/...` folder will depend on the dmg you're editing.
  22 ```
  23 open temp_rw.dmg
  24 open /Volumes/Jalview\ Installer
  25 ```
  26
  27 Then manually position/resize icons, extend size of Finder window, etc so that the Finder window looks how you want it.
  28 You can use the
  29
  30 ```
  31 cp /Volumes/Jalview\ Installer/.DS_Store ./DS_Store_N
  32
  33 umount /Volumes/Jalview\ Installer
  34 ```
  35
  36 ## Background image
  37
  38 See file `README-DMG_background_image_creation.md` on how to create the background image.
  39
  40 ## Adding the background image
  41
  42 See https://www.ej-technologies.com/resources/install4j/help/doc/concepts/dmgStyling.html which describes how to add the background image to your DMG file
  43 using macOS Finder.
  44
  45 Worth exploring further:
  46 * https://github.com/create-dmg/create-dmg
  47 * and the AppleScript on https://stackoverflow.com/questions/96882/how-do-i-create-a-nice-looking-dmg-for-mac-os-x-using-command-line-tools
  48 to script precise placement of icons over background image.