この記事はFaust(多分ひとり)Advent Calenderの3つ目の記事です。

本日はFaustのコンパイラをビルドする時、インストールする時の注意点について書こうと思います。

Faustには2種類ある

さて、前の記事とかでもfaust2ブランチという言葉を使っていましたが、Faustのコンパイラは2種類存在します。

一つは普通のfaust、こちらはfaustソースをC++にコンパイルするだけのシンプルなもの(mathdocとかは使えたはずですが)です。

もう一つはfaust2というもので、こちらがLLVMを利用して実行時コンパイルやasm.jsを利用したWebaudioエクスポートが可能になっています。

Homebrew Formula作りました(2017/09/06追記)

これです。faust2のみ対応です（2バージョンを1Formulaに入れるのはダメらしいので）。

https://github.com/tomoyanonymous/homebrew-faust

インストール

brew tap tomoyanonymous/faust
brew install faust [option]

オプション

標準ではstable releaseのv2.1.0がインストールされます。

–HEAD:faust2ブランチの最新版がインストールされます。
–without-httpd,–without-sound2faust,–without-dynamic いずれも、標準ではhttpを使えるようなオプション、libfaustの動的リンクライブラリ、wavファイルをfaustのwaveformによるテキストに出力するsound2faustというツールを勝手にインストールします。要らなければこれらのオプションを付けて下さい。

依存

llvm(現状は4.0.1です)
openssl
pkg-config
libmicrohttpd(httpdで必要)
libsndfile(sound2faustで必要)

いずれも入ってなければHomebrewが勝手にインストールします。

自力インストール

コンパイラをダウンロードしよう

さて、コンパイラはFaustliveやfaustgen~と違って残念ながらビルド済みのバイナリは配布されていません。そのため自力でソースからビルドする必要があります。

Faustのリポジトリはこちら。

https://github.com/grame-cncm/faust

通常版のfaustがmasterブランチ、faust2はfaust2ブランチという用にgitのブランチでバージョン違いがあるので、gitが入ってない方はインストールをオススメします。

というわけでDLは

cd path/to/dldir

git clone [email protected]:grame-cncm/faust.git

で落としてきます。

ビルド

前準備

Macの人はmakeコマンドを使うためにXcode Command Line Toolsが必要です。 AppstoreからXcodeインストールした上で

xcode-select --install

でインストール。

faust(通常版)

masterブランチに移動します（DL時は最初からそうだと思いますが念のため）。

cd path/to/faust
git checkout master

Mac/Linux

make

でビルドが走ります。特に何も依存ライブラリは無いはずです。

sudo make install

でUnixならusr/local/にインストールされます。(usr/local/binの中にfaustコマンドとfaust2xxxのスクリプト群、usr/local/includeに標準アーキテクチャファイルなどのヘッダ類が入ります。)

また、DockerfileもあるのでDockerで使うことも可能です。

Windows

Visual Studioでのインストールが推奨されているようです。（すみません、こちらはまだ試していません。）

VS2012以上でfaust/windows/faust_vs2012.slnというVisual Studio solutionファイルを開いてビルドします。ターゲットはデバッグ、リリースどちらでも行けるそうです(以下、筆者はMacでしかまだビルドしたことがないのでMacの情報中心に書かせてもらいます。すみません)。

faust2

依存ライブラリ

LLVM

faust2はLLVMの実行時コンパイルを使うために当然ながらLLVMのインストールが必要です。 LLVMのバージョンは

3.1<バージョン<=4.0.0が対応済みです。私は3.8.1でインストールできています。

Macの場合、

#Macports

sudo port install llvm-3.xx

#Homebrew
brew tap homebrew/versions
sudo brew install llvm38

とかでいけます。

※どちらもビルドするのに1時間半ほどCPUがフルパワーで回りっぱなしになりますので注意

ユニバーサルバイナリである必要が有る、とのことでしたが最近はHomebrewからuniversalオプションがいつからか消えています。私の環境では特にそのままでもインストールできています。。brew install llvmをすると現在は4.0.1がインストールされるようになっています。こちらはfaust2ブランチのHEADは対応していますがstableリリースのv2.1.0では4.0.0までしか対応しておりません（Makefileに番号が入ってないだけなので、自力で書き換えれば多分出来ますが。）

llvm関係のコマンドのパスを確定させるためにllvm-configというコマンドを使うのですが、Makefileでは最初に/usr/bin→opt/local/bin→/usr/local/binという順番でllvm-configを探し、なければllvm-config-3.9→llvm-config-3.8という順でバージョンの高い順番にサフィックスを付けて検索していくので、Homebrewでインストールした場合でも勝手に見つけてくれる用になってます。

もしくはこちらからバイナリを落としてきて、 https://llvm.org/releases/download.html

faudiostream-code/compiler/Makefile.unixの28行目を直接編集してしまい、

#これを
LLVM_CONFIG = $(lastword $(wildcard /usr/bin/llvm-config* /opt/local/bin/llvm-config* /usr/local/bin/llvm-config*) $(shell which llvm-config 2> /dev/null))
#こうする

LLVM＿CONFIG = /dl/folder/of/llvm/bin/llvm-config

というように、DLしたLLVMのllvm-configのパスを直接指定するのも手っ取り早い方法です。

openssl

例によってMacびいきですみませんが、

#Macports

sudo port install openssl +universal

#Homebrew

sudo brew install openssl --universal

とかでいけます。ただhomebrewでは標準で/usr/localにリンクしてくれず

brew link openssl --force

で入れてやらないとインクルードパスが通りません。しかもどうやら最近これもbrew link openssl –forceができない問題というのがあるらしく、openssl関係でエラーが出た場合は、未検証ですがcompiler/Makefile.unixの135行目あたりに

CXXFLAGS += -Wall -Wuninitialized -fvisibility=hidden -Wno-overloaded-virtual -Wno-parentheses $(addprefix -I, $(subprojects)) -DINSTALL_PREFIX='"$(prefix)"'
CXXFLAGS += -I`$(LLVM_CONFIG) --includedir` -I../architecture -D$(LLVM_VERSION) -D__STDC_LIMIT_MACROS -D__STDC_CONSTANT_MACROS
CXXFLAGS += $(ARCHFLAGS)
#これ↓を追加
OPENSSL = $(shell brew --prefix openssl)
CXXFLAGS += -I`$(OPENSSL)`

で、多分行けるはず・・・

libmicrohttpd

こちらは標準では必要ないですがmake dynamicで動的ライブラリを生成する時にhttpとOSCのサポートをするために必要です。

#Macports

sudo port install libmicrohttpd +universal

#Homebrew

sudo brew install libmicrohttpd --universal

faust2のビルド

やっとですがfaust2ブランチにチェックアウト。

cd path/to/faust
git checkout faust2

ここからは同様に

make

エラー無く行ければ通常版のfaustと違いcompiler/内にlibfaust.aという静的ライブラリが出来ているはずです。

sudo make install

で同じように/usr/local内にコピーされます。

注意点

CMakeLists.txtがありますがこちらは使われておらず直接Makefileを更新しているようです。うっかりcmakeを走らせると全然対応してないMakefileが出てきて大変なことになります。
最近でもLLVMのバージョンごとにビルドエラーが出たり出なかったりが結構あるみたいなのでLLVMのパスがちゃんと通ってそうでもLLVM関係のエラーが出る場合はバージョンを変えてみるのもありだと思います（LLVM自体のビルドがめちゃくちゃ時間かかるのが難ですが・・・）

次の記事では

ここまで書いても実際どういう感じでコードを書けばいいのかわかるまで結構時間がかかります。ので実践的にFaustのコードを書く時のコツやコードのスタイルなどを書いてみようと思います。

Faustのコンパイラのビルドとインストール時の注意点