Inkscape Wiki - User contributions [en]

CompilingMacOsX

2019-04-29T17:24:05Z

Ipatch: /* Using Homebrew */

= Using MacPorts =

<ol>
<li>Install [http://developer.apple.com/tools/xcode/ Xcode tools] from the App Store
<li>Download and install [http://www.macports.org/ MacPorts]
<li>Edit the MacPorts variants config (optional).
 Add this line to <code>/opt/local/etc/macports/variants.conf</code>
<pre>-x11 +quartz</pre>
<li>In Terminal (Applications>Utilities>Terminal) type
<syntaxhighlight lang="bash">sudo port selfupdate
sudo port install \
cmake cairo boehmgc intltool libxslt lcms2 boost \
poppler gsl adwaita-icon-theme gdl3 gtkmm3 libsoup \
double-conversion \
-x11 +quartz
</syntaxhighlight>
<li>In Terminal, get Inkscape
<syntaxhighlight lang="bash">git clone --recurse-submodules git@gitlab.com:inkscape/inkscape.git</syntaxhighlight>
<li>And build inkscape
<syntaxhighlight lang="bash">
# use a clean MacPorts environment (optional)
LIBPREFIX="/opt/local"
export PATH="$LIBPREFIX/bin:/usr/bin:/bin:/usr/sbin:/sbin"

# where to build and install
PREFIX="$PWD/install-prefix"
mkdir build
cd build

cmake \
-DCMAKE_PREFIX_PATH="$LIBPREFIX" \
-DCMAKE_INSTALL_PREFIX="$PREFIX" \
-DWITH_OPENMP=OFF \
..

make install
</syntaxhighlight>
<li>Run Inkscape
<syntaxhighlight lang="bash">
$PREFIX/bin/inkscape
</syntaxhighlight>
</ol>

== Speed up Installation ==

You can use <code>[https://en.wikipedia.org/wiki/Ccache ccache]</code> (<code>sudo port install ccache</code>) to speed up re-compilation.
Also, [https://ninja-build.org/ ninja] (<code>sudo port install ninja</code>) is a faster alternative to <code>make</code>.
Modify your call to <code>cmake</code> like this:

cmake \
-DCMAKE_C_COMPILER_LAUNCHER=ccache \
-DCMAKE_CXX_COMPILER_LAUNCHER=ccache \
-G Ninja \
# more cmake options here

ninja
ninja install

== Troubleshooting ==

Linking fails with:

ld: framework not found -lCocoa

A patch like this should help (reverts part of
[https://gitlab.com/inkscape/inkscape/commit/48e6c2ea4fc0245afc35cbbc6563804abf421ccd 48e6c2ea4f], see also
[https://gitlab.com/inkscape/inkscape/merge_requests/397 !397]):

<syntaxhighlight lang="diff">
diff --git a/CMakeScripts/DefineDependsandFlags.cmake b/CMakeScripts/DefineDependsandFlags.cmake
index 4cb63aae80..7a0b5cbc75 100644
--- a/CMakeScripts/DefineDependsandFlags.cmake
+++ b/CMakeScripts/DefineDependsandFlags.cmake
@@ -253,7 +253,7 @@ pkg_check_modules(GTKSPELL3 gtkspell3-3.0)
if("${GTKSPELL3_FOUND}")
message(STATUS "Using GtkSpell 3")
list(APPEND INKSCAPE_INCS_SYS ${GTKSPELL3_INCLUDE_DIRS})
- list(APPEND INKSCAPE_LIBS ${GTKSPELL3_LDFLAGS})
+ list(APPEND INKSCAPE_LIBS ${GTKSPELL3_LIBRARIES})
set(WITH_GTKSPELL ON)
else()
set(WITH_GTKSPELL OFF)
</syntaxhighlight>

= Using Homebrew =

The Inkscape CI job uses homebrew, see [https://gitlab.com/inkscape/inkscape/blob/master/.gitlab-ci.yml#L51-71 .gitlab-ci.yml]

[https://github.com/ipatch/homebrew-us-05/blob/master/inkscape/inkscape-building-for-macOS.md See] for a collection of notes using homebrew infrastructure 🛣 to build Inkscape 1.x from master using CMake + Ninja

= Misc =

{{Needs_update}}

== Extension Python modules ==

In case you are using a Python version installed through MacPorts do a search for both modules and install the ones suitable for the Python version activated within MacPorts.
<pre>port search lxml numpy</pre>

For further info refer to the [[GettingEffectsWorking#on_Mac_OS_X|Getting Effects Working]] section of this wiki.

== Creating an .app bundle ==

TODO

== Creating a disk image to distribute Inkscape ==

TODO

= Links =

== User Examples ==
* [github.com/ipatch] | A recent '''2019''' collection of notes about building Inkscape from master using CMake + Ninja | [https://github.com/ipatch/homebrew-us-05/blob/master/inkscape/inkscape-building-for-macOS.md Notes]
* Adam Strzeleki has outlined some improvements to this process on the Inkscape [http://www.nabble.com/Inkscape-native-Mac-OS-X-build---look-improvements-td14733036.html email list]. See his screenshot from January 10, 2008 [http://www.nabble.com/attachment/14733036/1/Inkscape%20OSX%20PL.gif here].
* JiHO has a video of his builds [http://jo.irisson.free.fr/?p=34 here] and [http://jo.irisson.free.fr/?p=62 here].
* Mac OS X native (aqua), PPC-only, Tiger-only build of 0.47, can be retrieved here: [http://verkehrsplanung.com/Inkscape_aqua_PPC_047.zip]. NOT FOR PRODUCTIVE USE - JUST TESTING! - (Nevertheless I'm doing quite a bit productive work on it… (-;)

== Apple Documentation ==
* [http://developer.apple.com/documentation/MacOSX/Conceptual/BPRuntimeConfig/BPRuntimeConfig.html Introduction to Runtime Configuration] Covers the Info.plist files, Preferences, Environment variables and has a list of the most important Properties that the Property List should contain.

== Packaging ==

* [http://www.sveinbjorn.org/platypus Sveinbjorn Thordarson's Website] The author of Platypus, the Script Exec wrapper that launches the Inkscape binary.
* [http://freespace.ausgamers.com/2005/02/creating-os-x-application-bundles-step.html Creating OS X application bundles step by step] Covers the bundle concepts, copying libraries into the bundle, editing libraries with the install_name_tool, the Info.plist file and adding an icon.
* [http://java.sun.com/developer/technicalArticles/JavaLP/JavaToMac3/ Bringing your Java Application to Mac OS X] I would regard this a little dated, and the detail is (unsurprisingly) Java-related, but it is a gentle introduction to the role of the .app bundle and give a most clear account of how to create one.
* The [http://gimp-app.sourceforge.net/gimp.app.howto.txt Gimp .app Howto] This is a very bare document, and would be of little help to you if you were new to making packages. Note that it seems to refer to a more mature Clipboard technique and Online help than we currently have; and we ought to move to parity in these areas.

=See also=
*[[Compiling Inkscape]]
*[[Notes on Packaging for OS X]]
* https://github.com/valerioa/Inkscape-MacOS-Curated-Build

[[Category:Developer Documentation]]

CompilingMacOsX

2019-04-29T17:22:37Z

Ipatch:

= Using MacPorts =

<ol>
<li>Install [http://developer.apple.com/tools/xcode/ Xcode tools] from the App Store
<li>Download and install [http://www.macports.org/ MacPorts]
<li>Edit the MacPorts variants config (optional).
 Add this line to <code>/opt/local/etc/macports/variants.conf</code>
<pre>-x11 +quartz</pre>
<li>In Terminal (Applications>Utilities>Terminal) type
<syntaxhighlight lang="bash">sudo port selfupdate
sudo port install \
cmake cairo boehmgc intltool libxslt lcms2 boost \
poppler gsl adwaita-icon-theme gdl3 gtkmm3 libsoup \
double-conversion \
-x11 +quartz
</syntaxhighlight>
<li>In Terminal, get Inkscape
<syntaxhighlight lang="bash">git clone --recurse-submodules git@gitlab.com:inkscape/inkscape.git</syntaxhighlight>
<li>And build inkscape
<syntaxhighlight lang="bash">
# use a clean MacPorts environment (optional)
LIBPREFIX="/opt/local"
export PATH="$LIBPREFIX/bin:/usr/bin:/bin:/usr/sbin:/sbin"

# where to build and install
PREFIX="$PWD/install-prefix"
mkdir build
cd build

cmake \
-DCMAKE_PREFIX_PATH="$LIBPREFIX" \
-DCMAKE_INSTALL_PREFIX="$PREFIX" \
-DWITH_OPENMP=OFF \
..

make install
</syntaxhighlight>
<li>Run Inkscape
<syntaxhighlight lang="bash">
$PREFIX/bin/inkscape
</syntaxhighlight>
</ol>

== Speed up Installation ==

You can use <code>[https://en.wikipedia.org/wiki/Ccache ccache]</code> (<code>sudo port install ccache</code>) to speed up re-compilation.
Also, [https://ninja-build.org/ ninja] (<code>sudo port install ninja</code>) is a faster alternative to <code>make</code>.
Modify your call to <code>cmake</code> like this:

cmake \
-DCMAKE_C_COMPILER_LAUNCHER=ccache \
-DCMAKE_CXX_COMPILER_LAUNCHER=ccache \
-G Ninja \
# more cmake options here

ninja
ninja install

== Troubleshooting ==

Linking fails with:

ld: framework not found -lCocoa

A patch like this should help (reverts part of
[https://gitlab.com/inkscape/inkscape/commit/48e6c2ea4fc0245afc35cbbc6563804abf421ccd 48e6c2ea4f], see also
[https://gitlab.com/inkscape/inkscape/merge_requests/397 !397]):

<syntaxhighlight lang="diff">
diff --git a/CMakeScripts/DefineDependsandFlags.cmake b/CMakeScripts/DefineDependsandFlags.cmake
index 4cb63aae80..7a0b5cbc75 100644
--- a/CMakeScripts/DefineDependsandFlags.cmake
+++ b/CMakeScripts/DefineDependsandFlags.cmake
@@ -253,7 +253,7 @@ pkg_check_modules(GTKSPELL3 gtkspell3-3.0)
if("${GTKSPELL3_FOUND}")
message(STATUS "Using GtkSpell 3")
list(APPEND INKSCAPE_INCS_SYS ${GTKSPELL3_INCLUDE_DIRS})
- list(APPEND INKSCAPE_LIBS ${GTKSPELL3_LDFLAGS})
+ list(APPEND INKSCAPE_LIBS ${GTKSPELL3_LIBRARIES})
set(WITH_GTKSPELL ON)
else()
set(WITH_GTKSPELL OFF)
</syntaxhighlight>

= Using Homebrew =

The Inkscape CI job uses homebrew, see [https://gitlab.com/inkscape/inkscape/blob/master/.gitlab-ci.yml#L51-71 .gitlab-ci.yml]

= Misc =

{{Needs_update}}

== Extension Python modules ==

In case you are using a Python version installed through MacPorts do a search for both modules and install the ones suitable for the Python version activated within MacPorts.
<pre>port search lxml numpy</pre>

For further info refer to the [[GettingEffectsWorking#on_Mac_OS_X|Getting Effects Working]] section of this wiki.

== Creating an .app bundle ==

TODO

== Creating a disk image to distribute Inkscape ==

TODO

= Links =

== User Examples ==
* [github.com/ipatch] | A recent '''2019''' collection of notes about building Inkscape from master using CMake + Ninja | [https://github.com/ipatch/homebrew-us-05/blob/master/inkscape/inkscape-building-for-macOS.md Notes]
* Adam Strzeleki has outlined some improvements to this process on the Inkscape [http://www.nabble.com/Inkscape-native-Mac-OS-X-build---look-improvements-td14733036.html email list]. See his screenshot from January 10, 2008 [http://www.nabble.com/attachment/14733036/1/Inkscape%20OSX%20PL.gif here].
* JiHO has a video of his builds [http://jo.irisson.free.fr/?p=34 here] and [http://jo.irisson.free.fr/?p=62 here].
* Mac OS X native (aqua), PPC-only, Tiger-only build of 0.47, can be retrieved here: [http://verkehrsplanung.com/Inkscape_aqua_PPC_047.zip]. NOT FOR PRODUCTIVE USE - JUST TESTING! - (Nevertheless I'm doing quite a bit productive work on it… (-;)

== Apple Documentation ==
* [http://developer.apple.com/documentation/MacOSX/Conceptual/BPRuntimeConfig/BPRuntimeConfig.html Introduction to Runtime Configuration] Covers the Info.plist files, Preferences, Environment variables and has a list of the most important Properties that the Property List should contain.

== Packaging ==

* [http://www.sveinbjorn.org/platypus Sveinbjorn Thordarson's Website] The author of Platypus, the Script Exec wrapper that launches the Inkscape binary.
* [http://freespace.ausgamers.com/2005/02/creating-os-x-application-bundles-step.html Creating OS X application bundles step by step] Covers the bundle concepts, copying libraries into the bundle, editing libraries with the install_name_tool, the Info.plist file and adding an icon.
* [http://java.sun.com/developer/technicalArticles/JavaLP/JavaToMac3/ Bringing your Java Application to Mac OS X] I would regard this a little dated, and the detail is (unsurprisingly) Java-related, but it is a gentle introduction to the role of the .app bundle and give a most clear account of how to create one.
* The [http://gimp-app.sourceforge.net/gimp.app.howto.txt Gimp .app Howto] This is a very bare document, and would be of little help to you if you were new to making packages. Note that it seems to refer to a more mature Clipboard technique and Online help than we currently have; and we ought to move to parity in these areas.

=See also=
*[[Compiling Inkscape]]
*[[Notes on Packaging for OS X]]
* https://github.com/valerioa/Inkscape-MacOS-Curated-Build

[[Category:Developer Documentation]]

User:Ipatch

2019-02-10T22:13:45Z

Ipatch:

==== Contact ====
GitHub [http://github.com/ipatch @ipatch] 
GitLab [http://gitlab.com/truckmonth @truckmonth] 
twitter [http://twitter.com/truckmonth @truckmonth]

User:Ipatch

2019-02-10T22:09:03Z

Ipatch:

==== Contact ====
GitHub @ipatch 
GitLab @truckmonth 
twitter @truckmonth

User:Ipatch

2019-02-10T22:08:38Z

Ipatch: /* ipatch */

=== ipatch ===

==== Contact ====

GitHub @ipatch 
GitLab @truckmonth 
twitter @truckmonth

User:Ipatch

2019-02-10T22:07:57Z

Ipatch:

== ipatch ==

=== Contact ===

GitHub @ipatch
GitLab @truckmonth
twitter @truckmonth

User:Ipatch

2019-02-10T22:07:11Z

Ipatch: Created page with "## ipatch ### Contact GitHub @ipatch GitLab @truckmonth twitter @truckmonth"

## ipatch

### Contact

GitHub @ipatch
GitLab @truckmonth
twitter @truckmonth