【プラグイン開発記】JUCE 8によるWindows VST3からmacOS Universal AU（Logic Pro）への移植と互換性検証の知見

個人や小規模チームによるブティック・オーディオプラグイン開発において、最大の技術的ハードルの一つが**「Windows環境からmacOS環境（とりわけAppleのLogic Pro / Audio Unit規格）への移植と動作検証」**です。

Windows上のCubaseやStudio One、FL Studioで軽快に動作するVST3プラグインを、そのままMacへ持ち込んでも、macOS特有の厳格なセキュリティ機構（Gatekeeper / 署名・公証）、Apple Silicon（M1〜M4）とIntel CPUのアーキテクチャ差異、そしてApple独自の**AUVal（Audio Unit Validation Tool）**による厳密なバリデーションテストによって、初期段階ではクラッシュやスキャン失敗が頻発します。

本稿では、Lo-bit recordの全プラグインをmacOS Universal Binary（.component）へとビルドし、Logic Proでの動作認定を完了させた開発現場の生きた知見をまとめます。

1. Universal Binaryビルド：arm64とx86_64のクロスコンパイル

現代のmacOS市場では、M1/M2/M3/M4などのApple Silicon搭載Macが主流ですが、スタジオの制作現場では依然としてIntel Mac環境も稼働しています。

JUCE 8とCMake（またはXcode）を用いてビルドを行う際、**1つの .component バンドルの中に両方のバイナリを内包する「Universal Binary 2」**として出力する必要があります。

# Lipotoolによるバイナリ構造の確認コマンド
lipo -info MyPlugin.component/Contents/MacOS/MyPlugin
# 期待される出力:
# Architectures in the fat file: MyPlugin are: x86_64 arm64

SIMD命令セットの差異

Windows/Intel環境で _mm_load_ps や _mm_mul_ps などのIntel SSE/AVX命令を直接ハードコードしていると、Apple Silicon（ARM NEONアーキテクチャ）のコンパイル時にエラーとなります。 JUCE 8が提供する抽象化レイヤー（juce::dsp::SIMDRegister）を活用するか、NEON組み込み関数への条件分岐マクロを正しく設計することが不可欠です。

2. Logic Proの門番「auval（Audio Unit Validation）」をパスする条件

Logic ProやGarageBandは、プラグインを読み込む前にターミナルバックグラウンドで auval コマンドを実行し、Appleが定める規格にミリ秒単位で準拠しているかをテストします。ここで1項目でもFailすると、DAW側でブラックリスト入りして起動すらしません。

頻出する3大クラッシュ原因と解決策

1. 初期化時のレイテンシ・バッファサイズ不正:
   prepareToPlay(double sampleRate, int samplesPerBlock) が呼び出される前に processBlock 内でバッファにアクセスするとセグメンテーション違反で即死します。必ずポインタのnullチェックとatomicな初期化フラグを設ける必要があります。
2. チャンネル構成の不整合（BusesProperties）:
   Logic Proはステレオトラックだけでなく、Mono-to-StereoやMonoトラックでのインサートを頻繁に行います。AudioProcessor::BusesProperties で withInput("Input", AudioChannelSet::stereo(), true) だけでなく、Mono構成を明示的にサポートしていないとValidationで弾かれます。
3. GUIスレッドとオーディオレンダリングスレッドの競合:
   processBlock 内でパラメータの変更通知（repaint() やメッセージマネージャのロック）を直接呼び出すと、リアルタイム優先スレッドがブロックされ、auvalのレンダリング整合性テストでタイムアウトが発生します。パラメータの描画連携には必ずロックフリーキュー（Lock-Free FIFO）または std::atomic を介在させます。

3. macOS Gatekeeper（未署名・未公証）プラグインの安全なロード手順

現在、Appleの公式Developer ID証明書（年間$99のApple Developer Program）による公証（Notarization）を取得していないインディペンデントな配布物の場合、macOSはダウンロードされたファイルに拡張属性 com.apple.quarantine（隔離フラグ）を自動付与します。

これにより、ユーザーが /Library/Audio/Plug-Ins/Components/ に配置しても「開発元を検証できないため開けません」と警告され、Logic Proがプラグインをブロックします。

ユーザー側の解決策：xattrによる隔離属性の解除

ターミナルから以下のコマンドを実行することで、安全にGatekeeperの隔離フラグのみを解除できます。

sudo xattr -rd com.apple.quarantine /Library/Audio/Plug-Ins/Components/MyPlugin.component

このコマンド実行後、Logic Proの「プラグインマネージャー」から「選択項目をリセットして再スキャン」を実行すれば、未署名のインディープラグインであっても問題なく正規に認証・ロードされます。

4. 今後の展望

今回のmacOS AU対応により、Windowsの主要DAWユーザーだけでなく、Mac上のLogic ProやGarageBandユーザーに対してもLo-bitの音響DSP体験を直接届けられる環境が整いました。

個人開発のDSPプラグインであっても、妥協のないアーキテクチャ設計とテストを積み重ねることで、業界標準の商業ツールと肩を並べる安定性を実現できるという確信を得ています。