From 00d13d6521664b182dda7ac2b2dadf69b3e6958c Mon Sep 17 00:00:00 2001 From: Bill Somerville Date: Sat, 27 Sep 2014 15:48:22 +0000 Subject: [PATCH] Include Mac install instructions in package root git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@4388 ab8295b8-cf94-4d9e-aec4-7959e3be5d79 --- CMakeCPackOptions.cmake.in | 2 +- CMakeLists.txt | 14 ++- Darwin/ReadMe.txt | 95 ++++++++++++++++++ Darwin/developer read me.txt | 63 ++++++++++++ Darwin/sysctl.conf | 6 ++ .../wsjtx_DMG.DS_Store | Bin 15364 -> 15364 bytes 6 files changed, 178 insertions(+), 2 deletions(-) create mode 100644 Darwin/ReadMe.txt create mode 100644 Darwin/developer read me.txt create mode 100644 Darwin/sysctl.conf rename wsjtx_DMG.DS_Store => Darwin/wsjtx_DMG.DS_Store (67%) diff --git a/CMakeCPackOptions.cmake.in b/CMakeCPackOptions.cmake.in index 3b26960e9..8651b832e 100644 --- a/CMakeCPackOptions.cmake.in +++ b/CMakeCPackOptions.cmake.in @@ -54,7 +54,7 @@ endif () if ("${CPACK_GENERATOR}" STREQUAL "DragNDrop") set (CPACK_DMG_BACKGROUND_IMAGE "@PROJECT_SOURCE_DIR@/icons/Darwin/DragNDrop Background.png") - set (CPACK_DMG_DS_STORE "@PROJECT_SOURCE_DIR@/wsjtx_DMG.DS_Store") + set (CPACK_DMG_DS_STORE "@PROJECT_SOURCE_DIR@/Darwin/wsjtx_DMG.DS_Store") set (CPACK_BUNDLE_NAME "@WSJTX_BUNDLE_NAME@") set (CPACK_PACKAGE_ICON "@PROJECT_BINARY_DIR@/wsjtx.icns") set (CPACK_BUNDLE_ICON "@PROJECT_BINARY_DIR@/wsjtx.icns") diff --git a/CMakeLists.txt b/CMakeLists.txt index 5bcb1a243..b2eb08754 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -738,6 +738,18 @@ install (FILES #COMPONENT Runtime ) +# +# Mac installer files +# +if (APPLE) + install (FILES + Darwin/ReadMe.txt + Darwin/sysctl.conf + DESTINATION . + #COMPONENT Runtime + ) +endif (APPLE) + # # uninstall support @@ -939,7 +951,7 @@ endif (WSJTX_RC) if (WIN32) set (CPACK_GENERATOR "NSIS") elseif (APPLE) - set (CPACK_GENERATOR "DragNDrop" "PackageMaker") + set (CPACK_GENERATOR "DragNDrop") else () # # Derive the correct filename for a Debian package because the DEB diff --git a/Darwin/ReadMe.txt b/Darwin/ReadMe.txt new file mode 100644 index 000000000..fb9b547a8 --- /dev/null +++ b/Darwin/ReadMe.txt @@ -0,0 +1,95 @@ + Notes on WSJT-X Installation for Mac OS X + ----------------------------------------- + +If you have already downloaded a previous version of WSJT-X then I suggest +you change the name in the Applications folder from WSJT-X to WSJT-X_previous +before proceeding. + +If you have installed a previous version of WSJT-X before then there is no +need to change anything on your system so proceed to NEXT. + +BEGIN: + +There are some system matters you must deal with first. Open a Terminal window +by going to Applications->Utilities and clicking on Terminal. + +Along with this ReadMe file there is a file: sysctl.conf. Drag this file to your Desktop. +Then type in the Terminal window: + + cd $HOME/Desktop + +WSJT-X makes use of a block of memory which is shared between different parts of +the code. The normal allocation of shared memory on a Mac is insufficient and this +has to be increased. You can look at the new allocation by typing: + + cat sysctl.conf + +This shows the following: + +kern.sysv.shmmax=33554432 +kern.sysv.shmmin=1 +kern.sysv.shmmni=128 +kern.sysv.shmseg=32 +kern.sysv.shmall=8192 + +You can check the current allocation on your Mac by typing: + + sysctl -a | grep sysv.shm + +If your shmmax is already at least 33554432 (32 MB) then you can close the Terminal window +and skip the next steps and go to (NEXT). + +Now move this file into place for the system to use by typing: + + sudo mv sysctl.conf /etc/ + +and then reboot your Mac. This is necessary to install the changes. After the +reboot you should re-open the Terminal window as before and you can check that the +change has been made by typing: + + sysctl -a | grep sysv.shm + +You are finished with system changes. You should make certain that NO error messages +have been produced during these steps. You can now close the Terminal window. It will +not be necessary to repeat this procedure again, even when you download an updated +version of WSJT-X. + +NEXT: + +Drag the WSJT-X app to your preferred location, such as Applications. + +You need to configure your sound card. Visit Applications > Utilities > Audio MIDI Setup and +select your sound card and then set Format to be "48000Hz 2ch-16bit" for input and output. + +Now double-click on the WSJT-X app and two windows will appear. Select Preferences under the +WSJT-X Menu and fill in various station details on the General panel. I recommend checking the +4 boxes under the Display heading and the first 4 boxes under the Behaviour heading. + +Next visit the Audio panel and select the Audio Codec you use to communicate between WSJT-X +and your rig. There are so many audio interfaces available that it is not possible to give +detailed advice on selection. If you have difficulties contact me. Note the location of the +Save Directory. Decoded wave forms are located here. + +Look at the Reporting panel. If you check the "Prompt me" box, a logging panel will appear +at the end of the QSO. Two log files are provided in Library/Application Support/WSJT-X. +These are a simple wsjtx.log file and wsjtx_log.adi which is formatted for use with logging +databases. + +Finally, visit the Radio panel. WSJT-X is most effective when operated with CAT control. You +will need to install the relevant Mac driver for your rig. This must be located in the system +driver directory /dev. I use a Prolific USB-Serial Adapter to a Kenwood TS870s and the relevant +driver is /dev/tty.PL2303-00002226. You should install your driver and then re-launch WSJT-X. +Return to the the Radio panel in Preferences and insert the full name of your driver in the +Serial Port panel. Such as: /dev/tty.PL2303-00002226 or what ever driver you have. The /dev/ +prefix is mandatory. Set the relevant communication parameters as required by your transceiver. + +WSJT-X needs the Mac clock to be accurate. Visit System Preferences > Date & Time and make sure that +date and time are set automatically. The drop-down menu will normally offer you several time +servers to choose from. + +On the Help menu, have a look at the new Online User's Guide for operational hints and tips. + +Please email me if you have problems. + +--- John G4KLA (g4kla@rmnjmn.demon.co.uk) + diff --git a/Darwin/developer read me.txt b/Darwin/developer read me.txt new file mode 100644 index 000000000..d78fcddac --- /dev/null +++ b/Darwin/developer read me.txt @@ -0,0 +1,63 @@ +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 becuase 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. + +# convert the DMG to a R/W copy +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. +# 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! \ No newline at end of file diff --git a/Darwin/sysctl.conf b/Darwin/sysctl.conf new file mode 100644 index 000000000..dec2ee4db --- /dev/null +++ b/Darwin/sysctl.conf @@ -0,0 +1,6 @@ +kern.sysv.shmmax=33554432 +kern.sysv.shmmin=1 +kern.sysv.shmmni=128 +kern.sysv.shmseg=32 +kern.sysv.shmall=8192 + diff --git a/wsjtx_DMG.DS_Store b/Darwin/wsjtx_DMG.DS_Store similarity index 67% rename from wsjtx_DMG.DS_Store rename to Darwin/wsjtx_DMG.DS_Store index 8475e0e291e5abb524f02fd14f97d2430200441d..ae14cb10c969fe7eb2d92afc1ed0295b89214e6b 100644 GIT binary patch literal 15364 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 NAYc$M2>c%+@OKqhD=Pp1