Playgroundを開く。SDK v0.4.0の機能をブラウザ内で確認できます。ソースはサーバーへ送信しません。
Webの操作
確認例を選び、Luaソース・環境・「SDK操作列」を確認して「最初から実行」を押します。「1操作進める」は同じセッションで1件ずつ操作し、「中断」はWorkerを終了します。 解析・ビルド・最適化だけではLuaを実行しません。loadがトップレベルを実行し、tick/drawなども別の明示操作です。ページを開く、入力を編集する、保存内容を復元する操作では、自動実行しません。
結果はSDKのレスポンスとして表示されます。描画結果はモニター、診断やエラーは結果欄に出ます。生成Luaはコピーでき、入力と操作列はversion付きJSONで書き出し・読み込みができます。
16種類の確認例
ホスト関数の固定戻り値、地図の単色画像、HTTPの手入力返信は、選択したテスト入力です。未提供の機能が実ゲームと同じように動くよう装うものではなく、実ネットワークへのプロキシもありません。
Source Mapの検査
「Source Map / 最適化を説明する」を実行し、生成物のマップを開きます。原文か生成Luaの範囲を選んで調べると、対応候補・精度・理由・関連元・inline文脈・除去記録を表示します。原文は生成時のsnapshotであり、その後編集した入力とは区別されます。 「元ファイルへ戻る」は通常/LifeBoatの複数module、「停止・ログ・エラー」は実SDKの実行位置を確認する例です。マップ閲覧だけではLuaを実行せず、「生成物をVMへロード」が必要です。実行時に生成行しか分からない場合は列を推測せず、複数候補を表示します。 コード、map、その組の成果物JSONを保存できます。取り込んだ成果物はSDKで検証し、異なるコードのmapや破損データを拒否します。マップには原文全文や固定化された設定を含むため、共有するファイルの内容を確認してください。 v0.4.0で生成するmapの拡張情報はschema 2です。schema 1のmapは読み込めないため、旧版で保存した生成物は元ソースと設定から再生成してください。成果物JSONのversion:1とmap内のx_storm.schemaVersion:2は別の形式版です。0.4への移行も参照してください。
操作列を変更する
操作列の{"$source":true}はソース欄、{"$environment":true}は環境の選択を参照します。操作にasを付けて結果へ名前を付け、{"$ref":"compiled.code"}で後続のloadへ渡せます。公開APIを試す薄い接続処理であり、独自のLua最適化器や描画式を含みません。
CLI
EngineリポジトリでSDKをビルドし、appの依存を導入した後、npm --prefix app run cli -- --listで例を一覧できます。npm --prefix app run cli -- --recipe vehicleで実行し、--project FILEでWebから書き出したケースを実行します。
--jsonlは標準入力の1行につき1操作を同じセッションへ渡します。単一ファイルにはminify FILE、run FILEもあり、minify FILE --source-mapで理由付きmapを取得できます。map-inspect ARTIFACT_FILE GENERATED_BYTEは保存した生成物の詳細を調べます。拡張環境には--extendedを明示します。ヘルプは--helpです。