Linux 版の配布パッケージ ( krkrz_linux )¶
吉里吉里Z 本体と作品のデータをまとめて、Linux 向けの配布物を作る方法です。
道具は外枠リポジトリ krkrz_linux。
krkrz_android / krkrz_ios / krkrz_web と同じく、エンジンは KRKRZ_BASE 経由で
krkrz_dev を参照し、Linux 固有のビルドとパッケージングだけを受け持ちます。
Linux の配布形式と方針¶
Linux には Android の APK のような「これ一つ」というアプリ形式がなく、配布先ごとに
形式が分かれます。ただ、どれも「そのまま動くフォルダ」に freedesktop の
メタデータ ( .desktop / アイコン / AppStream ) を添えて包み直したものです。
| 形式 | 主な配布先 | krkrz_linux |
|---|---|---|
| フォルダ / tar.gz | Steam のデポ、itch.io、GOG、Humble | ✅ 出力する |
| AppImage | 自前サイト、itch.io | 未実装 ( 同じフォルダから作れる。.desktop とアイコンは生成済み ) |
| Flatpak | Flathub | 未定 ( AppStream メタデータとマニフェストが要る ) |
ゲームで重要な Steam が受け取るのはフォルダそのものなので、フォルダを正式な 成果物とし、他の形式はその包み直しという方針です。
ビルド環境¶
Valve の Steam Linux Runtime 3.0 "sniper" SDK ( Debian 11 / glibc 2.31 ) の
コンテナでビルドします。SteamOS ネイティブ、Steam Linux Runtime、glibc 2.31 以降の
一般的なディストリビューションで動くバイナリになります。イメージは
steamdev の deckbuild/deckbuild.sh image
で作る deckbuild-sniper を使います。合格基準 ( 要求 glibc ≤ 2.31 /
GLIBCXX 依存なし ) は engine 側の src/core/doc/LinuxBuild.md が SSOT です。
使い方¶
export KRKRZ_BASE=~/kirikiri # krkrz_dev のある親フォルダ
cd ~/kirikiri/krkrz_linux
make all # サンプル案件 (コアデモ)
PROJECT_DIR=/path/to/mygame make all # 自分の案件
出力は ${PROJECT_DIR}/build/linux/ の下です。
package/<exeName>/… そのまま動くフォルダdist/<exeName>-<version>-linux-x86_64.tar.gz… それを固めたもの
案件の定義は ${PROJECT_DIR}/linux-config.json です。cmake ( プラグイン構成 ) と
assetPack ( 資材の取り込み、先勝ち ) は krkrz_android の app-config.json と同じ
書式なので、案件フォルダの資材定義を共有できます。項目の一覧は krkrz_linux の
README を参照してください。
パッケージの中身¶
mygame/
mygame 実行ファイル ( KRKRZ_EXE_NAME )
libSDL3.so.0 ( .x.y ) 同梱 SDL3
plugin/*.so プラグイン
mygame.cf orgname / appname ほか ( 生成 )
<id>.desktop, <id>.svg freedesktop のメタデータ ( 生成 )
license.txt, licenses/
data/ または data.xp3 引数なしで起動すると自動検出される
同梱 .so の解決 ( RPATH )¶
実行ファイルには $ORIGIN、krkrz_plugin() で作ったプラグインには
$ORIGIN:$ORIGIN/.. を DT_RPATH で埋め込んでいます。同梱の SDL3 や、
プラグインが依存する .so ( plugin/ か実行ファイルのフォルダに置く ) は、
LD_LIBRARY_PATH も起動スクリプトもなしで読まれます。
Steam から起動すると LD_LIBRARY_PATH の先頭に Steam ランタイムと /usr/lib が
入るため、RUNPATH ( 新しいリンカの既定 ) や LD_LIBRARY_PATH=. では SteamOS 側の
同名 .so が先に読まれてしまいます。DT_RPATH はそれより先に探されるので、
同梱版が確実に使われます。独自の CMake で RPATH を付けるプラグインは
--disable-new-dtags を使ってください ( RUNPATH を持つと実行ファイル側の
DT_RPATH も効かなくなります )。
プラグインのシンボル公開 ( 2026-10〜 )¶
krkrz_plugin() で作る共有プラグインは、Windows 以外では既定でシンボルを公開しません
( -fvisibility=hidden 相当 )。外から見えるのは DLL_EXPORT を付けた V2Link /
V2Unlink だけです。ncbind や simplebinder の雛形は最初から付いているので、そのままで
動きます。入口を自分で書くプラグインは DLL_EXPORT を付けてください。
以前はすべて公開されていたため、Linux ではプラグインどうしで同じ名前の inline な静的メンバ
( ncbind の自動登録の一覧など ) が 1 つにまとめられ、ncbind を使うプラグインを 2 本読むと
2 本目の読み込みで止まっていました ( macOS でも同様 )。独自の CMake でプラグインを作る場合も
同じ設定 ( C_VISIBILITY_PRESET / CXX_VISIBILITY_PRESET hidden と
VISIBILITY_INLINES_HIDDEN ) にしてください。
2026-10-27 からは、プラグインが静的リンクしたライブラリ ( libstdc++ / zlib / expat / threepp /
Effekseer など ) のシンボルも公開しません。上の設定はプラグイン自身のコードにしか効かないため、
Linux はバージョンスクリプト ( V2Link / V2Unlink だけを global にする )、macOS はリンカの
-exported_symbol で、公開する名前を V2Link / V2Unlink の 2 つに絞っています。独自の CMake で
作る場合は、Linux なら -Wl,--version-script=<ファイル> ( 中身は
{ global: V2Link; V2Unlink; local: *; }; )、macOS なら -Wl,-exported_symbol,_V2Link
-Wl,-exported_symbol,_V2Unlink を足してください。
例外の巻き戻し処理 ( libgcc_s.so.1、2026-10-27〜 )¶
本体とプラグインは libgcc_s.so.1 ( どの Linux 環境にもあるライブラリ ) を使います。
基準環境の gcc は libgcc を静的にリンクするため、以前は本体とプラグインがそれぞれ例外の巻き戻し
処理を持っており、プラグインの中で起きたエラー ( 例: Scripts.evalJSONStorage で読めないファイル )
を try / catch で捕まえようとしても、捕まえる前に異常終了していました。独自の CMake で
プラグインを作る場合は、Linux で -Wl,--push-state,--no-as-needed -l:libgcc_s.so.1 -Wl,--pop-state
をリンクの指定に足してください ( krkrz_plugin() を使えば自動で付きます )。
セーブデータの場所 ( 2026-10〜 )¶
重要 (2026-10 の変更)
Linux 版の既定のデータ保存場所 ( -datapath 未指定時 ) は、実行ファイルの隣の
savedata から ~/.local/share/<orgname>/<appname>/ ( $XDG_DATA_HOME
があればその下 ) に変わりました。詳細は
コマンドラインオプション の -datapath を参照してください。
orgname/appnameは案件の設定から取って<exeName>.cfに書き込むのが 決まりです。krkrz_linux はlinux-config.jsonのorgName/appNameから 自動で書き込みます。これで作品ごとに別のフォルダになります- 実行ファイルの隣に書かないので、読み取り専用の場所 ( AppImage、Flatpak、
/optなど ) に置いても動きます System.dataPathはローカルパス (file://./home/…) なので、Storages.getLocalName()も使えます- 実際の保存場所は起動ログの
datapath (Linux default, …)の行で確認できます
Steam Cloud¶
Steamworks の Auto-Cloud を使う場合は、Linux のルートを LinuxXdgDataHome
( = ~/.local/share )、サブディレクトリを <orgname>/<appname> にします。
Windows 版とは保存場所が違うので、両方を配布するときは「ルートの上書き」で
OS ごとに指定してください ( ルート種別の名前は Steamworks の設定画面で確認 )。
Steam Deck で確かめる¶
krkrz_linux の出力フォルダは steamdev でそのまま Deck に送れます。
steamdev -d <deck> deploy --gameid mygame_linux \
--dir build/linux/package/mygame --command "./mygame" --start
gameid は英数字・_・. だけです ( ハイフン不可 )。2026-10-06 に krkrz_linux の
サンプル案件 ( コアデモ ) で確認済みです: Deck のネイティブ実行で -demotest 全 24
シーン ok、同梱 SDL3 が読まれ、保存場所は /home/deck/.local/share/wamsoft/krkrz-sample/。
手順全体とハマりどころは Steam Deck 実機確認 を参照してください。
今後¶
- AppImage 出力 (
AppRunを足してappimagetoolで固める ) - xp3 アーカイブは krkrz_android と同じく案件側で事前に作り、
assetPackのflattenで取り込む ( 外枠では作らない )。暗号化なしの通常の xp3 は標準ツールのkrkrxp3で作れる - Flatpak は需要が出てから
- Windows は krkrz_windows で同じ書式の外枠ができた。Xbox / Store は krkrz_gdk。 macOS ( .app ) は Mac の実機で確かめられるようになってから
関連¶
- krkrz_linux — README に設定項目の一覧
- Steam Deck 実機確認 ( リリース前チェック )
- コマンドラインオプション —
-datapath/-orgname/-appnameと.cfの書式