コンテンツにスキップ

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 の実機で確かめられるようになってから

関連