OpenSiv3D v0.6.5 → v0.6.16 に移行する

[yotiosoft]

開発再開にあたって。

現在の Albus-Box が使用している OpenSiv3D は2022年時点で最新版の v0.6.5 なので、2026年時点で最新の v0.6.16 に移行する。

[yotiosoft]

OpenSiv3D v0.6.5 → v0.6.16 の更新差分

※ ChatGPT 5.6 Sol 調べ

影響度が高い変更

バージョン | 変更 | Albus Boxへの影響 -- | -- | -- 0.6.10 | Visual Studio 2022 17.6のビルド問題を修正 | 高。現在のv0.6.5プロジェクトを最新VSで使うより、0.6.16テンプレートへ移植する理由になる 0.6.13 | Visual Studio 2022 17.8対応 | 高。現行Visual Studioとの互換性が改善 0.6.13 | macOS Apple Siliconで音声が再生できない問題を修正 | 高。macOS版プレイヤーに直接関係する 0.6.15 | FileSystem::Extension()、FileName()、BaseName()の一貫性改善 | 高。曲名表示、拡張子判定、サムネイル／歌詞対応付けの結果が変わる可能性がある 0.6.15 | RegisterDragDrop失敗時もエンジンを起動継続 | 中～高。ドラッグ＆ドロップ環境の問題でアプリ全体が起動不能になる可能性が減る 0.6.16 | Windows/macOSの内部Boostを1.74→1.83へ更新 | 中。通常の再生機能への直接影響は小さいが、SDKと古いヘッダ／ライブラリの混在は禁止 各版 | engine/ファイルやサードパーティライブラリ更新 | 高。古いApp/engine/を残すと、SDKとの不整合が起こり得る

音声再生関連

Albus Boxは以下の基本Audio APIを使用しています。

Audio{ path }
play()
pause()
stop()
isPlaying()
seekTime()
seekSamples()
posSec()
posSample()
samples()
lengthSec()
setVolume()
setLoop()
release()

v0.6.6～v0.6.16の公式リリースノート上では、これらにAlbus Boxの修正を必須にする明確な名前変更は確認できません。そのため、音声プレイヤー部分は基本的にそのままコンパイルできる可能性が高いです。

特に関連する改善は次のとおりです。

• v0.6.13でmacOS Apple Siliconの音声再生不能問題を修正
• SDK内部の音声・サードパーティライブラリ更新
• 複数バージョンにわたるプラットフォーム間ビルド修正

ただし、次の動作はアップデート後に重点的な回帰テストが必要です。

• MP3、WAV、OGG、M4Aの読込
• 再生・一時停止・停止
• seekSamples()によるスライダーシーク
• ループ切替時の再生位置維持
• 曲末尾の検出と次曲遷移
• macOS Apple Silicon上の実再生
• 非ASCII文字を含む音声ファイルパス

なお、Albus BoxはAudio::getWave()を使っていないため、過去にあったgetWave()→getSamples()系の変更には該当しません。

ファイル・プレイリスト関連

v0.6.15では、次の関数の結果の一貫性が改善されています。

FileSystem::Extension()
FileSystem::FileName()
FileSystem::BaseName()

Albus BoxはFileSystem::Extension()でプレイリストかどうかを判定し、FileSystem::BaseName()を表示タイトルの生成に使っています。

影響が考えられるケースは次のとおりです。

• ファイル末尾に複数のドットがある
• 拡張子がない
• 隠しファイル風の名前
• ディレクトリ名にもドットがある
• 末尾区切り文字を含む
• 日本語やUnicodeを含むパス

コンパイルエラーになる変更ではありませんが、曲名や拡張子判定の結果がv0.6.5と完全には一致しない可能性があります。

プレイリストには絶対または取得時のファイルパスをそのままJSON保存しているため、アップデート後はWindows、macOS、Linux間でのパス互換性も確認が必要です。

ファイルダイアログ関連

v0.6.15では以下が追加・改善されています。

• Dialog::SaveFile()でデフォルトファイル名を指定可能
• Windows版Dialog::SaveFile()でデフォルトパスに./を指定可能

Albus Boxは音声、画像、歌詞、プレイリストの選択とプレイリスト保存にDialogを使用しています。既存コードはそのまま使える見込みですが、プレイリスト保存時にデフォルト名を表示する改善が可能です。

例えば新APIに合わせて、次のようなUX改善候補があります。

Dialog::SaveFile(filters, U"playlist.playlist");

正確な引数形式は、実装時にv0.6.16ヘッダで確認する必要があります。

GUI・文字入力・フォント

関連性の高い変更は次のとおりです。

• v0.6.8: Material Design Iconsをv6.5.95→v7.2.96へ更新
• v0.6.11: SimpleGUI::TextBox()の挙動改善
• v0.6.11: TextBoxAt()のHome／Endキー動作修正
• v0.6.11: フォントのタブ空白描画修正
• v0.6.12: Windows 11向けIME候補ウィンドウ追加
• v0.6.12: SDF/MSDFフォントのプリロード高速化
• v0.6.13: アイコン・絵文字由来テクスチャのミップマップ生成を高速化
• v0.6.15: 矩形内に文字が収まるか判定するDrawableText::fits()相当を追加
• v0.6.16: 長方形内のテキスト描画不具合を修正

Albus BoxではMaterial Designアイコンをボタン表示に多用しています。

IconFont::Play
IconFont::Pause
IconFont::Prev
IconFont::Next
IconFont::Setting
IconFont::FileOpen

既存の列挙子が維持されているかコンパイルで確認するとともに、アイコンデザインや寸法が変わっていないか目視確認が必要です。データセット更新により、同じ用途でも輪郭や余白が変わる可能性があります。

また、タイトル編集にSimpleGUI::TextBox()を使用しているため、次を確認すべきです。

• 日本語IME入力
• Home／Endキー
• フォーカス解除
• 入力欄外クリックによる編集終了
• フレームレスウィンドウのドラッグ処理との競合

描画・Neumorphism UI

Albus Boxは独自の円・角丸矩形・影を組み合わせたNeumorphism UIを持っています。関連する改善は次のとおりです。

• v0.6.6: RoundRectなどに上下グラデーション追加
• v0.6.11: drawShadow()のCPU負荷を20～50%削減
• v0.6.11～0.6.12: RoundRect::drawShadow()の複数の描画不具合を修正
• v0.6.14: VSync無効時の不正なフレームレート制限を修正
• v0.6.15: BMP読込の準拠度を拡張
• v0.6.16: 長方形内テキスト描画の不具合を修正

Albus BoxのUIには好影響が期待できますが、影の見え方がv0.6.5と微妙に変わる可能性があります。背景色、影の広がり、角丸境界、ボタン押下状態をスクリーンショット比較するのが適切です。

ウィンドウ・入力処理

Albus Boxはフレームレスウィンドウを使用し、Windows/macOS/Linuxごとに独自の移動処理を持っています。

Window::SetStyle(WindowStyle::Frameless);
Window::SetPos(...);
Window::GetState().focused;
Cursor::ScreenPos();
MouseL.pressed();

関連する変更は次のとおりです。

• v0.6.11: 非アクティブ時にキーの.pressed()が誤ってtrueになる問題を修正
• v0.6.14: Cursor::SetPos()関連修正
• v0.6.15: ドラッグ＆ドロップ初期化失敗時の起動継続
• v0.6.15: Windowsで複数ファイルのドラッグ開始に対応
• 各版: macOS/Linuxビルドや入力処理の修正

Albus BoxはCursor::SetPos()を直接使っていませんが、カーソル座標とフレームレス移動を密接に組み合わせています。DPI倍率の異なるモニター間移動も含めた確認が必要です。

特にmacOS版には画面座標を/ 2する処理があるため、SDK更新後も座標系との整合性が保たれるか注意が必要です。

JSON・設定ファイル

Albus Boxは次をJSONで保存しています。

• 音声プロファイル
• プレイヤー設定
• プレイリスト
• 歌詞データ

関連する主な変更は以下です。

• v0.6.7: JSONValidator追加、JSON機能強化
• v0.6.10: JSONのBinary Values対応
• 複数版: JSONの不具合修正、サードパーティ更新

Albus Boxが使っている基本操作、

JSON::Load()
json[U"key"]
arrayView()
getString()
save()

には明確な破壊的変更は見当たりません。ただし、現在のコードはJSONロード失敗やフィールド欠落への防御が弱いため、旧バージョンで作った以下のファイルを読み戻すテストが必要です。

• settings.json
• audio_profiles.json
• .playlist
• .lyrics

バージョン別の要約

• v0.6.6: Neumorphismに使える角丸矩形／枠の描画機能追加、engineファイル更新
• v0.6.7: JSON強化、UI・入力関連の改善
• v0.6.8: Material Design Icons更新、画像・ファイル関連機能追加
• v0.6.9: Arrayの未定義動作などを修正
• v0.6.10: Visual Studio 2022 17.6対応、JSON修正
• v0.6.11: TextBox・フォント・影描画・終了時クラッシュを修正
• v0.6.12: IME、画像、フォント性能を改善
• v0.6.13: Visual Studio 17.8対応、macOS Apple Silicon音声修正、テクスチャ性能改善
• v0.6.14: VSync、GIF、Cursor、メッセージボックス関連を修正
• v0.6.15: ファイル名処理、SaveFile、ドラッグ＆ドロップを改善
• v0.6.16: Boost等の内部ライブラリ更新、テキスト描画・Linuxビルド修正

移行リスクの結論

Albus Boxにおけるリスク順は次のとおりです。

1. 古いVisual Studioプロジェクト／App/engine/と0.6.16 SDKの混在
2. macOS・Linux側を更新せずWindowsだけ0.6.16にすること
3. FileSystem::BaseName()／Extension()の結果差
4. Material Designアイコンとフォント描画の見た目差
5. フレームレスウィンドウの座標・フォーカス処理
6. 旧JSON／プレイリスト／歌詞ファイルとの互換性
7. 音声シーク・ループ・曲末尾遷移の回帰

現状のコードを見る限り、Audio APIそのものを大幅に書き換える必要性は低そうです。最大の作業は、0.6.16テンプレートへのプロジェクト設定とengineリソースの移植、および3プラットフォームでの回帰確認です。

[yotiosoft]

Windows 版の移行

OpenSiv3D のバージョンアップデートに際しては、一番手っ取り早いのはテンプレートプロジェクトへのソースコードコピーである。
今回もその手法で行う。

1. v0.6.16 のテンプレートをダウンロード
2. 新規テンプレートプロジェクトを作成
3. 必要なファイルをコピー

以降に際して必要だったこと

• プロジェクト>プロパティ>C/C++>コマンドライン>追加のオプション
  • /source-charset:utf-8
• 共通ソースコード (../src/)
  • Source Files に追加
  • また、プロジェクト>プロパティ>VC++ ディレクトリ>インクルードディレクトリ に "....\src" を追加

[yotiosoft]

Windows 版移行時の問題

MSVC標準ライブラリの世代不一致

下記が v0.6.16 の Siv3D_d.lib で要求されている MSVC 標準ライブラリ内部関数。

__std_remove_4
__std_search_1
__std_find_last_of_trivial_pos_1
__std_find_end_1
_Cnd_timedwait_for_unchecked

どうも MSVC が古すぎるようで、VS 2022 のアップデートが必要。

Visual Studio 2022 17.11.5
MSVC 14.41.34120

ただ、既に VS 2026 が出ているので、この際だから Visual Studio をアップデートすることに。

Visual Studio 2026 18.9.0
MSVC 14.51.36231

アップデート後、MSVC のバージョンを v143 から v145 へ更新する必要があった。

プロパティ
→ 構成: すべての構成
→ プラットフォーム: x64
→ 構成プロパティ
→ 全般
→ プラットフォーム ツールセット
→ Visual Studio 2026 (v145)

[yotiosoft]

Windows 版のアップデートはビルド成功をもって完了。残るは Mac 版と Linux 版。