216
edits
Building on Microsoft Windows: Difference between revisions
→Building natively (MSYS2): Add comments for different configuration.
(→Building Octave: Update introducing sentence) |
(→Building natively (MSYS2): Add comments for different configuration.) |
||
| Line 94: | Line 94: | ||
The following command can be used to install the necessary and optional build dependencies in MSYS2: | The following command can be used to install the necessary and optional build dependencies in MSYS2: | ||
< | <syntaxhighlight lang="bash">pacman -S base-devel mingw-w64-x86_64-toolchain mingw-w64-x86_64-lapack mingw-w64-x86_64-openblas mingw-w64-x86_64-pcre \ | ||
mingw-w64-x86_64-arpack mingw-w64-x86_64-curl mingw-w64-x86_64-cvode mingw-w64-x86_64-fftw mingw-w64-x86_64-fltk mingw-w64-x86_64-gl2ps mingw-w64-x86_64-glpk mingw-w64-x86_64-ghostscript mingw-w64-x86_64-gnuplot mingw-w64-x86_64-graphicsmagick mingw-w64-x86_64-hdf5 mingw-w64-x86_64-libsndfile mingw-w64-x86_64-portaudio mingw-w64-x86_64-qhull mingw-w64-x86_64-qrupdate mingw-w64-x86_64-qscintilla mingw-w64-x86_64-qt5 mingw-w64-x86_64-rapidjson mingw-w64-x86_64-suitesparse \ | mingw-w64-x86_64-arpack mingw-w64-x86_64-curl mingw-w64-x86_64-cvode mingw-w64-x86_64-fftw mingw-w64-x86_64-fltk mingw-w64-x86_64-gl2ps mingw-w64-x86_64-glpk mingw-w64-x86_64-ghostscript mingw-w64-x86_64-gnuplot mingw-w64-x86_64-graphicsmagick mingw-w64-x86_64-hdf5 mingw-w64-x86_64-libsndfile mingw-w64-x86_64-portaudio mingw-w64-x86_64-qhull mingw-w64-x86_64-qrupdate mingw-w64-x86_64-qscintilla mingw-w64-x86_64-qt5 mingw-w64-x86_64-rapidjson mingw-w64-x86_64-suitesparse \ | ||
git mercurial mingw-w64-x86_64-ccache mingw-w64-x86_64-icoutils mingw-w64-x86_64-librsvg texinfo</ | git mercurial mingw-w64-x86_64-ccache mingw-w64-x86_64-icoutils mingw-w64-x86_64-librsvg texinfo</syntaxhighlight> | ||
Using ccache is optional. It speeds up compilation time but needs several GiB free disc space for its cache. If disc space is an issue, this step can be skipped. To prepend the path to the ccache helper scripts to the front of the PATH variable, add the following line near the end of the {{Path|.bash_profile}} file in your MSYS2 {{Path|$HOME}} directory: | Using ccache is optional. It speeds up compilation time but needs several GiB free disc space for its cache. If disc space is an issue, this step can be skipped. To prepend the path to the ccache helper scripts to the front of the PATH variable, add the following line near the end of the {{Path|.bash_profile}} file in your MSYS2 {{Path|$HOME}} directory: | ||
< | <syntaxhighlight lang="bash">export PATH="/mingw64/lib/ccache/bin:$PATH"</syntaxhighlight> | ||
Like installing the build dependencies, this has to be done only once. | Like installing the build dependencies, this has to be done only once. | ||
To build from the development sources, check out the Mercurial repository and run the {{Path|bootstrap}} script: | To build from the development sources, check out the Mercurial repository and run the {{Path|bootstrap}} script: | ||
< | <syntaxhighlight lang="bash">hg clone https://www.octave.org/hg/octave | ||
cd octave | cd octave | ||
./bootstrap</ | ./bootstrap</syntaxhighlight> | ||
Create a sub-directory to avoid building in the source tree: | Create a sub-directory to avoid building in the source tree: | ||
< | <syntaxhighlight lang="bash">mkdir -p .build | ||
cd .build</ | cd .build</syntaxhighlight> | ||
Configure with the following flags: | Configure with the following flags: | ||
< | <syntaxhighlight lang="bash">../configure \ | ||
CC="x86_64-w64-mingw32-gcc" \ | CC="x86_64-w64-mingw32-gcc" \ | ||
CXX="x86_64-w64-mingw32-g++" \ | CXX="x86_64-w64-mingw32-g++" \ | ||
F77="x86_64-w64-mingw32-gfortran" \ | F77="x86_64-w64-mingw32-gfortran" \ | ||
--disable-docs \ | --disable-docs \ | ||
ac_cv_search_tputs=-ltermcap</ | ac_cv_search_tputs=-ltermcap</syntaxhighlight> | ||
And build with the following flags: | And build with the following flags: | ||
< | <syntaxhighlight lang="bash">make -C ./.build all -j8 V=1 \ | ||
FLTK_LIBS="-lfltk_gl -lopengl32 -lglu32 -lfltk -lpthread" \ | FLTK_LIBS="-lfltk_gl -lopengl32 -lglu32 -lfltk -lpthread" \ | ||
PORTAUDIO_LIBS="-lportaudio -ldsound -lsetupapi -lwinmm -lm -lole32" | PORTAUDIO_LIBS="-lportaudio -ldsound -lsetupapi -lwinmm -lm -lole32" | ||
</ | </syntaxhighlight> | ||
If you didn't build with FLTK or PortAudio, omit overriding the respective flags. | |||
Octave doesn't run correctly from the MSYS2 shell due to issues with readline and backslash as a file separator. To be able to work with it anyway, install it with the following commands: | Octave doesn't run correctly from the MSYS2 shell due to issues with readline and backslash as a file separator. To be able to work with it anyway, install it with the following commands (from the MSYS2 shell in {{Path|.build}}): | ||
< | <syntaxhighlight lang="bash">make install | ||
ln -sf /mingw64/libexec/octave/7.0.0/exec/x86_64-w64-mingw32/octave-gui.exe /mingw64/bin/octave-gui.exe | ln -sf /mingw64/libexec/octave/7.0.0/exec/x86_64-w64-mingw32/octave-gui.exe /mingw64/bin/octave-gui.exe | ||
ln -sf /mingw64/libexec/octave/7.0.0/exec/x86_64-w64-mingw32/octave-svgconvert.exe /mingw64/bin/octave-svgconvert.exe</ | ln -sf /mingw64/libexec/octave/7.0.0/exec/x86_64-w64-mingw32/octave-svgconvert.exe /mingw64/bin/octave-svgconvert.exe</syntaxhighlight> | ||
The latter two symlinks are only needed when building the GUI (i.e., Qt is not disabled). | |||
Start Octave from a CMD shell (or with a batch script) with the following | Start Octave from a CMD shell (or with a batch script) with the following commands (assuming MSYS2 was installed in its default location): | ||
< | <syntaxhighlight lang="batch">set PATH=C:\msys64\mingw64\bin;C:\msys64\usr\bin;%PATH% | ||
set MSYSTEM=MINGW64 | set MSYSTEM=MINGW64 | ||
set TERM=cygwin | set TERM=cygwin | ||
| Line 138: | Line 140: | ||
set GS=gs.exe | set GS=gs.exe | ||
set PERL5SHELL=bash -l -c | set PERL5SHELL=bash -l -c | ||
octave-gui --gui</ | octave-gui --gui</syntaxhighlight> | ||
If Octave was built without GUI, there won't be an {{Path|octave-gui}} executable. In that case, replace the last line with <code>octave-cli</code>. | |||
=Footnotes= | =Footnotes= | ||