mirror of https://github.com/saitohirga/WSJT-X.git
91 lines
4.8 KiB
Plaintext
91 lines
4.8 KiB
Plaintext
KVASD-installer
|
|
===============
|
|
This is a small AppleScriptObjbC Xcode project that is an application bundle GUI tool
|
|
to install the KVASD tool into a WSJT-X application bundle. It fetches the KVASD EULA
|
|
from the SourceForge web svn server and presents it to the user, the user may store
|
|
license or print it. They must agree the license terms before the KVASD tool is also
|
|
downloaded from the SourceForge web svn server. The user then can select the target
|
|
WSJT-X application bundle for installation either via a file chooser dialog or simply
|
|
by dragging the target WSJT-X application bundle onto the KVASD-installer window.
|
|
Once selected the "Install" button starts the installation process. The installation
|
|
copies the kvasd binary into the WSJT-X bundle and adjusts the dylib paths in it to
|
|
point to the libgcc dylibs that are shipped inside the WSJT_X bundle.
|
|
|
|
KVASD-installer is not built as part of the WSJT-X project build, instead it must be
|
|
built within Xcode and deployed into the source tree at the location 'contrib/Darwin'
|
|
as a bare application bundle which is then checked into source control. The WSJT-X
|
|
CMake build, when building a DragNDrop installer package for WSJT-X inserts the
|
|
KVASD-installer application bundle into the root of the package DMG ready to be used
|
|
after installing the main WSJT-X application bundle.
|
|
|
|
|
|
Changing the content of the DragNDrop DMG root folder.
|
|
======================================================
|
|
|
|
The files and links in this folder are populated by the WSJT-X CMake build script. There are install commands which are only run on Apple hosts, this is important because they will get installed at the install root on other platforms, which would be very bad on Linux for example since that is /usr normally!
|
|
|
|
The symlink to /Applications, the background image (derived from "~/src/wsjtx/artwork/DragNDrop Background.svg") and, the custom .DS_Store file ("~/src/wsjtx_DMG.DS_Store") are all handled specifically by the CPack DragNDrop packager so you don't need to install those.
|
|
|
|
|
|
|
|
Modifying the .DS_Store folder options for the DragNDrop DMG root folder.
|
|
=========================================================================
|
|
|
|
The DragNDrop installer is a generated a DMG file that has a custom .DS_Store file that defines the layout, background image and, folder view options of the DMG root folder.
|
|
|
|
To modify this file, first you need to make a DragNDrop package then mount the DMG file, then modify the root .DS_Store file using Finder. Once you are happy with the results, you check into source control the modified .DS_Store file and then future package builds will use that file.
|
|
|
|
The installer DMG is read only and shrunk to exactly the size of the contents, also the .DS_Store file is read only and the background image PNG file is hidden. You need to undo all of these things before changing the .DS_Store file. Don't forget to redo these things before checking in a new version of the custom .DS_Store file.
|
|
|
|
The following recipe shows how to amend the content and layout of the DMG root folder:
|
|
|
|
# convert the DMG to a R/W copy (substitute the DMG you have built)
|
|
hdiutil convert wsjtx-1.4.0-rc1-Darwin.dmg -format UDRW -o rw.dmg
|
|
|
|
# expand the R/W copy to make room for changes
|
|
# first find the current number of sectors
|
|
hdiutil resize -limits rw.dmg
|
|
# the output looks like:
|
|
#
|
|
# min cur max
|
|
#109696 109696 33037872
|
|
#
|
|
# you need to increase the sector count to something a bit bigger than current
|
|
# e.g. in this case use 110000
|
|
hdiutil resize -sectors 110000 rw.dmg
|
|
|
|
# now you can mount the R/W DMG
|
|
hdiutil attach rw.dmg
|
|
|
|
# change the hidden attribute on the background PNG
|
|
chflags nohidden /Volumes/wsjtx-1.4.0-rc1-Darwin/background.png
|
|
|
|
# make the .DS_Store file writeable
|
|
chmod 644 /Volumes/wsjtx-1.4.0-rc1-Darwin/.DS_Store
|
|
|
|
# now you can change Finder view options, rearrange icons etc. Remember that you are
|
|
# only changing the folder options, not the folder content as that is controlled by
|
|
# the install steps in the project CMakeLists.txt if you are adding or removing a file
|
|
# to the DMG root folder, you need to have changed the install steps before doing this
|
|
# procedure so the content changes are reflected in the installer DMG you start with.
|
|
|
|
# when you are happy with the layout etc. close the Finder window to ensure all
|
|
# changes are saved.
|
|
|
|
# set the background PNG as a hidden file
|
|
chflags hidden /Volumes/wsjtx-1.4.0-rc1-Darwin/background.png
|
|
|
|
# make the .DS_Store file read only
|
|
chmod 444 /Volumes/wsjtx-1.4.0-rc1-Darwin/.DS_Store
|
|
|
|
# update the custom .DS_Store file in the source repository (NOTE the file name)
|
|
cp /Volumes/wsjtx-1.4.0-rc1-Darwin/.DS_Store ~/src/wsjtx/wsjtx_DMG.DS_Store
|
|
|
|
# build a new package and try out the new installer to test your changes
|
|
# if all is well commit the changes
|
|
|
|
# dismount and eject the R/W DMG and discard it
|
|
hdiutil detach /Volumes/wsjtx-1.4.0-rc1-Darwin
|
|
rm rw.dmg
|
|
|
|
# That's all Folks! |