Recent changes to MacBuild

MacBuild modified by strobelight

strobelight — Sat, 09 Aug 2025 15:51:51 -0000

--- v9
+++ v10
@@ -1,6 +1,8 @@
 ## **MacOSX** Build

 ### Prerequisites
+
+_Note: these steps are known to work on an Intel MAC running 14.7 (Sonoma)_

 To build, you will need to install the following dependencies - I recommend using <www.macports.org> to obtain them:
 * gtk2
</www.macports.org>

MacBuild modified by strobelight

strobelight — Sat, 09 Aug 2025 15:43:20 -0000

--- v8
+++ v9
@@ -27,15 +27,17 @@

 ```
 cd ~
-mkdir src
+mkdir -p src
 cd src
-# clone source from options branch or tag into xtrkcad directory
+# this is to make sure cloning into non-existant directory, skip if using a different name
+rm -rf xtrkcad
+# clone source from options branch or tag into xtrkcad directory, change name if desired
 hg clone http://hg.code.sf.net/p/xtrkcad-fork/xtrkcad  [-u "V5.3.0 GA" ]  xtrkcad
-cd xtrkcad
 ```

 Pull the branch you need if you didn't use the -u option on clone
 ```
+cd ~/src/xtrkcad
 hg update branch-name
 ```

MacBuild modified by strobelight

strobelight — Sat, 09 Aug 2025 15:36:25 -0000

--- v7
+++ v8
@@ -26,6 +26,7 @@
 Create a source library directory and clone the Mercurial repo into it (I assume you create an src directory and you put an xtrkcad directory under it

 ```
+cd ~
 mkdir src
 cd src
 # clone source from options branch or tag into xtrkcad directory
@@ -80,4 +81,4 @@
 mkdir share
 ./xtrkcad-bundler.sh -i ~/install/xtrkcad -v [version]
 ```
-The TARed DMG will be in the ~/install/xtrkcad/bin folder with the name xtrkcad-OSX-[version].dmg.tar.gz
+The TARed DMG will be in the ~/install/xtrkcad/bin folder with the name `xtrkcad-OSX-[version].dmg.tar.gz`

MacBuild modified by strobelight

strobelight — Sat, 09 Aug 2025 15:27:20 -0000

--- v6
+++ v7
@@ -25,55 +25,59 @@

 Create a source library directory and clone the Mercurial repo into it (I assume you create an src directory and you put an xtrkcad directory under it

->
->mkdir src
->cd src
->hq clone sourceforge-repo xtrkcad
->cd xtrkcad
+```
+mkdir src
+cd src
+# clone source from options branch or tag into xtrkcad directory
+hg clone http://hg.code.sf.net/p/xtrkcad-fork/xtrkcad  [-u "V5.3.0 GA" ]  xtrkcad
+cd xtrkcad
+```

-Pull the branch you need
->
->hg update branch-name
-
+Pull the branch you need if you didn't use the -u option on clone
+```
+hg update branch-name
+```

 ### Build

-Create a build and install directories
->
->cd ~
->mkdir build
->cd build
->mkdir xtrkcad
-> cd ~
->mkdir install
->cd install
->mkdir xtrkcad
+#### Create build and install directories
+```
+cd ~
+mkdir -p build/xtrkcad
+mkdir -p install/xtrkcad/bin
+```

-#### Configure the build
+#### Configure and build

-1) If you installed the GTK libraries from MacPorts you need to set export LIBRARY_PATH="/opt/local/lib"
-2) Open the CMake App, set the build directory to ~/build/xtrkcad, and the install directory, set the build type to "Debug" and do ##Configure##. 
-3) Select default OSX toolchain options, then make sure GTK is selected redo ##Configure## and ##Generate##.
-
-Make and install the code using a Terminal
->
->make
->make install
+```
+export LIBRARY_PATH=/opt/local/lib
+cmake \
+      -DCMAKE_BUILD_TYPE=Debug \
+      -DCMAKE_INSTALL_PREFIX=~/install/xtrkcad \
+      -S ~/src/xtrkcad -B ~/build/xtrkcad
+cd ~/build/xtrkcad
+make
+make install
+```

 #### Run

-Remember that to run **XTrackCAD** on OSX, you must have **XQuartz** installed - see MacInstall. Once you have this, you can navigate to the install directory, navigate to the bin directory inside it and then just run the binary.
+Remember that to run **XTrackCAD** on OSX, you must have **XQuartz** installed - see [MacInstall]. Once you have this, you can navigate to the install directory, navigate to the bin directory inside it and then just run the binary. _Note: ensure the XQuartz version is compatible with the OSX version._

 If you want to interactively debug, you can use LLDB, the Mac debugger.
->
->lldb xtrkcad
->>r
+
+```
+lldb xtrkcad
+>r
+```

 #### Package

 To package the app for distribution
->
->cd [builddirectory]/distribution/osx/gtk-bundle
->bash xtrkcad-bundle -i [Cmake_install_directory] -v [version]
-
-The TARed DMG will be in the [builddirectory]/bin folder with the name xtrkcad-OSX-[version].dmg.tar.gz
+```
+cd ~/build/xtrkcad/distribution/osx/gtk-bundle
+mkdir bin
+mkdir share
+./xtrkcad-bundler.sh -i ~/install/xtrkcad -v [version]
+```
+The TARed DMG will be in the ~/install/xtrkcad/bin folder with the name xtrkcad-OSX-[version].dmg.tar.gz

MacBuild modified by Martin Fischer

Martin Fischer — Sat, 26 Apr 2025 14:48:05 -0000

MacBuild modified by Adam Richards

Adam Richards — Sat, 27 Apr 2024 04:42:26 -0000

--- v4
+++ v5
@@ -5,6 +5,12 @@
 To build, you will need to install the following dependencies - I recommend using <www.macports.org> to obtain them:
 * gtk2
 * libzip
+* freeimage
+* cmocka
+* mxml
+* inkscape
+* zlib
+* dbus - this is actually a runtime dependency

 If you intend to build to use the internal webhelp (and not either a browser or the AppleHelp system) you will need
 * webkit2-gtk
</www.macports.org>

MacBuild modified by Russell Shilling

Russell Shilling — Thu, 28 Mar 2024 20:14:08 -0000

MacBuild modified by Russell Shilling

Russell Shilling — Thu, 28 Mar 2024 16:30:48 -0000

--- v2
+++ v3
@@ -70,8 +70,4 @@
 >cd [builddirectory]/distribution/osx/gtk-bundle
 >bash xtrkcad-bundle -i [Cmake_install_directory] -v [version]

-
 The TARed DMG will be in the [builddirectory]/bin folder with the name xtrkcad-OSX-[version].dmg.tar.gz
-
-
-(Devel)

MacBuild modified by Russell Shilling

Russell Shilling — Thu, 28 Mar 2024 16:29:34 -0000

--- v1
+++ v2
@@ -2,7 +2,7 @@

 ### Prerequisites

-To build, you will need to install the following dependencies - I recommend using [www.macports.org] to obtain them:
+To build, you will need to install the following dependencies - I recommend using <www.macports.org> to obtain them:
 * gtk2
 * libzip

@@ -74,4 +74,4 @@
 The TARed DMG will be in the [builddirectory]/bin folder with the name xtrkcad-OSX-[version].dmg.tar.gz


-CategoryDevel
+(Devel)
</www.macports.org>

MacBuild modified by Russell Shilling

Russell Shilling — Thu, 28 Mar 2024 01:26:23 -0000

MacOSX Build

Prerequisites

To build, you will need to install the following dependencies - I recommend using [www.macports.org] to obtain them:
* gtk2
* libzip

If you intend to build to use the internal webhelp (and not either a browser or the AppleHelp system) you will need
* webkit2-gtk

You will also need to install these tools
* Mercurial SCM - I recommend the TortoiseHg client which includes the Hg code
* CMake UI
* OSX compilers and other XCode command line developer tools that you can obtain for free from the App Store. Look for XCode Command Line Tools

If you want to package an .app file and make it into a .dmg so others can install it, you will also need to install this dependency with macports, or the equivalent
* gtk-mac-bundler

Create a source library directory and clone the Mercurial repo into it (I assume you create an src directory and you put an xtrkcad directory under it

mkdir src
cd src
hq clone sourceforge-repo xtrkcad
cd xtrkcad

Pull the branch you need

hg update branch-name

Build

Create a build and install directories

cd ~
mkdir build
cd build
mkdir xtrkcad
cd ~
mkdir install
cd install
mkdir xtrkcad

Configure the build

1) If you installed the GTK libraries from MacPorts you need to set export LIBRARY_PATH="/opt/local/lib"
2) Open the CMake App, set the build directory to ~/build/xtrkcad, and the install directory, set the build type to "Debug" and do ##Configure##.
3) Select default OSX toolchain options, then make sure GTK is selected redo ##Configure## and ##Generate##.

Make and install the code using a Terminal

make
make install

Run

Remember that to run XTrackCAD on OSX, you must have XQuartz installed - see MacInstall. Once you have this, you can navigate to the install directory, navigate to the bin directory inside it and then just run the binary.

If you want to interactively debug, you can use LLDB, the Mac debugger.

lldb xtrkcad

r

Package

To package the app for distribution

cd [builddirectory]/distribution/osx/gtk-bundle
bash xtrkcad-bundle -i [Cmake_install_directory] -v [version]

The TARed DMG will be in the [builddirectory]/bin folder with the name xtrkcad-OSX-[version].dmg.tar.gz

CategoryDevel