filament-build

Google Filament をソースからマルチプラットフォーム向けにビルドし、GitHub Releases で配布するプロジェクト。

背景

Filament 公式のプリビルトバイナリは iOS simulator arm64 (platform: iossim) に対応していない。Apple Silicon Mac の iOS シミュレーターは arm64 で動作するが、公式バイナリの arm64 スライスは platform 2 (ios) タグが付いておりリンクできない。EXCLUDED_ARCHS で arm64 を除外し Rosetta 2 経由で実行する回避策は、Apple が Rosetta の汎用利用を段階的に廃止するため期限がある。

このプロジェクトは公式が提供していない iOS simulator arm64 を含む、ネイティブアプリ開発向けプラットフォームのプリビルトバイナリを提供する。

対応プラットフォーム

ターゲット	アーキテクチャ	ランナー	公式提供
macOS	arm64	macos-latest	あり
iOS device	arm64	macos-latest	あり
iOS simulator	arm64	macos-latest	なし
Android	arm64-v8a	ubuntu-latest	あり
Windows	x64	windows-latest	あり
Web	WebAssembly	ubuntu-latest	あり

ダウンロード

プリビルトバイナリは Releases ページから取得できる。

各リリースに含まれる成果物:

filament-v{version}-macos_arm64.tar.gz
filament-v{version}-ios_device_arm64.tar.gz
filament-v{version}-ios_simulator_arm64.tar.gz
filament-v{version}-android_arm64_v8a.tar.gz
filament-v{version}-windows_x64.tar.gz
filament-v{version}-web_wasm.tar.gz

各アーカイブの構成は全ターゲットで共通:

filament/
├── lib/          # 静的ライブラリ (.a / .lib)
├── include/      # ヘッダーファイル
├── LICENSE
├── NOTICE
└── VERSIONS

Web (WebAssembly) アーカイブの lib/*.a は Emscripten 形式の静的 アーカイブで、consumer 側の wasm モジュール (例: 自前の agx_api.cpp) と static link される前提で提供している。 Filament 公式が配布している filament-js (filament.js + filament.wasm のリンク済み JavaScript bundle) は目的が違う ため、このプロジェクトからは配布しない。

ローカルビルド

必要なもの:

• Python 3
• CMake, Ninja
• Xcode (macOS/iOS ターゲット)
• Android NDK (Android ターゲット、ANDROID_HOME の設定が必要)
• Visual Studio + MSVC (Windows ターゲット)
• Emscripten SDK (Web ターゲット、EMSDK の設定が必要)

# ビルド
python3 run.py build <target>

# パッケージング
python3 run.py package <target>

ターゲット: macos_arm64, ios_device_arm64, ios_simulator_arm64, android_arm64_v8a, windows_x64, web_wasm

CI/CD

GitHub Actions でビルドを自動化している。バージョンタグ (v*) を push すると自動で Release が作成される。

workflow_dispatch で個別プラットフォームの手動ビルドも可能。

バージョニング

Filament のアップストリームバージョンに追従する。VERSION ファイルで管理:

• FILAMENT_VERSION - Filament のバージョン
• FILAMENT_COMMIT - checkout する git タグ
• FILAMENT_BUILD_VERSION - リビルド用サフィックス付きバージョン (例: 1.70.2.0)

ライセンス

Apache License 2.0

このプロジェクトが利用しているソフトウェアのライセンスの詳細は NOTICE を参照。