User of Stellarium on Mac OS X and of a Digitarium Alpha planetarium projector.

Interested in the [[Compilation on Macosx|compilation of Stellarium on Mac OS X]].

== Some notes to self ==

Everything seems OK under OS X 10.8.1, but getting "Incompatible library version: libintl.8.dylib requires version 8.0.0 or later, but libiconv.2.dylib provides version 7.0.0" error at launch, even after reinstalling completely MacPorts.

Cause: during package building, the OS libiconv.2.dylib file (v7.00) is used instead of MacPorts version.

Manual fix: copy /opt/local/lib/libiconv.2.dylib into the Stellarium.app package, replacing OS X version of it.

This error could certainly be corrected by modifying pkgApp.pl script in the util folder, but I'm unable to do it myself.

'''Update (26.08.2012)''': thanks to fixes by T. Reaves, this problem is now history (as of revision 5556). Thanks Timothy :-)

2012-08-25T14:56:09Z

Mina: /* Time to compile stellarium */

This document attempts to describe how to build Stellarium from sources on MacOSX. This process ought to improve over time. The set of instructions was written for the 0.10.4 release and using an Intel machine with Leopard (10.5). The process has to be validated for other versions.

== Prepare Mac OS X to build Stellarium ==

Since Stellarium version 0.10.6, you need a machine with Mac OS X 10.5. These instructions were tested with Mac OS X 10.6 (latest version 10.6.8) or later<ref>If you build Stellarium 0.10.6+ by yourself on Mac OS X 10.4.11 then you need edit info.plist file then change value for LSMinimumSystemVersion key. You'll have to get [ftp://ftp.qt.nokia.com/qt/source/ older versions of Qt (Carbon)] too, if you want to create universal binaries (PPC and Intel).</ref>.

# Install the latest version of Apple's Developer Tools: http://developer.apple.com/technology/xcode.html
# Install the latest version of cmake: http://www.cmake.org/cmake/resources/software.html
# Install the latest version of Qt Libraries from the dmg (4.8.2 at the time these instructions were written): http://qt.nokia.com/downloads/downloads#qt-lib
# Install macports: http://www.macports.org/install.php
# Install bazaar making use of macports:

$ sudo port install bzr

== Compiling dependencies to build an universal binary ==

We have to compile the dependencies with special flags to be able to generate an universal binary. If you don't intend to create an universal package you can skip this and going to the next section: [[#Building stellarium itself]]

In case you are compiling in a Leopard or Snow Leopard machine you have to recompile stellarium dependencies making use of the oldest system libraries (in our case those in 10.4 aka Tiger). We need the following compilation flags:

a. We want to generate a single binary for both intel and ppc architectures so:

-arch i386 -arch ppc

b. We want to link with the old framework and system libraries:

-mmacosx-version-min=10.4
-isysroot /Developer/SDKs/MacOSX10.4u.sdk/ (Not sure if this is really needed)

=== Compiling dependencies ===

- Libiconv: It's important to compile libiconv in the first place because gettext depends on it. Get the latest release from here: http://www.gnu.org/software/libiconv/ Uncompress the file in your favorite directory and configure and compile like this:

$ ./configure --prefix=/usr CFLAGS='-arch i386 -arch ppc -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk/'
$ make
$ make install

- Gettext: Get the latest release from here: http://www.gnu.org/software/gettext/ . Uncompress the file in your favorite directory and configure and compile like this:

$ ./configure CFLAGS='-arch i386 -arch ppc -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk/'
$ make
$ make install

At the moment of writing these steps 4.6.2 is the latest version of Qt. Trolltech provides support from MacOS 10.4 to 10.6 so our binaries will be constrained by this. I went through these instructions in a Leopard machine. To compile in Snow Leopard it's necessary to consider the following notes copied from the Qt 4.6.0 changelog:

* Gcc 4.2 is used by default. Configure with -platform macx-g++40 to select 4.0.
* Using the 10.4u SDK requires gcc 4.0.
* Configuring for the Cocoa port (-cocoa) produces 64-bit binaries by default. Use the -arch flags to override.
* Building for ppc64 is no longer supported by the gcc tool chain.
* Building for ppc is still supported.

I haven't tried to generate universal binaries on a Snow Leopard machine. We have to validate these steps.

== Building stellarium itself ==

Create a build directory with your favorite shell (the following directory is just an example, you can pick any name and path you want)

$ mkdir ~/Development
$ cd ~/Development

And in that directory checkout the sources with the bzr command

$ bzr branch lp:stellarium stellarium

For more details, see [[Bzr checkout|the Bazaar checkout instructions]].

=== Time to compile stellarium ===

We setup the build directory

$ cd stellarium
$ mkdir -p builds/macosx
$ cd builds/macosx

[[Configuring Build Options|We run cmake]]<ref>If you've installed the Qt Creator dmg instead of the Qt Libraries, cmake will complain that it can't find Qt and you'll have to pass as an option the location of your QtSDK installation, e.g.
$ cmake -DQT_QMAKE_EXECUTABLE=~/Development/QtSDK/Desktop/Qt/4.8.2/gcc/bin/qmake ../..
Other things will later go wrong too, especially when making the application bundle.
</ref>...

$ cmake ../..

... and compile

$ make

== Packaging ==

$ make install
$ make macosx_bundle

'''Note''' : as of this writing, this last step doesn't work correctly and raise the following error :
make[2]: *** No rule to make target `CMakeFiles/install.dir/all', needed by `CMakeFiles/macosx_bundle.dir/all'. Stop.
make[1]: *** [CMakeFiles/macosx_bundle.dir/rule] Error 2
make: *** [macosx_bundle] Error 2
To correct this, you'll have modify file stellarium/builds/macosx/CMakeFiles/Makefile2<ref>Credits to Timothy Reaves, see http://sourceforge.net/mailarchive/message.php?msg_id=29131979</ref>, changing the line
CMakeFiles/macosx_bundle.dir/all: CMakeFiles/install.dir/all
to
CMakeFiles/macosx_bundle.dir/all:

'''IMPORTANT''': you should delete or move aside the old Stellarium.app before each new build.

The macosx_bundle target includes a perl script that makes use of otool and install_name_tool to:

# read the link dependencies of Stellarium.app/Contents/MacOS/stellarium
# copy those dependencies into the app (.frameworks and .dylibs)
# recurse on those copied-in dependencies, stopping at a point where system libraries are called for

== We recommend Qt Creator ==

The core group of developers of stellarium uses QtCreator as main IDE, its integration with Qt and the possibility of having a consistent tool through different platforms makes it the most suitable option for our goals.

== Troubleshooting ==

All kinds of things might go wrong!

We will write here the most frequent problems and the possible solutions found by the developers.

== References ==
<references/>

[[Category:Development]]

User:Mina

2012-08-25T14:47:04Z

Mina:

2012-08-24T11:33:33Z

Mina: /* Prepare Mac OS X to build Stellarium */ Update versions and instructions

This document attempts to describe how to build Stellarium from sources on MacOSX. This process ought to improve over time. The set of instructions was written for the 0.10.4 release and using an Intel machine with Leopard (10.5). The process has to be validated for other versions.

== Prepare Mac OS X to build Stellarium ==

Since Stellarium version 0.10.6, you need a machine with Mac OS X 10.5. These instructions were tested with Mac OS X 10.6 (latest version 10.6.8) or later<ref>If you build Stellarium 0.10.6+ by yourself on Mac OS X 10.4.11 then you need edit info.plist file then change value for LSMinimumSystemVersion key. You'll have to get [ftp://ftp.qt.nokia.com/qt/source/ older versions of Qt (Carbon)] too, if you want to create universal binaries (PPC and Intel).</ref>.

# Install the latest version of Apple's Developer Tools: http://developer.apple.com/technology/xcode.html
# Install the latest version of cmake: http://www.cmake.org/cmake/resources/software.html
# Install the latest version of Qt: Framework from the dmg (4.8.1 at the time these instructions were written): http://qt.nokia.com/downloads
# Install macports: http://www.macports.org/install.php
# Install bazaar making use of macports:

$ sudo port install bzr

== Compiling dependencies to build an universal binary ==

We have to compile the dependencies with special flags to be able to generate an universal binary. If you don't intend to create an universal package you can skip this and going to the next section: [[#Building stellarium itself]]

In case you are compiling in a Leopard or Snow Leopard machine you have to recompile stellarium dependencies making use of the oldest system libraries (in our case those in 10.4 aka Tiger). We need the following compilation flags:

a. We want to generate a single binary for both intel and ppc architectures so:

-arch i386 -arch ppc

b. We want to link with the old framework and system libraries:

-mmacosx-version-min=10.4
-isysroot /Developer/SDKs/MacOSX10.4u.sdk/ (Not sure if this is really needed)

=== Compiling dependencies ===

- Libiconv: It's important to compile libiconv in the first place because gettext depends on it. Get the latest release from here: http://www.gnu.org/software/libiconv/ Uncompress the file in your favorite directory and configure and compile like this:

$ ./configure --prefix=/usr CFLAGS='-arch i386 -arch ppc -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk/'
$ make
$ make install

- Gettext: Get the latest release from here: http://www.gnu.org/software/gettext/ . Uncompress the file in your favorite directory and configure and compile like this:

$ ./configure CFLAGS='-arch i386 -arch ppc -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk/'
$ make
$ make install

At the moment of writing these steps 4.6.2 is the latest version of Qt. Trolltech provides support from MacOS 10.4 to 10.6 so our binaries will be constrained by this. I went through these instructions in a Leopard machine. To compile in Snow Leopard it's necessary to consider the following notes copied from the Qt 4.6.0 changelog:

* Gcc 4.2 is used by default. Configure with -platform macx-g++40 to select 4.0.
* Using the 10.4u SDK requires gcc 4.0.
* Configuring for the Cocoa port (-cocoa) produces 64-bit binaries by default. Use the -arch flags to override.
* Building for ppc64 is no longer supported by the gcc tool chain.
* Building for ppc is still supported.

I haven't tried to generate universal binaries on a Snow Leopard machine. We have to validate these steps.

== Building stellarium itself ==

Create a build directory with your favorite shell (the following directory is just an example, you can pick any name and path you want)

$ mkdir ~/Development
$ cd ~/Development

And in that directory checkout the sources with the bzr command

$ bzr branch lp:stellarium stellarium

For more details, see [[Bzr checkout|the Bazaar checkout instructions]].

=== Time to compile stellarium ===

We setup the build directory

$ cd stellarium
$ mkdir -p builds/macosx
$ cd builds/macosx

[[Configuring Build Options|We run cmake]]<ref>You'll have to pass location of your QtSDK instllation, e.g.

$ cmake -DQT_QMAKE_EXECUTABLE=~/Development/QtSDK/Desktop/Qt/4.8.1/gcc/bin/qmake ../..

if your installation complains that it didn't found Qt with such an error message

CMake Error at /Applications/CMake 2.8-9.app/Contents/share/cmake-2.8/Modules/FindPackageHandleStandardArgs.cmake:97 (MESSAGE):
Could NOT find Qt4 (missing: QT_QMAKE_EXECUTABLE QT_MOC_EXECUTABLE
QT_RCC_EXECUTABLE QT_UIC_EXECUTABLE QT_INCLUDE_DIR QT_LIBRARY_DIR
QT_QTCORE_LIBRARY) (Required is at least version "4.6.2")
Call Stack (most recent call first):
/Applications/CMake 2.8-9.app/Contents/share/cmake-2.8/Modules/FindPackageHandleStandardArgs.cmake:288 (_FPHSA_FAILURE_MESSAGE)
/Applications/CMake 2.8-9.app/Contents/share/cmake-2.8/Modules/FindQt4.cmake:1200 (FIND_PACKAGE_HANDLE_STANDARD_ARGS)
CMakeLists.txt:248 (FIND_PACKAGE)</ref>...

$ cmake ../..

... and compile

$ make

== Packaging ==

$ make install
$ make macosx_bundle

'''IMPORTANT''': you should delete or move aside the old /Users/Shared/stellarium/Stellarium.app before each new build.

The macosx_bundle target includes a perl script that makes use of otool and install_name_tool to:

# read the link dependencies of Stellarium.app/Contents/MacOS/stellarium
# copy those dependencies into the app (.frameworks and .dylibs)
# recurse on those copied-in dependencies, stopping at a point where system libraries are called for

== We recommend Qt Creator ==

The core group of developers of stellarium uses QtCreator as main IDE, its integration with Qt and the possibility of having a consistent tool through different platforms makes it the most suitable option for our goals.

== Troubleshooting ==

All kinds of things might go wrong!

We will write here the most frequent problems and the possible solutions found by the developers.

== References ==
<references/>

[[Category:Development]]

Compilation on Mac OS X

2012-08-19T10:38:11Z

Mina: /* Time to compile stellarium */

This document attempts to describe how to build Stellarium from sources on MacOSX. This process ought to improve over time. The set of instructions was written for the 0.10.4 release and using an Intel machine with Leopard (10.5). The process has to be validated for other versions.

== Prepare Mac OS X to build Stellarium ==

You need a machine with Mac OS X 10.4 (latest version 10.4.11) or later<ref>Since version 0.10.6 you need Mac OS X 10.5 or later.</ref><ref>If you build Stellarium 0.10.6+ by yourself on Mac OS X 10.4.11 then you need edit info.plist file then change value for LSMinimumSystemVersion key.</ref>

# Install the latest version of Apple's Developer Tools: http://developer.apple.com/technology/xcode.html
# Install the latest version of cmake: http://www.cmake.org/cmake/resources/software.html
# Install the latest version of Qt: Framework from the dmg (4.6.2 at the time these instructions were written) http://qt.nokia.com/downloads
# Install macports: http://www.macports.org/install.php
# Install bazaar making use of macports:

$ sudo port install bzr

Note:

For Mac OS X there are two different versions of Qt:

* Carbon version: Default download and recommended option. It works for Mac OS X 10.5/4/3, and both Intel and PPC architectures. Install this one if you want to create universal binaries

* Cocoa version: Exclusively for Intel architecture and Mac OS X 10.5 and later. You can use this if you aren't going to create universal binaries.

== Compiling dependencies to build an universal binary ==

We have to compile the dependencies with special flags to be able to generate an universal binary. If you don't intend to create an universal package you can skip this and going to the next section: [[#Building stellarium itself]]

In case you are compiling in a Leopard or Snow Leopard machine you have to recompile stellarium dependencies making use of the oldest system libraries (in our case those in 10.4 aka Tiger). We need the following compilation flags:

a. We want to generate a single binary for both intel and ppc architectures so:

-arch i386 -arch ppc

b. We want to link with the old framework and system libraries:

-mmacosx-version-min=10.4
-isysroot /Developer/SDKs/MacOSX10.4u.sdk/ (Not sure if this is really needed)

=== Compiling dependencies ===

- Libiconv: It's important to compile libiconv in the first place because gettext depends on it. Get the latest release from here: http://www.gnu.org/software/libiconv/ Uncompress the file in your favorite directory and configure and compile like this:

$ ./configure --prefix=/usr CFLAGS='-arch i386 -arch ppc -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk/'
$ make
$ make install

- Gettext: Get the latest release from here: http://www.gnu.org/software/gettext/ . Uncompress the file in your favorite directory and configure and compile like this:

$ ./configure CFLAGS='-arch i386 -arch ppc -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk/'
$ make
$ make install

At the moment of writing these steps 4.6.2 is the latest version of Qt. Trolltech provides support from MacOS 10.4 to 10.6 so our binaries will be constrained by this. I went through these instructions in a Leopard machine. To compile in Snow Leopard it's necessary to consider the following notes copied from the Qt 4.6.0 changelog:

* Gcc 4.2 is used by default. Configure with -platform macx-g++40 to select 4.0.
* Using the 10.4u SDK requires gcc 4.0.
* Configuring for the Cocoa port (-cocoa) produces 64-bit binaries by default. Use the -arch flags to override.
* Building for ppc64 is no longer supported by the gcc tool chain.
* Building for ppc is still supported.

I haven't tried to generate universal binaries on a Snow Leopard machine. We have to validate these steps.

== Building stellarium itself ==

Create a build directory with your favorite shell (the following directory is just an example, you can pick any name and path you want)

$ mkdir ~/Development
$ cd ~/Development

And in that directory checkout the sources with the bzr command

$ bzr branch lp:stellarium stellarium

For more details, see [[Bzr checkout|the Bazaar checkout instructions]].

=== Time to compile stellarium ===

We setup the build directory

$ cd stellarium
$ mkdir -p builds/macosx
$ cd builds/macosx

[[Configuring Build Options|We run cmake]]<ref>You'll have to pass location of your QtSDK instllation, e.g.

$ cmake -DQT_QMAKE_EXECUTABLE=~/Development/QtSDK/Desktop/Qt/4.8.1/gcc/bin/qmake ../..

if your installation complains that it didn't found Qt with such an error message

CMake Error at /Applications/CMake 2.8-9.app/Contents/share/cmake-2.8/Modules/FindPackageHandleStandardArgs.cmake:97 (MESSAGE):
Could NOT find Qt4 (missing: QT_QMAKE_EXECUTABLE QT_MOC_EXECUTABLE
QT_RCC_EXECUTABLE QT_UIC_EXECUTABLE QT_INCLUDE_DIR QT_LIBRARY_DIR
QT_QTCORE_LIBRARY) (Required is at least version "4.6.2")
Call Stack (most recent call first):
/Applications/CMake 2.8-9.app/Contents/share/cmake-2.8/Modules/FindPackageHandleStandardArgs.cmake:288 (_FPHSA_FAILURE_MESSAGE)
/Applications/CMake 2.8-9.app/Contents/share/cmake-2.8/Modules/FindQt4.cmake:1200 (FIND_PACKAGE_HANDLE_STANDARD_ARGS)
CMakeLists.txt:248 (FIND_PACKAGE)</ref>...

$ cmake ../..

... and compile

$ make

== Packaging ==

$ make install
$ make macosx_bundle

'''IMPORTANT''': you should delete or move aside the old /Users/Shared/stellarium/Stellarium.app before each new build.

The macosx_bundle target includes a perl script that makes use of otool and install_name_tool to:

# read the link dependencies of Stellarium.app/Contents/MacOS/stellarium
# copy those dependencies into the app (.frameworks and .dylibs)
# recurse on those copied-in dependencies, stopping at a point where system libraries are called for

== We recommend Qt Creator ==

The core group of developers of stellarium uses QtCreator as main IDE, its integration with Qt and the possibility of having a consistent tool through different platforms makes it the most suitable option for our goals.

== Troubleshooting ==

All kinds of things might go wrong!

We will write here the most frequent problems and the possible solutions found by the developers.

== References ==
<references/>

[[Category:Development]]