Yamyam: 1版をインポートしました

2018-06-28T18:45:56Z

1版をインポートしました

2016年1月4日 (月) 10:06にwiki>Ideasman42による

2016-01-04T10:06:27Z

新規ページ

= 3. Compile Blender with CMake =

== Installing CMake ==

Install CMake from your package manager.

{{#switch:{{FULLPAGENAME}}
|Dev:Doc/Building Blender/Linux/Ubuntu/CMake=
<source lang="bash">sudo apt-get install cmake cmake-curses-gui</source>
|Dev:Doc/Building Blender/Linux/Fedora 12/Cmake=
<source lang="bash">su -c 'yum install cmake cmake-curses-gui'</source>
|Dev:Doc/Building Blender/Linux/Gentoo/CMake=
<source lang="bash">sudo emerge dev-util/cmake</source>
|Dev:Doc/Building Blender/Linux/Arch/CMake=
<source lang="bash">pacman -S cmake</source>
|}}

== Automatic CMake Setup ==
If you're not interested in manually setting up CMake build directory, configuring, building and installing in separate steps, we provide a convenience makefile in Blender's source directory which sets up CMake for you.
<source lang="bash">
cd ~/blender-git/blender
make
</source>

Once the build finishes you'll get a message like..
Blender successfully built, run from: /home/me/blender-git/build_linux/bin/blender

Updating your local checkout and rebuilding is as simple as:

<source lang="bash">
cd ~/blender-git/blender
make update
make
</source>

There are some pre-defined build targets:

* <tt>make</tt> - some are turned off by default because they can be difficult to correctly configure for newer developers and aren't essential to use & develop Blender in most cases.
* <tt>make lite</tt> - the quickest way to get a Blender build up & running, can also help to avoid installing a lot of dependencies if you don't need video-codecs, physics-sim & cycles rendering.
* <tt>make full</tt> - this makes a complete build with all options enabled, matching the releases on '''blender.org'''.

For a full list of the optional targets type...
<source lang="bash">
make help
</source>

== Manual CMake Setup ==
{{Template:MoreDetails | + Manual CMake Setup (optional) |
If you want to have more control over your build configuration or have multiple build directories for a single source directory.
You can follow these steps.

''Typically useful for developers, who built frequently.''

=== Preparing CMake's directory ===

Now you have to choose a location for CMake build files, currently '''in-source builds in Blender aren't supported'''.

''' Out-of-source build '''

By doing an [http://www.cmake.org/Wiki/CMake_FAQ#What_is_an_.22out-of-source.22_build.3F "out-of-source" build] you create a CMake's directory aside from <code>~/blender-git/blender</code>, for example <code>~/blender-git/build</code>:

<source lang="bash">
mkdir ~/blender-git/build
cd ~/blender-git/build
cmake ../blender
</source>

This will generate makefiles in the build directory (<code>~/blender-git/build</code>).

{{Note|Warning|{{Warning/Important}}As said above, ''in-source-builds'' where you build blender from the source code directory are not supported. 
If CMake finds a <code>CMakeCache.txt</code> in the source code directory, it uses that instead of using <code>~/blender-git/build/CMakeCache.txt</code>.

If you have tried to do an in-source build, you should remove any CMakeCache.txt from the source code directory before actually running the out-of-source build:

<source lang="bash">
rm ~/blender-git/blender/CMakeCache.txt
</source>}}

=== Editing CMake Parameters ===

''Note that CMake should detect correct parameters so you shouldn't need change defaults to simply to compile blender, this is only if you want to change defaults, make a debug build, disable features etc, so you may want to skip this section for now and come back to it later if you want to make adjustments.''

You can modify the build parameters in different ways:

* editing <code>~/blender-git/build/CMakeCache.txt</code> file in a text editor
* using '''cmake-gui''' if your distro supports it
:<source lang="bash">cmake-gui ../blender</source>
: Opens a graphical interface where you can easily change parameters and re-configure things.
* using '''ccmake''' tool, with
:<source lang="bash">ccmake ../blender</source>
: Opens a text interface where you can easily change parameters and re-configure things.
* cmake parameters can also be easily set on the command line, for eg.
<source lang="bash">
cmake ../blender \
-DCMAKE_INSTALL_PREFIX=/opt/blender \
-DWITH_INSTALL_PORTABLE=OFF \
-DWITH_BUILDINFO=OFF \
-DWITH_GAMEENGINE=OFF
</source>
: These commands are exactly those found in <code>~/blender-git/build/CMakeCache.txt</code> so you can copy commands from there and use them in the command line without running ccmake.

[[File:Cmake-gui.jpg|thumb|300px|left|Screenshot from cmake-gui, qt based gui for cmake]]
[[File:Ccmake.jpg|thumb|300px|right|Screenshot from ccmake, curse-based gui for cmake]]
{{clr}}

=== Building Blender ===

After changes have been done and you have generated the makefiles, you can compile using the ''make'' command inside the build directory:

<source lang="bash">
cd ~/blender-git/build
make
make install
</source>

{{Dev:Doc/Building_Blender/MakeJobs}}

Also notice the '''install''' target is used, this will copy scripts and documentation into '''~/blender-git/build/bin'''

For future builds you can simply update the repository and re-run make.
<source lang="bash">
cd ~/blender-git/blender
git pull --rebase
git submodule foreach git pull --rebase origin master
cd ~/blender-git/build
make
make install
</source>

{{Note|Notice|{{Warning/Important}}Both portable & system installations are supported.

Portable installation is default where scripts and data files will be copied into the build '~/blender-git/build/bin' directory and can be moved to other systems easily.

Disable <code>WITH_INSTALL_PORTABLE</code> to install into <code>CMAKE_INSTALL_PREFIX</code> which uses a typical Unix [http://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard FHS] layout: bin/, share/blender/, man/ etc.
}}

=== Static Linking ===
If you want to share your build with others you may want to include libraries with Blender (statically linked libraries).

{{Note|Listing needed shared libs|You can see all needed shared libraries by running:
<source lang="bash">
objdump -x path/to/blender | grep "NEEDED"
</source>
}}

Note: by default, Python is not static. To make it so, You'll have to edit <code>PYTHON_LYBRARY</code> to something like <code>/usr/lib/libpython3.4m.a;/usr/lib/libexpat.a</code> (exact paths depend on your OS).

----

'''Static Linking Each Library:'''

;Enable general static linking
:Set WITH_STATIC_LIBS to ON, so that CMake will try to make blender link against static libs, when available. Though not perfect, this should reduce quite nicely needed shared libs.

;ffmpeg
:Set the FFMPEG_LIBRARIES var to full paths of all needed libs (xvid, x264, etc.).

;boost
:Set (or create) Boost_USE_STATIC_LIBS to true. If you are using boost automatically built by the install_deps.sh script, you should not need to do anything else.
:But if you are using your own distro's boost package, you most likely will have to set (or create) Boost_USE_ICU to true too (and install the relevant libicu development package), to get blender linking.

TODO: other libs?

}}
== Optimize Rebuilds ==

{{Template:MoreDetails | + Optimize Rebuilds (optional) |
Now that you can build blender and run blender, there are changes you can make which greatly increase the speed of build times.

Use one of the CMake configuration editors (ccmake or cmake-gui), see [[Dev:Doc/Building_Blender/Linux/cmake#Editing_CMake_Parameters | Editing CMake Parameters]]

For really fast rebuilds you can disable Every option with the '''WITH_''' prefix, except for WITH_PYTHON which is needed for the UI. This speeds up linking and gives a smaller binary.

Remove the files created by '''make install''' since they will become stale.
However, blender still needs to be able to find its scripts or you will have a very minimalist looking interface.
This can be solved by linking the source directory to your blender binary path so copying isn't needed and scripts are always up to date.

<source lang="bash">
rm -r ~/blender-git/build/bin/*.*
ln -s ~/blender-git/blender/release ~/blender-git/build/bin/
</source>

For convenient access, create this symlink to run blender from the source directory:
<source lang="bash">
ln -s ~/blender-git/build/bin/blender ~/blender-git/blender/blender.bin
</source>
You can add any files created this way to ''~/blender-git/blender/.git/info/exclude'' so they won't count as untracked files for git. Add your local files here, instead of in .gitignore, because .gitignore is also committed and will affect everyone else.

}}
== See also ==

* [[Dev:Doc/IDE_Configuration|CMake & IDE Configuration]]

[[Category:Script]]

← 古い版	2018年6月28日 (木) 18:45時点における版
(相違点なし)

Dev:Doc/Building Blender/Linux/cmake - 版の履歴

Yamyam: 1版 をインポートしました

2016年1月4日 (月) 10:06にwiki>Ideasman42による

Yamyam: 1版をインポートしました