技術の力でより多くのゲーマー達へタイトルを届ける! RE ENGINEのマルチプラットフォーム展開 [RE:2026 2026年10月2日登壇]

152 Views

November 20, 26

スライド概要

2026年10月にカプコンが開催した「CAPCOM オープンカンファレンス RE:2026」の講演資料です。

■ 講演映像
https://www.youtube.com/watch?v=TmWvaSmCk5I&list=PLD_N6X6tKlCM

profile-image

株式会社カプコンが誇るゲームエンジン「RE ENGINE」を開発している技術研究統括によるカプコン公式アカウントです。 これまでの技術カンファレンスなどで行った講演資料を公開しています。 【CAPCOM オープンカンファレンス RE:2026】  https://www.capcom-games.com/coc2026/ 【CAPCOM オープンカンファレンス プロフェッショナル RE:2023】  https://www.capcom-games.com/coc/2023/ 【CAPCOM オープンカンファレンス RE:2022】  https://www.capcom.co.jp/RE2022/ 【CAPCOM オープンカンファレンス RE:2019】  http://www.capcom.co.jp/RE2019/

シェア

またはPlayer版

埋め込む »CMSなどでJSが使えない場合

(ダウンロード不可)

関連スライド

各ページのテキスト
1.

技術の⼒でより多くのゲーマー達へ タイトルを届ける︕ RE ENGINEの マルチプラットフォーム展開 加賀 雅⼤ ⽊本 雅博

2.

技術の⼒でより多くのゲーマー達へ タイトルを届ける︕ RE ENGINEの マルチプラットフォーム展開 加賀 雅⼤ ⽊本 雅博 技術の⼒でより多くのゲーマー達へタイトルを届ける︕RE ENGINEのマルチプラットフォーム展開 について発表を始めます。 よろしくお願いいたします。 1

3.

開発サポート RE ENGINEの開発⽤ツール プラットフォームサポート RE ENGINEのプラットフォーム移植 RE ENGINEのプロセス間通信 移植の概要 C# Debugger Mac/iOSでの移植事例 RE:Profiler Studioの対応 RemoteView Device Farm 2 こちらが本講演のアジェンダとなります。 はじめに、私、加賀からRE ENGINEの開発ツールについて解説します。 RE ENGINEが⾏っているプロセス間通信について説明し、続いて開発ツールである独⾃のC# DebuggerやRE:Profilerについてお話しします。 また、プラットフォーム開発で活⽤されているRemoteViewやDevice Farmについても解説します。 続いて、⽊本からRE ENGINEのプラットフォーム移植について解説します。 全プラットフォームを通しての移植の概要についてお話した後、具体例としてMac/iOS向けに移植した際のお話をします。 最後に、RE ENGINEのエディタにあたるStudio側のプラットフォーム移植対応について触れます。 2

4.

3 では、RE ENGINEの開発⽤ツールについて解説を⾏います。 3

5.

RE ENGINEの開発⽤ツール 4 はじめにRE ENGINEが⾏っているプロセス間通信について解説していきます。 4

6.

RE ENGINEの開発⽤ツール | RE ENGINEのプロセス間通信 サポート済みプラットフォーム 5 RE ENGINEではWindowsをはじめ、コンソール機やモバイル端末にも対応しており、それぞれのプラットフォームでゲームシーンの編集を⾏うことが可能です。 ゲームシーンを編集するにあたりRE ENGINEが⾏っているのがプロセス間通信です。 5

7.

RE ENGINEの開発⽤ツール | RE ENGINEのプロセス間通信 StudioとRuntime RE ENGINEでは、StudioとRuntimeにプロセスが分けられており、 それぞれ明確な役割があります。 Studio アセットの編集やプロパティの編集 Runtime ゲームとして動作 作業PC 開発プラットフォーム Studio Runtime 6 RE ENGINEは、アセットやプロパティを編集するStudioと、ゲームを実⾏するRuntimeの2つのプロセスで構成されています。 StudioとRuntimeはそれぞれ明確な役割を担っており、 Studioは作業PC上で動作し、Runtimeは開発プラットフォーム上で動作します。 6

8.

RE ENGINEの開発⽤ツール | RE ENGINEのプロセス間通信 RE ENGINEが⾏うプロセス間通信 StudioとRuntimeは、TCP/IP通信を⾏い同期しながら編集作業が⾏われます。 Studio アセットの編集やプロパティの編集 Runtime プロパティの同期 作業PC 開発プラットフォーム プロパティの編集など Runtime Studio 編集結果など 7 StudioとRuntimeはTCP/IPで情報のやりとりを⾏っており、 Studioでプロパティの編集を⾏うとRuntime側に送信され、編集結果をStudio側へ返送します。 このように、StudioとRuntimeはTCP/IP通信を⾏い同期しながら編集作業が⾏われます。 7

9.

RE ENGINEの開発⽤ツール | RE ENGINEのプロセス間通信 RE ENGINEが⾏うプロセス間通信 Runtimeは様々なプラットフォームで動作することができ、 Studioと通信を⾏うことができれば、どのプラットフォームでもシーンの編集が可能になります。 Windows Runtime 作業PC Nintendo Switch 2 Runtime Studio Android Runtime 8 Runtimeは様々なプラットフォームで動作することができ、Windowsはもちろん、コンソールやモバイルでも動作することができます。 Studioと通信さえできれば、どのプラットフォームでもゲームシーンの編集が可能になります。 8

10.

RE ENGINEの開発⽤ツール | RE ENGINEのプロセス間通信 【CAPCOM RE:2019】 複数のAAAタイトル開発に耐える汎⽤ゲームエンジンの設計と運⽤ RE ENGINEの 設計と運⽤については、 YouTubeで公開中 9 RE ENGINEの設計と運⽤については、 RE:2019「複数のAAAタイトル開発に耐える汎⽤ゲームエンジンの設計と運⽤」 https://www.youtube.com/watch?v=fc3avwM-oTE でも詳細に発表されていますので、興味のある⽅は是⾮ご覧ください。 9

11.

RE ENGINEの開発⽤ツール | RE ENGINEのプロセス間通信 RE ENGINEを構成するツール群 Studio以外にもRE ENGINEが⽤意しているツールが存在します。 ViaDebugger C# Scriptのデバッガー RE:Profiler パッケージにも接続可能なデバッグツール 作業PC 開発プラットフォーム Studio ViaDebugger Runtime RE:Profiler 10 Studio以外にもRE ENGINEには様々なツールが存在しています。 今回紹介するのはViaDebuggerとRE:Profilerです。 ViaDebuggerはRE ENGINE上で記載されたC#をデバッグするために、 RE:Profilerはパッケージに接続し、ゲームの設定やパフォーマンスを確認するために、 Runtimeと通信を⾏い、情報のやりとりを⾏っています。 今回はRE ENGINEを構成する開発ツールが、どのようにハードを問わず使⽤でき、環境の違いを意識することなく利⽤できるようにしている仕組みを解説します。 10

12.

RE ENGINEの開発⽤ツール 11 まずはC# Debuggerについて解説していきます。 11

13.

RE ENGINEの開発⽤ツール | C# Debugger RE ENGINEの使⽤⾔語 RuntimeはC++で記述され、kernel, coreをはじめ、 RenderやMotionなど機能単位のモジュールによって構成されています。 Runtime Render Virtual Machine Motion Physics ・・・ core kernel 12 RE ENGINEのruntimeはC++で記述され、 kernelやcoreをはじめRenderやMotionなどの 機能単位のモジュールによって構成されています。 12

14.

RE ENGINEの開発⽤ツール | C# Debugger REVMの概要 タイトル側のゲームロジックはアセットの形式でC#で記述され、 C# Scriptは内製のVirtual Machine(REVM)上で動作しています。 Runtime Render Virtual Machine Motion Physics ・・・ core kernel 13 タイトル側のコードはC#で記述され、C# Scriptはcore層にある内製Virtual Machine(REVM)上で動作しています。 タイトル固有のC++コードは禁⽌されており、C++でのクラッシュはRE ENGINEの問題、C#の例外はタイトル側の問題として切り分けて考える事ができます。 ゲームロジックがC#で記述され内製のVirtual MachineであるREVMで動作している以上、C# Debuggerも内製しなければいけません。 13

15.

RE ENGINEの開発⽤ツール | C# Debugger REVMの概要 ViaDebuggerはCore上で動作しているREVMと情報のやり取りを⾏うアプリケーションです。 ・ブレイクポイントの設定 ・例外の取得 Runtime ・ステップイン, ステップアウト ・システムの変更 Render Virtual Machine Motion Physics ・・・ core kernel 14 そこで、RE ENGINE開発初期に⽤意されたのが、ViaDebuggerというアプリケーションです。 ViaDebuggerはRuntimeで動作しているREVMと通信を⾏うことで、ブレイクポイントの設定や例外の取得、ステップイン、ステップアウトといった ⼀般的なデバッグ機能から、レンダリングの設定などシステムの値を参照、編集することもできるデバッグツールです。 14

16.

RE ENGINEの開発⽤ツール | C# Debugger ViaDebuggerの課題 ・ViaDebuggerではコードの編集を⾏うことはできない ・Visual Studio と ViaDebuggerを往復して作業する必要がある Microsoft Visual Studio コードの編集 デバッグ 15 しかし、このViaDebuggerには課題がありました。 ViaDebuggerはデバッグツールであり、コードエディタではありませんでしたので、コードの編集までは⾏うことができません。 コードの編集はVisual Studio、デバッグはViaDebuggerとツールを往復する必要がありました。 15

17.

RE ENGINEの開発⽤ツール | C# Debugger ViaDebuggerVSI と ViaDebuggerVSCode RE ENGINE開発チームが提供する Visual Studio 拡張機能 と Visual Studio Code 拡張機能です。 利⽤できる機能 ブレイクポイントの設定 例外の取得 ステップイン ステップアウト 16 そこで現在多くのエンジンユーザーが利⽤しているのはViaDebuggerVSIやViaDebuggerVSCodeになります。 こちらは今までViaDebuggerで⾏っていた機能をVisual StudioとVisual Studio Codeの拡張機能として実装したものです。 ViaDebuggerと同じく、ブレイクポイントの設定やステップイン, ステップアウトを、普段使⽤するVisual Studioから利⽤することが可能になりました。 16

18.

ViaDebuggerVSIのデバッグ 17 それではPlayStation 5で起動しているRuntimeに対して、ViaDebuggerVSIを利⽤してデバッグする動画をお⾒せします。 ※ 映像についてはDocswell「スライド概要」へ記載のYouTube講演映像からご確認ください。 RE ENGINEでは、Studioの画⾯中央にあるViewから、PlayStation 5で表⽰されている画⾯を確認することが可能です。 Visual Studioの拡張機能からデバッグを開始することで、ブレイクポイントの設定、ステップオーバーやステップインといった基本的な機能を利⽤することができます。 今回はゲーム全体の速度を管理するGlobalSpeedというプロパティを3.0に上げることでゲームの速度を3倍にしたいと思います。 変更前は通常の速度で移動しています。 しばらく待つと、C#のビルドが終わりホットパッチが⾛ることにより、ゲームの続きからプログラムの確認を⾏うことができます。 GlobalSpeedが3.0になり、世界の速度が3倍になっていることが確認できます。 また、そのままVisual Studioに戻り、デバッグを開始することもできます。 17

19.

RE ENGINEの開発⽤ツール | C# Debugger 各Debuggerの構成 共通層を⽤意することにより様々なツールをサポートしています。 ViaDebugger ViaDebuggerVSI ViaDebuggerVSCode Visual Studio Visual Studio Code Windows Forms ViaDebugAdapter DebuggerLib Proxy 18 では、ここから今まで紹介してきたC# Debuggerの内部処理を解説していきます。 各DebuggerはProxy, DebuggerLib, ViaDebugAdapterのようにいくつかの共通層を⽤意することで様々なツールをサポートしています。 まずはViaDebugAdapterから順番に解説をしていきます。 18

20.

RE ENGINEの開発⽤ツール | C# Debugger ViaDebugAdapterの全体像 ViaDebugAdapterは単⼀の実⾏ファイルとして存在しており 拡張機能から起動されます。 ViaDebuggerVSI (Visual Studio拡張機能) ViaDebugAdapter 19 ViaDebugAdapterは単⼀の実⾏ファイルとして存在しており、拡張機能から起動されます。 19

21.

RE ENGINEの開発⽤ツール | C# Debugger ViaDebugAdapterの全体像 Runtimeとの通信を⾏ったり、それぞれのIDEへ情報を伝えるなど 中継役として機能しています。 PC Runtime ViaDebuggerVSI (Visual Studio拡張機能) プラットフォームA Runtime Visual Studio 2017 Visual Studio 2019 ViaDebugAdapter Visual Studio 2022 プラットフォームB Runtime Visual Studio Code 20 起動されたViaDebugAdapterは Runtimeとの通信を⾏ったり、それぞれのIDEへ情報を伝えるなど中継役として機能しています。 Visual Studioからブレイクポイントの設定を⾏えば、ViaDebugAdapterがRuntimeで動作しているREVMへ通知を⾏い、 REVMでブレイクが発⽣すれば、Visual Studioに情報を通知します。 20

22.

RE ENGINEの開発⽤ツール | C# Debugger Debug Adapter Protocol(DAP) • IDEとデバッガ間の通信を標準化するためのプロトコル • Debug Adapter Protocolに対応したIDEは同じAdapterを利⽤することで、 同じデバッグ操作をユーザに提供 • DAPに則ったViaDebugAdapterを作成することで様々なIDEに対応 ViaDebuggerVSI (Visual Studio拡張機能) DAPによる通信 Visual Studio 2017 Visual Studio 2019 ViaDebugAdapter Visual Studio 2022 Visual Studio Code 21 Debug Adapter Protocol、通称DAPについて解説します。 DAPとはIDEとデバッガ間の通信を標準化するためのプロトコルです。Microsoft社が開発し、異なるIDEや⾔語環境で⼀貫したデバッグ操作を可能にしました。 DAPに対応したIDEは同じAdapterを利⽤することで、同じデバッグ操作をユーザに提供することができます。 DAPにのっとったViaDebugAdapterを作成することで様々なIDEに対応しています。 21

23.

RE ENGINEの開発⽤ツール | C# Debugger Microsoft.VisualStudio.Shared.VSCodeDebugProtocol • VSCodeDebugProtocolはDAPをC#で扱うためのライブラリ • ViaDebugAdapterではNuGetで利⽤することによりDAP通信を⾏う DAPによる通信 ViaDebugAdapter Visual Studio 2017 Visual Studio 2019 VSCodeDebugProtocol Visual Studio 2022 Visual Studio Code 22 私達はDAPを⽤いてIDEと通信を⾏うために、VSCodeDebugProtocolというOSSを利⽤しています。 VSCodeDebugProtocolはDAPをC#から利⽤するためのライブラリであり、ViaDebugAdapterではNuGetで参照することでDAP通信を実現しています。 22

24.

RE ENGINEの開発⽤ツール | C# Debugger DebuggerLib • REVMとの通信⽅法や通信内容が記述された内製ライブラリ • DebuggerLibがRuntimeと通信を⾏いブレイクポイントの設定を⾏う PC TCP/IPによる通信 Runtime プラットフォームA Runtime ViaDebugAdapter DebuggerLib プラットフォームB Runtime 23 次にDebuggerLibについて解説していきます。 DebuggerLibとはREVMとの通信について記述された内製ライブラリです。 開発ツールとREVMの間に位置する通信レイヤーとして機能します。 具体的には、開発者がデバッグツール上で設定したブレイクポイントやステップ実⾏などのデバッグ命令を、適切なプロトコル形式に変換してREVMに送信します。 逆⽅向の通信として、REVM側で発⽣したブレイクポイントのヒット、例外の発⽣、実⾏の⼀時停⽌などのイベントをリアルタイムで受信し、 デバッグツール側に通知する役割も担っています。 これにより、Visual StudioなどのIDEからREVM上で動作するスクリプトやゲームロジックをシームレスにデバッグできる環境が実現されています。 23

25.

RE ENGINEの開発⽤ツール | C# Debugger Proxy • 特定のプラットフォームではTCP/IP以外の通信が必要なケースが存在する • ViaDebugAdapterとRuntimeの間にProxyを挟み、透過的に通信を⾏えるように PC TCP/IPによる通信 Runtime プラットフォームA Runtime 固有プロトコル Proxy ViaDebugAdapter DebuggerLib プラットフォームB Runtime Proxy 24 最後にProxyについてです。 特定のプラットフォームではTCP/IP以外の通信が必要なこともあります。 ProxyとViaDebugAdapter間をTCP/IPで、 ProxyとRuntime間を固有のプロトコルで通信しています。 ProxyはViaDebugAdapterとRuntimeとの中継役となることで、TCP/IPとプラットフォーム固有のプロトコルを変換し、透過的な通信を⾏えるようにしています。 Proxyを⽤意することにより、各プラットフォーム担当者は開発ツールを編集する必要がなくなり、新しいプラットフォームへ素早く対応することができます。 24

26.

RE ENGINEの開発⽤ツール | C# Debugger ViaDebugAdapterの全体像 Proxy, DebuggerLib, DAPのように使いまわし可能な共通層を多数⽤意することで 様々なツール, 様々なプラットフォームに対応することを可能にしています。 PC TCP/IPによる通信 Runtime プラットフォームA Runtime DAPによる通信 固有プロトコル Proxy DebuggerLib VSCodeDebugProtocol プラットフォームB Runtime ViaDebugAdapter Proxy Visual Studio 2017 Visual Studio 2019 Visual Studio 2022 Visual Studio Code 25 ViaDebugAdapterの全体像です。 ViaDebugAdapterは主にDebuggerLibとVSCodeDebugProtocolから作られており、DebuggerLibがRuntimeとの通信を受け持ちます。 各IDEとの通信はVSCodeDebugProtocolを利⽤したDAP通信により汎⽤化されています。 Proxy, DebuggerLib, DAPのように使いまわし可能な共通層を多数⽤意することで、様々なツール、様々なプラットフォームに対応することを可能にしています。 25

27.

RE ENGINEの開発⽤ツール | C# Debugger 各Debuggerの構成 ・Visual StudioとVisual Studio CodeではViaDebugAdapterによる共通化を⾏い、 ViaDebuggerではDebuggerLibのみ参照することで開発を⾏っています。 ・ライセンス不要でエンジンに付属しているViaDebuggerを⽤意しておくことで、 アーティスト席でも気軽にデバッグを⾏うことが可能になります。 ViaDebugger ViaDebuggerVSI ViaDebuggerVSCode Visual Studio Visual Studio Code Windows Forms ViaDebugAdapter DebuggerLib Proxy 26 Visual StudioとVisual Studio Codeの拡張ではViaDebugAdapterを利⽤した共通化を⾏い、 単体のアプリケーションであるViaDebuggerではREVMと通信を⾏うDebuggerLibのみ参照を⾏い開発しています。 Visual StudioとVisual Studio Codeの拡張が存在するのに、 ViaDebuggerというWindows Formsのアプリケーションが存在している理由は、 プログラマの開発環境が導⼊されていない機材や、アーティスト席, デザイナー席でも⼿軽に確認できる需要があるためです。 このように多くの環境で動作できるように開発ツールの作成を⼼がけています。 26

28.

RE ENGINEの開発⽤ツール 27 次にRE:Profilerを解説していきます。 27

29.

RE ENGINEの開発⽤ツール | RE:Profiler RE:Profiler RE:ProfilerはStudioやViaDebuggerに存在していた機能を統合し、 パッケージにも接続可能にした内製プロファイラです。 ・C#スクリプトプロファイル ・メモリプロファイル ・システムの変更 ・デバッグコマンドの実⾏ ・各モジュールが⽤意する内製プロファイル など10種類以上の計測機能と デバッグ機能が存在します 28 RE:ProfilerはStudioに存在していたプロファイル機能やViaDebuggerに存在していたシステムの編集機能を統合し、 パッケージにも接続可能にした内製プロファイラです。 C#スクリプトのプロファイルや、メモリプロファイルなど、10種類以上の計測機能とデバッグ機能を搭載しています。 28

30.

RE:ProfilerによるCPUキャプチャ 29 動画でお⾒せします。 ※ 映像についてはDocswell「スライド概要」へ記載のYouTube講演映像からご確認ください。 StudioからAndroidを起動させ、RE:Profilerを接続しスクリプトプロファイルを実⾏しています。 フレームのどのタイミングでどの処理が⾛っているのか、グラフィカルに確認することができ、パフォーマンス改善の助けになっています。 このようにモバイルに対してもRE:Profilerは接続を⾏うことができ、 開発初期に発⽣する処理落ちについて⼿軽に確認できる機能としてタイトルサポートに役⽴っています。 29

31.

RE:Profilerによるメモリキャプチャ 30 次はStudioからNintendo Switch 2を起動させ、メモリキャプチャを⾏う動画です。 ※ 映像についてはDocswell「スライド概要」へ記載のYouTube講演映像からご確認ください。 PS5と同様、Studioの中央にあるViewからNintendo Switch 2の画⾯を確認することができます。 RE:Profilerを接続することでメモリキャプチャを⾏うことができ、メモリがどのくらい、どこから確保されているのか確認することが可能です。 キャプチャ同⼠の⽐較も⾏うことができ、解放されていないメモリの特定や、徐々に増加していくメモリ使⽤量も分析することができます。 30

32.

RE ENGINEの開発⽤ツール | RE:Profiler RE:Profilerの構成 RE:ProfilerでもC# Debuggerと同じProxyを使いまわすことにより、 RE ENGINEがサポートする全てのプラットフォームに対して接続することが可能です。 debugger.exe ViaDebuggerVSI ViaDebuggerVSCode RE:Profiler Visual Studio Visual Studio Code RE:UI Windows Forms ViaDebugAdapter 内製Profiler DebuggerLib Proxy 31 RE:Profilerを構成する要素を紹介します。 RE:ProfilerにおいてもC# Debuggerで利⽤していたProxyを流⽤することにより多数のプラットフォームに接続することを可能にしています。 31

33.

RE ENGINEの開発⽤ツール | RE:Profiler RE:Profilerの構成 RE:ProfilerのGUIは全てRE:UIで構築されており、 ⼤量のデータを⾼速かつ少ないメモリでUIに表⽰させています。 debugger.exe ViaDebuggerVSI ViaDebuggerVSCode RE:Profiler Visual Studio Visual Studio Code RE:UI Windows Forms ViaDebugAdapter 内製Profiler DebuggerLib Proxy 32 また、UIフレームワークとして内製のRE:UIを利⽤しており、⼤量のデータを⾼速かつ少ないメモリでUIに表⽰させることを実現しています 32

34.

RE ENGINEの開発⽤ツール | RE:Profiler 【CAPCOM オープンカンファレンス RE:2026】 ツール開発のパラダイムシフト︕内製UIフレームワーク「RE:UI」の思想と実装 ▼ Check! 33 詳細については、 RE:2026 ツール開発のパラダイムシフト︕内製UIフレームワーク「RE:UI」の思想と実装 において詳しく解説されています。 33

35.

RE ENGINEの開発⽤ツール 34 次にRemoteViewの解説をしていきます。 34

36.

RE ENGINEの開発⽤ツール | RemoteView RemoteView Studioの中央にあるViewから遠隔にある機材の画⾯を⾒ることのできる機能です。 Windows, Macに関しては独⾃に実装しています。 35 RemoteViewはStudioの中央にあるViewから、遠隔にある機材の画⾯をネットワーク越しに確認できる機能です。 今までの動画でも触れましたがPlayStation 5やNintendo Switch 2はもちろん遠隔にあるWindowsやMacにも対応しています。 今回は内製で⼀から開発しているWindows向けのRemoteViewについて解説していきます。 35

37.

RE ENGINEの開発⽤ツール | RemoteView RuntimeRelay リモートのWindows, Macで動作し、 画⾯やキーボード・マウス・ゲームパッド⼊⼒を 共有するための内製アプリケーションです。 実装のモチベーション  別PCで起動したruntimeを操作したい  リモート画⾯のキャプチャから表⽰までの遅延を最⼩化したい  リモートデスクトップで回避が難しい問題への対処 ・ゲーム内の解像度の判定にも影響を与えてしまう ・実⾏速度が制限される 36 WindowsでRemoteViewを実現するために実装したのがRuntimeRelayです。 RuntimeRelayはリモートのWindowsやMacで動作し、画⾯やキーボード・マウス・ゲームパッド⼊⼒を共有するためのアプリケーションです。 実装のモチベーションとして、 別PCで起動したruntimeを操作したい。 リモート画⾯のキャプチャから表⽰までの遅延を最⼩化したい。 また、別のPCを操作できる⼿段としてリモートデスクトップが存在しますが、リモートデスクトップでは回避が難しい問題。 具体的には、リモートデスクトップを利⽤するとゲーム内から取得されるモニターの設定が変更されてしまい、ゲーム内解像度の判定に影響を与えてしまったり、 実⾏速度が制限されたりする問題があります。 これらを解消したいというものもありました。 36

38.

RE ENGINEの開発⽤ツール | RemoteView RuntimeRelayの構成図 RuntimeRelayは2つのアプリケーションから構成されています。 RuntimeRelay.Client 画⾯のデコード・⼊⼒の送信 RuntimeRelay.Server 画⾯のエンコード・⼊⼒の受信 リモート機材 作業PC ⼊⼒ RuntimeRelay.Server RuntimeRelay.Client エンコード内容 37 RuntimeRelayには2つのアプリケーションが存在しています。 作業PCで動作するClientと、リモートで動作するServerです。 RuntimeRelay.Clientは、キーボードやマウスの情報を取得し、送信します。 RuntimeRelay.Serverは⼊⼒を適⽤するのと同時に、画⾯のエンコードを⾏いクライアントに送信します。 もう少し詳しく解説します。 37

39.

RE ENGINEの開発⽤ツール | RemoteView RuntimeRelay.Serverの映像パイプライン (Server → Client) 1 Windows Graphics Capture(WGC)を使⽤した画⾯の取得 2 コンピュートシェーダーでBGRA から I420に変換 3 libvpxを利⽤したVP9エンコード 4 エンコード済みデータをTCPでClientへ送信 5 Client側でデコード・表⽰ 38 RuntimeRelay.ServerのWindowsにおける映像パイプラインです。 はじめにWindows Graphics Captureを使⽤した画⾯の取得が⾏われます。 次にコンピュートシェーダーでBGRAからI420に変換し、libvpxを⽤いたVP9エンコードが⾏われます。 VP9に変換された画⾯はクライアント側へ送信され、デコードされ表⽰されることになります。 さらに、 Server側で⾏っている、WGCからのテクスチャのバッファ取得・エンコード・送信、 Client側で⾏っている、デコード・表⽰を全て⾮同期にパイプライン化を⾏うことで低遅延を実現しています。 38

40.

RE ENGINEの開発⽤ツール | RemoteView RuntimeRelay.Serverの⾳声・⼊⼒処理 RuntimeRelayの構成図 ⾳声(Server→Client) ゲームパッド⼊⼒(Client→Server) ・Client側でXInput / DualSenseの状態を 読み取り送信 ・ Windows Audio Session API(WASAPI) でターゲットアプリの⾳声をキャプチャ ・Server側でViGEmBus経由で 仮想 XBOX 360 コントローラとして注⼊ ・ PCM16に変換してTCPで送信 ・キーボード, マウス⼊⼒は SendInput APIを利⽤して注⼊ 39 ⾳声とゲームパッド⼊⼒にも対応しています。 ゲームパッド⼊⼒では、クライアント側でXInput / DualSenseの状態を読み取り、 サーバー側でViGEmBus経由で仮想 XBOX 360 コントローラとして注⼊されます。 キーボード・マウス⼊⼒はSendInputを利⽤して注⼊されます。 ⾳声は、Windows Audio Session APIで⾳声を取得し、PCM16に変換し、TCPで送信されます。 このように映像、⾳声、⼊⼒をやり取りすることにより、Studio上で作業を完結でき、 異なるプラットフォーム間でも同じ操作感で、新規開発から不具合の調査まで⾏えるように対応しています。 39

41.

RE ENGINEの開発⽤ツール 40 RE ENGINEでマルチプラットフォーム開発のイテレーションを⾼めるツールとしてDevice Farmも存在します。 40

42.

RE ENGINEの開発⽤ツール | Device Farm Device Farm 共有で使⽤できる機材を⼀覧表⽰し、 好きなタイミングで利⽤可能にするツールです。 遠隔からのパッケージ確認、Studioでの動作確認、 RE:Profilerの接続が⾏えるようになります。 41 Device Farmは共有で使⽤できる機材を⼀覧表⽰し、好きなタイミングで利⽤可能にするツールです。 確保された機材に対して、遠隔からのパッケージの動作確認、Studioでの動作確認、RE:Profilerによる接続や解析が⾏えるようになります。 現在は、PlayStation 4/5, XBOX, Nintendo Switch/Switch 2向けに機能を提供しています。 41

43.

RE ENGINEの開発⽤ツール | Device Farm Device Farmによるイテレーションの向上 Device Farmが存在することにより、 機材の確保から、動作確認、機材の解放まで、⾃席から⼀歩も動くことなく完結します。 Device Farmで機材の確保 Studioで動作確認 Device Farmで機材の解放 ViaDebuggerVSIによるデバッグ RE:Profilerによるプロファイリング 42 Device Farmが存在することにより、機材の確保を⾏い、 ・RemoteViewを利⽤してStudioで動作確認をしたり ・ViaDebuggerVSIによりデバッグを⾏ったり ・RE:Profilerによるプロファイリング を⾏います。 使い終われば、Device Farm上で機材の解放を⾏えます。 これまで紹介した機能を組み合わせることにより⾃席から⼀歩も動くことなく開発を⾏える仕組みづくりをしています。 42

44.

RE ENGINEの開発⽤ツール | Device Farm まとめ 流⽤可能な共通層を多数⽤意することで、 異なるプラットフォーム, 異なるツールでも同じ操作を実現しています。 RemoteView, RE:Profilerを利⽤することで⾃席にいながら 遠隔のゲームをデバッグできる仕組みづくりを⾏っています。 Device Farmを利⽤することで、1⼈1台開発機を持つ必要がなくなり 効率よく機材を活⽤することが可能になりました。 43 まとめです。 流⽤可能な共通層を多数⽤意することで、 異なるプラットフォームや異なるツールでも同じ操作を実現しています。 RemoteView, RE:Profilerを利⽤することで⾃席にいながら遠隔のゲームをデバッグできる仕組みづくりを⾏っています。 さらに、Device Farmを利⽤することで、1⼈1台開発機を持つ必要がなくなり効率よく機材を活⽤することが可能になりました。 43

45.

ここからは、RE ENGINEのプラットフォーム移植について、⽊本から話をさせていただきます。 44

46.

RE ENGINEのプラットフォーム移植 45 まずは、RE ENGINEを各プラットフォームに移植する際の流れについてお話します。 45

47.

RE ENGINEのプラットフォーム移植 | 移植の概要 RE ENGINEの開発時の実⾏フロー 1 StudioからRuntimeを プラットフォームに転送する 2 RuntimeからStudioに ファイルを要求する 3 Studioから ファイルを転送する 4 ファイルに従い ゲームを実⾏する Studio Runtime Platform A File A File B Platform B Platform C 46 移植の話に⼊る前に、RE ENGINEでは普段、どのように各プラットフォーム向けの開発を⾏っているかを軽く説明します。 RE ENGINEでは、Studioと呼ばれるエディターから、実⾏可能ファイルであるruntimeを各プラットフォームに転送します。 46

48.

RE ENGINEのプラットフォーム移植 | 移植の概要 RE ENGINEの開発時の実⾏フロー 1 StudioからRuntimeを プラットフォームに転送する 2 RuntimeからStudioに ファイルを要求する 3 Studioから ファイルを転送する 4 ファイルに従い ゲームを実⾏する Studio Runtime File A File B Runtime Runtime Runtime Platform A Platform B Platform C 47 プラットフォーム上で実⾏を開始したruntimeは、Studioに対し実⾏に必要なファイルを要求します。 Studioは、要求に従ってファイルを転送します。 47

49.

RE ENGINEのプラットフォーム移植 | 移植の概要 RE ENGINEの開発時の実⾏フロー 1 StudioからRuntimeを プラットフォームに転送する 2 RuntimeからStudioに ファイルを要求する 3 Studioから ファイルを転送する 4 ファイルに従い ゲームを実⾏する Studio Runtime Runtime File A Platform A File A Runtime File B Platform B File B Runtime Platform C 48 ファイルを受け取ったruntimeは、ファイルを読み込みながらゲームを実⾏します。 48

50.

RE ENGINEのプラットフォーム移植 | 移植の概要 RE ENGINE runtimeのモジュラー構造 kernel 基礎機能とプラットフォーム依存吸収を担当 Runtime core ゲームループやStudioとの通信、 C#向け機能などを担当 プラットフォーム依存モジュール render, hid(human interface device), network, sound, save GUI, Effect Render Studio プラットフォーム⾮依存モジュール gui, effect, physicsなど core kernel Platform 49 さて、RE ENGINEの実⾏環境であるruntimeは、モジュラー構造になっている、というお話は過去にもしているのですが、 このモジュールがどういうものかについては触れてこなかったので、軽く説明させていただきます。 まず、コンテナや数学などの基礎機能とプラットフォームへの依存を吸収するkernelモジュールがあります。 その上に、ゲームループやStudioとの通信などを担い、C#層への機能提供も⾏うcoreモジュールがあり、 その上にプラットフォームに依存せざるを得ないモジュールがあります。 例えば、renderは各プラットフォームが⽤意している描画APIを実⾏する必要があるため、図のように⼀部直接プラットフォームに触れる部分があります。 もちろん、この部分は最⼩になるようにしています。 他にも、ゲームパッドなどのhuman interface deviceやnetwork、soundがあります。 ゲーム開発者であればご存知かと思いますが、saveなんかもプラットフォーム別に⽤意されている機能を使います。 ⼀⽅で、guiやeffect、physicsなどはプラットフォーム⾮依存でrenderなどの上に構築されています。 49

51.

RE ENGINEのプラットフォーム移植 | 移植の概要 RE ENGINEの移植フロー 1 kernelの移植とビルド環境の整備 2 Studioからの起動とファイル転送の整備 3 render、hidの移植 4 coreのプラットフォーム固有機能 (C#から利⽤)やその他のモジュールの移植 2までの時点でゲームループが実⾏可能になる ため、簡易的なベンチマークを始められる render、hidの移植と並⾏して、 ファイルI/Oやメモリ、スレッドの特徴を掴む 時間を作れる 3までの時点で、ほとんどの機能は そのまま動く状態になっており、 タイトルの移植作業が始められる 50 RE ENGINEに新しいプラットフォームを移植する場合、次のようなフローで移植を⾏います。 まず、kernelの移植を通して、ビルド環境の整備を⾏いながら、プラットフォーム依存を吸収するための実装を⾏います。 続いて、Studioからruntimeを転送して起動し、ファイルを転送する部分を整備します。 ここが動作するようになった時点で、ゲームループが回っているため、簡易的なベンチマークを始められます。 この次のrenderやhidの移植と並⾏して、ファイルI/Oやメモリの速度、スレッドスケジューリングの特徴などを掴むことができます。 その後、renderとhidの移植が完了すると、ほとんどの機能は動くようになっているため、タイトルの移植作業が開始できます。 最後に、coreにC#からプラットフォーム固有機能を使うためのインターフェースや、その他のモジュールの移植をすると完了します。 といっても、プラットフォーム依存の機能があるモジュールは少ないため、3までの時点でほぼ移植は完了しています。 本⽇は、この移植フローのうち、kernelとStudioとのやりとりの部分までについて詳しくお話します。 50

52.

RE ENGINEのプラットフォーム移植 51 まずは、kernelの移植についてです。 51

53.

RE ENGINEのプラットフォーム移植 | kernelの移植 kernelの機能 C++標準ライブラリーのラッパー提供 プラットフォームで未実装のものは実装して提供 全体で使うアルゴリズムやコンテナの提供 lock free queue、flat map、flat setなど プラットフォーム依存の吸収 File、Thread、Lock、Socketなど 52 kernelには、次のような機能を持たせています。 全プラットフォームで利⽤できるC++標準ライブラリーのラッパーを提供しています。 ⼀部プラットフォームでは、コンパイラーのバージョンの違いなどで実装が提供されていない機能などがあるので、その場合は実装して提供するようにしています。 また、全体で使うアルゴリズムやコンテナを提供するのもkernelの仕事です。 通常のコンテナ以外に、lock free queueや、C++23で追加されるflat mapやflat setなどを先取りしての提供をしたりしています。 そして、移植の上で⼀番重要なポイントとなる、プラットフォーム依存の吸収部分について、次のページから詳しく説明します。 52

54.

RE ENGINEのプラットフォーム移植 | kernelの移植 移植が⽐較的容易な機能 CPUアーキテクチャー依存の機能 現在のターゲットアーキテクチャーはx86-64またはAArch64のみ SIMD(SSE/AVX/NEONなど)は⼀度実装すれば使いまわせる コンパイラー組み込み機能を利⽤したもの 現在利⽤しているコンパイラーはCLまたはClangのみ (バージョンには注意が必要) type_traitsなどで活⽤されている アロケーター システムからメモリーを取得する部分だけ移植が必要 53 まず、移植が⽐較的容易な機能について触れます。 SIMDのようなCPUアーキテクチャーに依存した機能は、現在のRE ENGINEのターゲットアーキテクチャーがx86-64またはAArch64のみのため、 ⼀度実装すれば使いまわせます。 新しいプラットフォームが来た場合でも、どちらのアーキテクチャーか決めるだけで使えます。 次に、コンパイラーの組み込み機能を利⽤したものがあります。これは、type_traitsなどでも利⽤されているのですが、 これらは現在使っているコンパイラーがCLかClangのみのため、これも、これまでのプラットフォームよりも古いコンパイラーを使ったプラットフォームが出てきて、 コンパイラー組み込み機能がそもそも存在していないなんてことが起きない限り、基本的には⼿を⼊れずに移植できます。 また、アロケーターについては、基本的にはシステムからメモリーを取得する部分だけ実装すれば、その上で動くような実装になっているので、 移植が容易な機能となります。 53

55.

RE ENGINEのプラットフォーム移植 | kernelの移植 プラットフォームに依存した機能 ⽇時 プラットフォームによってUTCと ローカル時間のどちらがベースかでパフォーマンスが変化 Clock APIによって分解能が違うことがあるので、 移植の際に使うAPIの選定に注意が必要 Socket プラットフォームにより多少の違いはあれど、 ⼤枠は同じことが多い Thread Lock File 54 完全にプラットフォームに依存する機能としては、次のようなものがあります。 ⽇時についてはUTCとローカル時間、どちらがベースになるかが違うプラットフォームがあり、扱いを間違えるとパフォーマンスに影響するケースがありました。 クロックについては、複数の分解能を持ったAPIを提供されていることがあるので、移植の際にはその点を注意する必要がありました。 そして、Studioとの通信などで使うソケットの部分ですが、これはプラットフォームによって多少の違いがあるものの、基本的な仕組みは同じため、 移植にはさほど苦労することはありません。 問題になるのが、スレッド、ロック、ファイルの部分で、これについてはもう少し詳しくお話させていただきます。 54

56.

RE ENGINEのプラットフォーム移植 | kernelの移植 Thread 標準の範囲では難しい機能を追加で実装している 名前の指定 デバッグ時のヒントに プライオリティーの設定 プラットフォーム別にコアの性質に合わせ、 ⾼優先と低優先の数を調整している アフィニティーマスクの設定 特定のコアでスレッドが動作するようにして、 コンテキストスイッチによる負荷を減らしている WindowsやiOSのようにコア数が変わる環境では無視される 55 まず、スレッドについてはstd::threadだけでは難しい機能を実装しています。 スレッド名の設定はデバッグ時に必須の機能です。 また、プラットフォーム別にコアの性質や数に合わせて、⾼優先と低優先のスレッド数を調整しています。 他にも、Affinity Maskという、スレッドを実⾏するコアを固定して、コンテキストスイッチによる負荷を減らすようなこともしています。 ただし、WindowsやiOSのように同じプラットフォームでもコア数が固定できないプラットフォームについては、設定していません。 55

57.

RE ENGINEのプラットフォーム移植 | kernelの移植 ロック 開発初期にC++標準の範囲では不⼗分だったため、⼀通りが実装されている mutex, readers writer lock(C++17でshared_mutexとして追加), semaphore (C++20で追加), spin lock, condition variable プラットフォームによってはspin lockでシステムコールを減らし、 負荷を下げたロックを実装することも 独⾃実装なのでcondition variableが意図せず待機を抜ける Spurious wakeupの考慮漏れをしていることがあった 56 続いてロックについて説明します。 ロックは、並列処理を実装する上で必須の機能ですが、RE ENGINE開発初期にはC++標準の範囲に⼗分な機能が無かったため、⼀通り実装しています。 これに合わせるため、各プラットフォームでもそれらを実装することになります。 基本的なものとしては、mutex、readers writer lock、semaphore、spin lock、condition variableです。 意外なことに、readers writer lockはC++17でshared_mutexとしてようやく⼊り、semaphoreはC++20まで⼊らなかったんです。 プラットフォームによっては、実際のロックの前にspin lockをしてシステムコールを減らし、負荷の低いロックを実装することもありました。 なお、独⾃実装の関係でcondition variableが意図せず待機を抜けるSpurious wakeupの考慮漏れをしているケースがあったりしました。 56

58.

RE ENGINEのプラットフォーム移植 | kernelの移植 ファイル 開発時は直接ファイルにアクセスし、製品ではパッケージ⽤のデータ経由に切り替わる プラットフォーム別のFileクラスが実際のアクセスを担当 パスの変換 Application 共通のパスからプラットフォーム別のパスへ ・ファイルのオープンクローズ File ・同期読み込み ・⾮同期読み込み 書き込みは基本使わない File (Platform A) File (Platform B) パッケージ データ 57 最後に、ファイルについてお話します。 RE ENGINEでは、開発時はファイルに直接アクセスし、製品ではファイルをまとめたパッケージデータからファイルを読み取るようにしています。 インターフェースは全て同じで、その下にプラットフォーム別のFileクラスがあります。 ただ、このクラスが担っている機能もさほど多くはありません。 共通パスをプラットフォーム別のパスに変換する機能と、同期⾮同期の読み込み機能のみです。 RE ENGINEのruntimeは基本的にはリードオンリーにしており、書き込みはほぼ使いません。 57

59.

RE ENGINEのプラットフォーム移植 58 ここからは、実際にMac/iOSにRE ENGINEを移植した際の実例を交えながら、RE ENGINEのビルド環境を整備したお話をします。 58

60.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 移植開始時の状況 Mac/iOSへの移植 Xcodeのプロジェクトが必要 Game Porting Toolkitは無い Androidへの移植 Android Studioのプロジェクトが必要 Android Game Development Extensionも無い C++を使う場合はCMake必須 当時既にVisual Studioをベースとしたエコシステムが出来上がっていた Visual StudioとXcode/Android Studioのトリプルメンテナンスは避けたい しかしエンジン開発者全体のCMakeの学習コストは最低限にしたい 59 まずは、移植開始時の状況を述べます。 Mac/iOSの移植にはXcodeのプロジェクトが必要です。 CEDEC 2026でも話が出たのでご存知の⽅もいるかもしれませんが、 AppleはWindowsのゲームを移植評価するためのGame Porting Toolkitを提供していますが、移植を始めた当時は、Game Porting Toolkitもありませんでした。 また、ビルド環境の技術選定に影響を与えているので、Androidにも触れておくと、Androidの開発にはAndroid Studioのプロジェクトが必要です。 移植開始当時は、Visual StudioでAndroidビルドができるAndroid Game Development Extensionもありませんでした。 AndroidについてはC++を使う場合はCMakeでビルドする前提になっています。 しかし、当時Visual Studioをベースとしたエコシステムが出来上がっていました。 Visual StudioとXcode/Android Studioのトリプルメンテナンスは避けたいですよね。 ⼀⽅で、CMakeの学習コストは最低限にしたいものです。 59

61.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 CMakeからvcxprojを読み込む 必要なのはヘッダーとソースのリストだけだった vcxprojはXMLで、正規表現で容易に取り出し可能 RE ENGINEのプロジェクト設定はシンプル インクルードパスや各種マクロはルールベースで設定可能 モジュール別にどうしても追加が必要な場合のみ CMakeLists.txtに追記 最終的に⼀部のコードを除外するなど 条件判定などを含める場合は別の⽅法が必要 ほとんどのモジュールはこの1⾏のみに add_re_module(モジュール名) ソースコードとヘッダーからライブラリを⽣成 # 全部読み込む file(READ "${filename}.vcxproj" VCXPROJ) # ヘッダーやソースを取り出す string(REGEX MATCHALL "(ClCompile|ClInclude) Include=¥"([^¥"]+)¥"" VCXPROJ_SOURCE_ATTRIBUTES "${VCXPROJ}") # 実際のソースコード名を取り出す string(REGEX REPLACE "(ClCompile|ClInclude) Include=¥"([^¥"]+)¥"" "¥¥2" VCXPROJ_SOURCE_BACKSLASH "${VCXPROJ_SOURCE_ATTRIBUTES}") # Mac/iOSでも扱えるようにパス区切りを / に変換 string(REGEX REPLACE "¥¥¥¥" "/" VCXPROJ_SOURCES "${VCXPROJ_SOURCE_BACKSLASH}") 60 CMakeでプロジェクトを⽣成しての移植を始めて気付いたのが、必要なのはヘッダーとソースのリストだけだった、ということです。 vcxprojはXMLで、右のように正規表現で容易に取り出せました。 まず、vcxprojを読み込みます。 そこから、ソースおよびヘッダーを含むClCompileとClIncludeを取り出します。 更に、実際のソースコード名を取り出し、Mac/iOS向けにパス区切りを書き換えます。 RE ENGINEの作り⽅としてあまり複雑なプロジェクト設定はしていませんでした。 そのため、インクルードパスや各種マクロはルールベースで設定可能で、CMakeの関数の中に閉じ込められました。 モジュール別に、どうしても追加設定が必要な場合のみCMakeLists.txtに追記しています。 なお、最終的にソースコードの包含に条件判定を含める場合は別の⽅法が必要です。 結果として、ほとんどのモジュールはモジュール名を書く1⾏だけになりました。 この1⾏を書くと、同じフォルダにあるvcxprojからライブラリを⽣成してくれます。 60

62.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 Mac/iOSでの分散ビルドの模索 kernelの移植時点でビルド時間が数⼗分かかっていた 移植開始当時、Xcodeで利⽤できて安定した 分散ビルドシステムが無かった distccは廃⽌ FastBuildはベータかつ活発ではなかった Windowsでは分散ビルドが出来る環境があった && Clangは クロスコンパイルが出来る Windowsでオブジェクトファイルだけ⽣成しよう あくまでも開発中の効率化のためです。最終的にはXcodeを使うのが安全です 61 CMakeによりビルド環境は整えられたものの、当時のMacでは分散ビルドが使えず、どうしてもビルド時間が⻑くなるという問題がありました。 Kernelの移植時点で、数⼗分ほどの時間がかかっていました。 distccは廃⽌されており、FastBuildは当時ベータだったため、既に多くのタイトルを予定している環境に取り⼊れるには不安がありました。 Windowsでは分散ビルドができることと、Clangはクロスコンパイルが出来ることから、 Windowsでオブジェクトファイルだけでも⽣成してしまえばよいのでは、と思い付き、ビルド環境の構築を始めることになります。 なお、こちらはあくまでも開発中の効率化のためで、最終的にはXcodeを使っていただくのが安全です。 61

63.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 クロスコンパイル⽤Clangを⽤意する Visual StudioのLLVMツールセットのClangはx86/x86-64しか⽣成できません > clang --print-targets で確認可能です MacでClangのバージョンを確認し、そのバージョンをWindowsにインストールします もしくは⾃前でビルドします (上級者向け) LLVM_TARGETS_TO_BUILDにAArch64を指定します LLVM_ENABLE_PROJECTSに clang,clang-tools-extra,lld,lldbを指定します ビルド環境のCMake/Pythonのバージョンによっては ビルドできないので注意しましょう 62 まずは、クロスコンパイルのためのコンパイラーとして、Clangを⽤意します。 Visual StudioのLLVMツールセットに含まれるclangが使えないか、と思ったのですが、--print-targetsを確認すると、 x86/x86-64しかターゲットにできないことが分かります。 そこで、別途⽤意することにしました。 MacでClangのバージョンを確認し、そのバージョンをWindowsにもインストールします。 上級者向けの⽅法として、⾃前でビルドする⼿もあります。 その場合は、LLVM_TARGETS_TO_BUILDにAArch64を指定し、 LLVM_ENABLE_PROJECTSにclang,clang-tools-extra,lld,lldbあたりを指定すれば必要なものは揃います。 なお、ビルド環境のCMakeやPythonのバージョンによってはビルドエラーになったりするので、上⼿くいかない場合はバージョンを変更してみてください。 62

64.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 Macでのコンパイラーのオプションを確認する コンパイルオプションに-vを追加することで細かいオプションが確認できます いくつかの設定を揃えることでクロスコンパイルできるようになります 最低限押さえたいオプション • target arm64-apple-macosx26.0/arm64-apple-ios26.0など ビルド対象を決めるのに指定必須 • isysroot ヘッダーファイルを探すためのパス 63 続いて、Macでのコンパイラーのオプションを確認しましょう。 コンパイルオプションに-vを追加することで細かいオプションが確認できます。 いくつかの設定を揃えることでクロスコンパイルできるようになります。 最低限押さえたいオプションとしては、targetとisysrootです。 targetはクロスコンパイル先を指定するために必要です。isysrootは、ヘッダーファイルを探すためのヒントになります。 63

65.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 Windowsでビルドするためのヘッダーを⽤意する コンパイルに必要な最低限の情報さえあればオブジェクトファイルは ⽣成できます ⾃⼒で⽤意する コンパイルに必要なヘッダーファイルを⽤意する 必要最低限なインターフェースだけ整える Macのフォルダをマウントする Windows側でSMBv1が必要になるケースがあるので注意 CMakeでクロスコンパイルで⽣成したオブジェクトファイルを⾒るようにすればビルドが出来る あくまでも開発中の効率化のためで、最終的にはXcode経由のフローが必要です 64 さて、ヘッダーのインクルード時間を減らすために、必要な前⽅宣⾔だけ書いてコードを⽣成したことがある⽅は多いと思います。 コンパイルに必要な最低限の情報さえあれば、オブジェクトファイルは⽣成できます。 というわけで、Windowsでクロスコンパイルするためのヘッダーを⽤意します。 ヘッダーを⽤意する⽅法として2つほど考えられます。 1つは、⾃⼒で⽤意する⽅法です。どうしても必要なファイルとインターフェースだけ⽤意します。 ⼤変ですが、何の憂いもありません。 次に考えられるのが、Macのフォルダをマウントすることです。 ただ、WindowsとMacをつなぐ場合に、Windows側のSMBのv1が消えていると上⼿くいかないといったことがあったので、注意が必要です。 SMBv1を有効にしていると他のWindowsマシンとの接続でトラブルになることもあるので、本当に注意が必要です。 CMakeでクロスコンパイルで⽣成したオブジェクトファイルを⾒るようにすればビルドができます。 改めて⼤切なことなのですが、あくまでも開発中の効率化のためで、最終的にはXcode経由のフローが必要です。 64

66.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 #pragma comment(lib)に関する注意 ソースコードでリンクするライブラリを指定することができる 元々はMicrosoft拡張だが、Clang 7からはELF向けにも利⽤可能 ただし、Mac/iOSはMach-O形式のため、利⽤には-fms-extensionsの指定が必要 問題のあるコードを書けてしまうので、pragmaを指定するファイルを限定し そのファイルだけ指定するのが望ましい 65 ここで、少し注意したいポイントとして、pragma comment(lib)によるライブラリのリンクについてお話します。 これは、ソースコードでリンクするライブラリを指定できる機能です。 元々はMicrosoft拡張でしたが、Clang 7からはELF向けにも利⽤できるようになりました。 ただし、Mac/iOSはMach-O形式のため、利⽤するには-fms-extensionsの指定が必要です。 これを指定すると問題のあるコードを書けてしまうので、 pragmaを指定するファイルを限定し、そのファイルに対してのみ-fms-extensionsを指定する、といった⼯夫をすることをお勧めします。 65

67.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 Swiftへの対応 (1/4) 課⾦関連のライブラリStoreKitが更新されたがStoreKit 2はSwift版しか提供されなかった Objective-CはClangでクロスコンパイル可能 Swiftにはswiftcが必要 Swiftはコンパイラーバージョンを⾒ていてクロスコンパイルも困難 Windowsでコンパイルしたオブジェクトはそのまま使えなかった Swift 5.9でC++ interoperabilityが導⼊された C++向けにSwiftのメソッドを呼び出すためのヘッダーを⽣成してくれる 66 さて、これでビルド環境は整ったと⾔いたいところですが、 課⾦関連のStoreKitがStoreKit 2に更新された際に、Swift版しか提供されない、という問題が発⽣しました。 Objective-Cであれば、Clangでクロスコンパイル可能でしたが Swiftにはswiftcという別のコンパイラーが必要でした。 また、Swiftはコンパイラーバージョンを⾒ていて、クロスコンパイルが困難でした。 WindowsにもSwift環境があるため、何とかクロスコンパイルしたものを混ぜてみたのですが、そのままは使えませんでした。 悩んでいたところ、Swift 5.9でC++ interoperabilityが導⼊され、C++向けにSwiftのメソッドを呼び出すためのヘッダーを⽣成してくれるようになりました。 66

68.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 Swiftへの対応 (2/4) Swift C++ interoperabilityは⾃前クロスコンパイルと相性が悪かった 追加のヘッダーなどが⼤量に必要になった ⾃⼒でinteroperabilityを実装してみる 67 これでひと段落と思いきや、Swift C++ interoperabilityは⾃前クロスコンパイルと相性が悪かったのです。 追加のヘッダーなどが⼤量に必要になってしまいました。 そこで、⾃⼒でinteroperabilityを実装してみることにしました。 67

69.
[beta]
RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例

Swiftへの対応 (3/4)
interoperabilityで⽣成されたヘッダーを読み解いてみる
マングリング名で呼び出しているだけ
> swift demangle ʻ$sSS7cStringSSSPys4Int8VG_tcfCʼ
Swift.String.init(…)

_getOpaquePointer()が
分かれば何とかなる

/// Constructs a Swift string from a C string.
SWIFT_INLINE_THUNK String(const char *cString) noexcept {
if (!cString) {
auto res = _impl::$sS2SycfC();
memcpy(_getOpaquePointer(), &res, sizeof(res));
return;
}
auto res = _impl::$sSS7cStringSSSPys4Int8VG_tcfC(cString);
memcpy(_getOpaquePointer(), &res, sizeof(res));
}

68

まずは、interoperabilityで⽣成されたヘッダーを読み解いてみます。
$で始まる怪しい名前は、おそらく普段デバッグシンボルなどを読んでいるならおなじみかと思いますが、マングリング名ですね。
swiftにはデマングル機能があるので確認してみると、SwiftのStringの初期化関数でした。
後は、_getOpaquePointerが何か分かれば何とかなりそうです。

68

70.

RE ENGINEのプラットフォーム移植 | Mac/iOSでのビルド環境整備例 Swiftへの対応 (4/4) _getOpaquePointer()は実質SwiftObjectのような16バイトのオブジェクトだった extern “C”でマングリング後の名前を直接指定して呼び出せばOKだった __attribute__((swiftcall)) が必要な点に注意 同様にStoreKit 2の呼び出しだけ何とか作ってWindows上でのビルドフローに組み込んだ struct SwiftObject { uint64_t _1; void* _2; }; // ⽂字列でSwiftのStringを初期化する extern "C" SwiftObject $sSS7cStringSSSPys4Int8VG_tcfC(const char*) noexcept __attribute__((swiftcall)); 69 更に読み解いていくと、 _getOpaquePointerは、実質的にはコード例に書いたような8バイト整数と8バイトのポインタで構成された16バイトのオブジェクトを返していました。 ということで、extern “C”でマングリング後の名前の前⽅宣⾔を⽤意して、呼び出せるようにします。 ここで、__attribute__((swiftcall)) が必要な点のみご注意ください。 あとは、StoreKit 2についても名前を特定してしまって、何とかClangでクロスコンパイル出来る形に落とし込みました。 69

71.

RE ENGINEのプラットフォーム移植 70 ビルドが整ったので、Studioからruntimeを転送する部分の対応に移ります。 70

72.

RE ENGINEのプラットフォーム移植 | Studioの対応 runtime実⾏フローの整備 runtimeのインストール 多くのプラットフォームはコマンドラインでのインストールを提供している Macについてはsshで転送、iOSについてはlibimobiledeviceを利⽤ iOS 16以降、コマンドラインからの起動が不可能に ファイルの転送 多くのプラットフォームはWindowsのフォルダから読み取る機能を提供している iOSについては、Studioと通信してネットワーク経由でファイルを読み取る⽅式に smbなどを組み込むのは⼤げさ TCP/IP通信ならセキュリティなどで読み込めなくなったりしない Fileでラップしているのでそれ以外の部分は気にしなくてOK 71 さて、runtimeが出来てしまえば、実はStudioからの作業はさほど多くありません。 インストールについては、多くのプラットフォームがコマンドラインでのインストールを提供しています。 ただし、Macについてはssh、iOSについてはOSSのlibimobiledeviceを利⽤しています。 iOS 16以降、コマンドラインからの起動が不可能になっていて、その点が⽟に瑕です。 安全な解決策をご存知の⽅がいたら、教えていただけると助かります。 ファイルの転送についても、ほとんどのプラットフォームはWindowsのフォルダから読み取る機能を提供しています。 ただし、iOSについては、そのような機能が無いので、Studioと通信してネットワーク経由でファイルを読み取る⽅式にしました。 Smbを組み込むのは⼤げさ過ぎるのと、様々なセキュリティの制限が増えていったときも使える⽅式が良かったというのがあります。 Fileでラップした中で読み取らせているので、移植にはほぼ影響無く実装できています。 71

73.

RE ENGINEのプラットフォーム移植 | Studioの対応 まとめ 移植が必須な機能は意外と少ない 特に重要なのはファイル、スレッド、ロック、クロックくらい Mac/iOSのようにWindows向けのビルド環境を提供していなく ても⾃⼒で作成可能 今後の展望 Mac/iOSの署名をWindows上で実⾏可能にし、 開発中の環境をWindowsで完結させたい 72 RE ENGINEでは、⻑年の経験により様々なプラットフォームをサポートするために抽象化すべきポイントが確⽴しているため、 移植が必要な機能は意外と少ないです。 特に重要なのはファイル、スレッド、ロック、クロックくらいです。 また、Mac/iOSのようにWindows向けのビルド環境が無い場合でも、Clangがあれば⾃⼒で作り出すことは可能です。 今後の展望として、現在はMac/iOSの署名にはMacが必須なのですが、 これをWindows上で実⾏可能なOSSを利⽤して、開発中はWindowsのみで作業が出来るようにしたいと考えています。 72