Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

For some information about the quite new native Mac OS X Support, see Mac Client State. Link to blank page.

Pre Requirement

...

echo 'export PATH=${PATH}:/opt/local/bin' >> ~/.profile 

Installing Dependencies

If you are using Mac OS X 10.6, you might want to install the packages with the +universal flag to use them for 32bit and 64bit builds, default is 64bit on 10.6, which is ok for Ryzom Core Client and NeL.Since Xcode 5, to be able to compile Ryzom Core, you'll need to type :

xcode-select --install 

If you plan to deploy Ryzom on different Mac OS X versions, I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.6

Installing Dependencies

  • Run XCode once to accept the license agreement
  • Launch the Terminal application and execute the following command in it.

...

Get the sources

See Getting Source.

Build

The given list of CMake options is just an example. For a complete list see: CMake Options.

cd code/
mkdir build
cd build
cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release -DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF -DWITH_RYZOM_TOOLS=OFF ..
make
sudo make install

The install process created /Applications/ryzom_client.app for you.

...

  • note: if you get string.h not found error in macOS 10.14 run this command:

sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /

Get the sources

See Getting Source.

Build

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd code/
mkdir build-static
cd build-static
cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON -DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF -DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON ..
make
sudo make install

The install process created /Applications/ryzom_client.app for you.


To check which libraries are needed by your binary run:

otool -L bin/ryzom_client.app/Contents/MacOS/ryzom_client

...

You should only see libraries which reside in /usr/lib or /System/Library/Frameworks.

Universal binary

To create an universal binary for 32 and 64 bits Mac OS X versions, just append -DCMAKE_OSX_ARCHITECTURES="i386;x86_64" to CMake command line.

...

hdiutil create ryzom_client.dmg -srcdir ryzom_client.app 

Screenshot

Image RemovedImage Added