HN 日本語サマリー

← 一覧へ戻る
プログラミング

Windows XP向けPrincipiaの構築

Building Principia for Windows XP (voxelmanip.se)

90 pointsby LorenDB24 コメント

要約

Principiaは2014年のリリース当初、Windows XPでも動作するゲームでした。オープンソース化された現在、モダンなツールチェインや依存関係によりWindows XPでの動作は保証されませんが、この記事では、カスタムツールチェインを構築し、古い依存関係をビルドすることで、PrincipiaをWindows XPで再び動作させるための技術的な道のりが詳細に説明されています。特に、GCCのコンパイル問題やlibstdc++の互換性問題への対処が詳しく解説されています。

全文翻訳

PrincipiaをWindows XPでビルドする

[画像: Windows XPの起動画面のロゴが、Principiaのアドベンチャーレベルのスクリーンショットにブレンドされている。Windows XPのLunaタスクバーが下部に表示され、Principiaが実行されている様子を示している。]

Principiaが2014年にWindows向けに初めてリリースされた当時、このゲームはWindows XPのような古いバージョンでも動作しました。Principia 1.4がWindows XPがまだメインストリームサポートを受けていた時期にリリースされたことを考えると、当時としては当然のことでした。当時のツールや依存関係がまだ互換性を持っていたため、サポートしない理由はありませんでした。

今日、Principiaはオープンソースプロジェクトとして進化しています。Windows版はWindows 7までは動作するはずですが、UCRTのような最新のツールチェーン、依存関係、システムライブラリの使用により、エコシステムが進歩するにつれて将来的な互換性を保証することは困難になっています。しかし、これは私がいつか変更したいと思っていたことであり、PrincipiaをWindows XPに戻し、そこで実行できる完全にオープンソースなビルドを作成することでした。

Principiaの技術的詳細

まず、この取り組みに関連するPrincipiaの技術的な詳細を説明するのが有益でしょう。Principiaは元々2012年頃の携帯電話で動作するように設計されたゲームなので、OpenGL 2.0をサポートする非常に古いハードウェアでも問題なく動作するはずです。Principiaは依存関係が非常に少なく、クロスプラットフォームサポートのためにSDLを利用しています。SDL(SDL2と新しいSDL3の両方)は依然としてWindows XPをサポートしており、前述のようにPrincipiaもかつてはWindows XPで動作していました。そのため、オープンソース版での作業中にXP互換性を壊すような変更がなければ、コードをそれほど変更せずにXPで再び動作させることが可能であるはずです。

主な問題は、ツールチェーンと、新しいWindowsバージョンに移行した他のいくつかの依存関係です。

PrincipiaのWindows版は、公式にはmingw-w64 Windowsツールチェーンでのみコンパイルがサポートされています。歴史的には、これはMSVCがPrincipiaのバックエンドエンジンTMSで使用されているC99機能のサポートを欠いていたためでしたが、現在この状況がどうなっているかは定かではありません。しかし、mingw-w64には、Windowsネイティブには実際には存在しない単純なC関数に対するさまざまなポリフィルも含まれており、MSVCでPrincipiaをビルドすることに強い関心を持つ人が現れない限り、これはすぐに変わることはないでしょう。

いずれにせよ、FOSSツールチェーンは、古いバージョンのWindowsをターゲットにできる最新バージョンを容易に入手できる傾向があります。しかし、公式のWindowsビルドに使用しているMSYS2の現在のLLVMベースのmingw-w64ツールチェーンは、UCRTへのリンク、LLVMのlibc++が7以降であること、そして他のサポートライブラリが例えばVistaに存在するシンボルを期待してビルドされているため、Windows XPをターゲットにするには不向きです。そのため、これからは一歩離れて、別のものを探すか、ソースからビルドする必要があります…。

独自のツールチェーンをビルドしよう!

Vista/7よりも古いバージョンになると、既存のmingw-w64ツールチェーンの互換性は低下し始めます。LLVMベースのツールチェーンは、C++プロジェクトではlibc++がそれ以前のバージョンをサポートしていないため、最低でもWindows 7が必要です。一方、その他のGCCベースのツールチェーンは、ビルド済みのサポートライブラリにVista以降のAPIが常に存在することを期待してビルドされています。95のような古いバージョンをターゲットにすることを主目的としたツールチェーンも存在しますが、私は最終的に自分で構築することにしました。これはおそらく最も簡単な方法でした。なぜなら、特にLinuxホストで実行し、Windowsをターゲットにできるクロスコンパイルツールチェーンも欲しかったからです。

さて、GCC、binutils、mingw-w64をコンパイルすることになります…他に何が必要でしょうか?ああ、なんてこった…

幸いなことに、私はMartin Storsjöが書いたDockerfile(彼はllvm-mingwの人として知られているかもしれません)という切り札を持っていました。彼は以前#mingw-w64 IRCチャンネルでこれをリンクしていました。私は好奇心旺盛だったので、このDockerfileを単純なシェルスクリプトに書き直し、各コンポーネントごとに段階を分けていました。

手元にあったバージョンにいくつかの調整を加え、32ビットWindowsのためにトリプレットをi686-w64-mingw32に変更し、システムランタイムとしてMSVCRTをターゲットに切り替え、デフォルトのWIN32_WINNTを0x0501(Windows NT 5.1、Windows XPに対応)に設定しました。そして、それがまだビルドできるか実行してみました。

最初のlibgmp(GNU MP Bignumライブラリ)のビルド段階で、機能しないコンパイラに関する奇妙なエラーで失敗しました。困惑した私は、autotoolsが生成したconfig.logに入り、非常に奇妙なコードをコンパイルしようとしてエラーが発生したことを確認しました。

for(i=0;i<1;i++){if(e(got,got,9,d[i].n)==0)h();g(i,d[i].src,d[i].n,got,d[i].want,9);if(d[i].n)h();} 

私はこれを最新のGCC 16でビルドしていましたが、執筆時点でのGMPの最新安定版(6.3.0)は、デフォルト設定ではGCC 15以降でコンパイルできないようです。ビルドシステムには、空のパラメータを持つ関数を含むコードをコンパイルするコンパイル時チェックがあります。古いバージョンのCでは、これは任意の数の引数を渡せることを意味しましたが(これを防ぐためにfoo(void)を使用)、C23では空のパラメータリストは引数を渡せないという意味に変更されました。GCC 15はデフォルトでC23を使用するため、このコードのコンパイルに失敗し、ビルドシステムはそれを壊れたコンパイラとして扱います。

ArchのGMPのビルドスクリプトで最初の問題のパッチを見つけましたが、最終的にはGMPを-std=gnu99でビルドするように設定して、autotoolsファイルを再生成することなく、問題を解決してビルドプロセスを進めることにしました。

その後は、ほとんど順調でした!MPFR、MPC、binutils、GCCをビルドしました。次に、新しくビルドしたGCCを使用してmingw-w64のCRTとライブラリをビルドし、GCCのライブラリをツールチェーンを使用してビルドしました。

ビルド中に、特にC++標準ライブラリにおいて、GCCの最近の変更がWindows XP互換性を壊していないか確認したかったのです。その時、GCC 16に付属するlibstdc++が、Vista以降のWin32 API関数に新たにハード依存していることを発見しました。具体的には、std::chronoでタイムゾーン処理に使用されるGetDynamicTimeZoneInformationです。

私はこのような自分でツールチェーンをビルドすることにほとんど一人で取り組んでいますが、他人のツールチェーンから物を借りることをためらいません。w64devkitの32ビット版はGCC 16を使用し、依然としてWindows XPをサポートしており、そこからこのことを知りました。彼らはまた、上記のAPI関数への依存を動的なものに変更し、シンボルを取得しようと試み、存在しない場合はフォールバックするというパッチも提供しています。std::chronoはC++20の機能であり、PrincipiaはC++11標準をほとんど使用していないため、単にスタブ化するだけでも問題なかったでしょう。しかし、すぐに使えるきれいなパッチが常に最善です!

そのパッチとGCCのコンパイルに費やした時間のおかげで、Windows XPで動作するバイナリを生成できるとほぼ確信できるツールチェーンが手に入りました。すべての部品はNT 5.1をターゲットにビルドされており、プログラムが新しい関数を使用しない限り、動作するはずです!スモークテストとして、Wineで単純なhello worldプログラムをコンパイルして実行したところ、コンパイラは実際に実行可能なWindows実行ファイルを作成できることがわかりました。

依存関係のビルド

Principiaをビルドする前に、新しくビルドしたツールチェーンで依存関係をビルドする必要があります。Principiaには、外部で提供する必要がある以下の依存関係があります。

  • curl
  • Freetype
  • libjpeg-turbo
  • libpng
  • SDL
  • zlib

これらは世界で最もポータブルでユニバーサルなソフトウェアライブラリの一部です!しかし、その中でもcurlは少し厄介でした。彼らは最近、curl 8.19.0でWindows XPのサポートを終了しました。これはネットワークライブラリとしては理解できますが、なぜかcurl 8.18.0でも動作しませんでした。それはmsvcrt.dllにfreopen_s関数を探そうとしますが、XPには存在しません。私はcurl 8.17.0を選択しました。これは、実行する場所を考えるとまだ非常に新しいバージョンです。

Luantiのコア開発者であるsfan5は、Windows用のさまざまな一般的なライブラリのクロスコンパイル用ビルドスクリプトのリポジトリ(リンク)を持っており、Luantiに必要な依存関係のビルドに使用されており、他のことにも役立つリソースとなっています。Principiaが必要とするすべての依存関係はカバーされており、あっという間にすべての依存関係がビルドされました!

…しかし、Principiaがデスクトップでダイアログに使用するGTK3という、かなり大きな問題があります。これは巨大な依存関係であり、その依存関係のツリーには触れたくないほどです。コミット履歴から古いGTK2ダイアログを復活させるか、Windows XPをサポートする古いバージョンのGTK3が存在するかもしれませんが、私は少なくとも当初はこの問題に対処したくありませんでした。代わりに、Dear ImGuiを使用する実験的な新しいダイアログでゲームをビルドすることにしました。これははるかに軽量な依存関係であり(私たちのユースケースにより適しており、ゲームウィンドウに統合されています)、しかしゲームの多くのダイアログはまだ実装されていません。

いつか改善されることを願っていますが、今のところ、これらのビルドはユーザビリティの面で少し制限されるでしょう。

Principiaのビルド

ここまでのすべての前提条件が完了したので、残っているのはPrincipiaを実際にビルドすることだけでした。これには、クロスコンパイラツールチェーンとすべての依存関係を指定するための長いCMakeの呪文が必要でした…CMakeオプション名とパスで少し格闘した後、設定は成功しました。

そしてビルド。ほぼ終盤に差し掛かったところで…コンパイラエラーが発生しました。pipeline.cのTMS内で、これらのtypedefに関連する、互換性のないポインタ型に関するエラーです。

typedef void (*TMS_UNIFORM_FN)(GLint, GLsizei, const GLfloat*);
typedef void (*TMS_UNIFORM_MAT_FN)(GLint, GLsizei, GLboolean, const GLfloat*);

pipeline.cはおそらくコードベースの中で最も複雑なソースファイルの一つです。私は長年改善してきましたが、それでも触りたくないファイルの一つです。しかし、問題は非常に単純であることが判明しました。__stdcallを聞いたことがありますか?これはWin32 API関数の呼び出し規約を定義します…あるいはそれに類するものです。一方の定義は__stdcallを期待し、もう一方は期待しなかったため、コンパイラエラーが発生しました。

なぜこうなっているのかは不明ですが、コードベース全体で同様のケースを他にもいくつか見てきたので、ゲームが不完全なGLヘッダーを使用していた頃の古い遺産だと推測しています。typedefは基本的にGLADで既に定義されている関数プロトタイプの重複(呼び出し規約の部分を除く)なので、より長い定義をそれらへのエイリアスに置き換えることができます。

typedef PFNGLUNIFORM1FVPROC TMS_UNIFORM_FN;
typedef PFNGLUNIFORMMATRIX4FVPROC TMS_UNIFORM_MAT_FN;

なぜこれがWindowsで以前に問題にならなかったのか?不明です。いずれにせよ、コンパイルできるようになりました!やった。

バイナリのテスト

まず、XPで動作するかどうかを心配する前に、バイナリがそもそも実行できるかどうかを確認するために、すぐにスモークテストを行うのが良いでしょう。私たちが知っていたのは、ツールチェーンでHello Worldプログラムを作成できたということだけです。今や、多くのライブラリとPrincipia全体をビルドしました。これは少し複雑なプログラムです。

それをテストするのに、Wineで実行する以上の方法があるでしょうか?

はい、問題なく動作します。では、このような時のために用意しておいたWindows XP仮想マシンに移動しましょう。

前述のcurl 8.18.0がfreopen_sを要求する問題に対処した後、Principiaを起動しようとした際に表示される、機能的なOpenGLドライバーがない場合に表示されるエラーメッセージまで到達できました。これは、実行ファイル(Principia EXEとライブラリDLLの両方)がXPに存在しない関数へのハード依存を持っていないという良い兆候です。

[画像: [エラーダイアログ] お使いのグラフィックドライバーはOpenGL >1.1をサポートしていません。そのためPrincipiaは起動しません。おそらく、グラフィックドライバーがインストールされておらず、Windowsのソフトウェアレンダリングドライバーを使用しているためです。お使いのグラフィックカードに必要なドライバーをインストールしてください。テスト目的でVMを使用している場合は、Mesaのソフトウェアレンダラーを使用して[テキストが途切れている...]]

新しいバージョンのWindowsでは、仮想マシンで遅いが機能的なOpenGLサポートを得るためにMesaソフトウェアレンダラーを使用していますが、XPで動作するバージョンを見つけることができませんでした。そのため、現時点での最善策は…Windows XPを実機にインストールすることだと思われます。

Windows XPをインストールしよう!

これはある意味で、物事が脱線し始めたところです。当初は、ビルドをテストするために古いラップトップにWindows XPをインストールした友人のために意図されていましたが、私が完了する頃には彼女はXPでWi-Fiドライバーが動作しないことに不満を抱き、Windows Vistaをインストールするために離れていました。そのため、結局自分でやらなければならなくなりましたが、XPをインストールするのに最適なマシンを持っていました。

2022年に新しいデスクトップを構築するまで使用していた以前のデスクトップは古いです。非常に古いです。UEFIマザーボードではなく、AMD Phenom II X4 955プロセッサを搭載しています。Windows XPがメーカーによってドライバーでサポートされていた年式の範囲内であり、完璧であるはずです。 anyway、新しいデスクトップを構築して以来、ほとんどほこりをかぶって座っていました!

オリジナルのWindows XP ISOからUSB経由でインストールし、SATA SSDにインストールするのは複雑だろうという考えから、追加のアップデートやドライバーが含まれた非公式ISOを探しました。しかし、これはあまり良い結果をもたらしませんでした。

[画像: Windows XPのブルースクリーンオブデス]

絶望的になり、友人に、聞くまで存在を知らなかったものについて勧められました。The Universal NT Installerは、Vista以前のすべてのWindows NTバージョンを、パッチありまたはなしでインストールできるLinuxベースのISOです。Linuxベースなので、USBから起動するのは簡単で、AHCIなどをサポートするWindows XPのバージョンをインストールできました。完璧です!

[画像: OS Edition: Windows XP Professional SP2 x64 (Patched)]

実機で再びWindows XPの起動画面を見るのは、かなりの体験でした。

[画像: Windows XPの起動画面にロゴの下に「x64 Edition」と表示されている。]

セットアッププロセスを進め、マウスをまだ接続していなかったので、すべてキーボードで行いました。その後、低解像度のデスクトップに放り出され、インターネット接続はありませんでした。イーサネットケーブルを接続したはずでは…?

[画像: Windows XPのドライバーインストールウィザードで、イーサネットコントローラーのドライバーを検索するためにインターネットに接続するかどうか尋ねている。]

ああ、イーサネットコントローラーのドライバーがない…Windowsよ、イーサネットドライバーを検索するためにインターネットに接続するのは大変だ。

その後しばらくの間、USBメモリにドライバーを見つけてXPマシンに挿入する作業に費やしました。次に、プライマリパーティションが検出できるものとUSBメモリを交換しました。その後、オンラインになり、Legacy Updateをインストールし、アップデートのインストールを開始しました。これには、統合ATI Radeon HD 3000グラフィックス用のドライバーなどが含まれていました。より新しいブラウザもインストールしたかったので、友人がWindows XPで動作する古いソフトウェアのコレクションを持っていることを思い出しました。例えば、XP向けのFirefoxの最終バージョンなどです。

[画像: Firefoxのインストールウィザード(ポーランド語)]

ポーランド語でした…まあ、XP向けのバックポートされた最新のChromiumフォークであるSupermiumのバージョンもインストールしました。しかし、本当にテストしたいのはPrincipiaです。HDMIケーブルをメインデスクトップとキーボードに再接続し、Principiaのビルドをサムドライブにコピーしました。次に、HDMIケーブルをXPマシンに、キーボードとサムドライブと一緒に再接続しました。

Principiaをデスクトップにコピーしました。フォルダを開き、principia.exeを起動しました。起動し、ロードされました。そして、メインメニューが表示されました。成功です!数日間行ってきたすべてのことが、この瞬間に繋がりました。

[画像: Principiaのメインメニュー、Windows XPのタイトルバーと、Principiaの前面に表示されているWindows XPのwinverダイアログ。]

…フォントが崩れていますが、これは私の統合ATIグラフィックスのOpenGLドライバーに固有の問題である可能性が高いです。Tensy(32ビットWindows版はXPで動作します!)を試したところ、同じようにテクスチャが破損しましたが、OpenGLの場合のみでした。(この問題が発生した場合は、代わりにDirect3DでTensyを実行するために-d3dを使用してください!)

[画像: XP上のTensyのメインメニュー、深刻なグラフィックの破損を示している]

2014年製の古いPrincipia 1.5.1も試しましたが、これはWindows XPで動作するはずだとわかっています。そして、同じフォント破損バグがあります。そのため、OpenGLドライバーの問題であるとほぼ確信しています。

いずれにせよ、当初設定した目標は達成されました。Principiaをオープンソースの形でWindows XPに戻し、実機でWindows XPをいじることができました。全体として素晴らしい旅でした。

[画像: PrincipiaがWindows XPで実行されているフルスクリーンショット、デスクトップが表示されている、Art Adventureレベルをプレイしている。]

その他…

XPで動作するようになった後、ビルドを改善したいと思いました。当初、Schannel TLSバックエンドを使用してlibcurlをビルドしました。これはWindowsに存在するTLSスタックに依存しています。最新または最新バージョンのWindows 7以降をターゲットにする場合、これは完全に機能しますが、XPのTLSスタックは古いため、ゲームはコミュニティサイトに接続できませんでした。どのTLSライブラリを選択するかについて考えすぎた後、mbedTLSを選択しました。ビルドが簡単で、XPをサポートする最後のバージョン(3.4.1)はかなり新しいためです。また、curlが使用する最新のCAストアもバンドルしました。

公式ビルドで使用されているNSISスクリプトを取得し、ビルドからインストーラーを作成しました。通常のポータブルアーカイブに加えてです。これにより、インストーラーを実行するだけで、ゲームのプロトコルハンドラーが登録され、Supermiumでコミュニティサイトから便利にレベルをプレイできます。

ツールチェーン、依存関係、Principiaをビルドするためのすべてのスクリプトは、このGitHubリポジトリで入手できます。これを行った後、人々が試せるようにリリース2026-06-10-xpも作成しました。Principiaのメンテナーではありますが、これはおそらく公式にメンテナンスされるビルドとは言えないでしょうし、公式ビルドと同じリリースサイクルに従う可能性は低いでしょう。

コメントとサポート

ブログ記事については、Voxelmanipフォーラムのこのフォーラムスレッドで議論できます。

すべてのブログ記事は人間によって書かれており、この文章から価値を得た場合は寄付をいただけると幸いです。