Shopify POS 拡張、実行中の公開バージョンを取得可能に

何が発表されたか

• POS UI 拡張で shopify.extension.version プロパティが使えるようになった（API バージョン 2026-10）。
• 返る値は Dev Dashboard の Versions ページに表示され、shopify app deploy 時に選択するバージョン名。
• 値は「順序を持たない不透明な名前」であり、ソートではなく等価比較で扱う必要がある。
• ローカル開発サーバーから実行している場合は undefined になる。
• 対象は API バージョン 2026-10 をターゲットにした POS UI 拡張のみ。それ以前のバージョンでは変化なし。

開発者への影響

• POS は拡張バンドルをキャッシュしてオフラインでも動作するため、「マーチャントの端末で実際に動いているビルドはどれか」が従来は分からなかった。障害調査の切り分けが現実的になる。
• エラーログやサポート問い合わせにバージョン名を添付する運用にすれば、更新が反映されていない端末を特定できる。
• 既存拡張に対応作業は不要。利用する場合のみ 2026-10 を指定し、ローカル実行時の undefined をハンドリングする。

利用条件

• API バージョン 2026-10 をターゲットにした POS UI 拡張のみ。ローカル開発時は値が入らない前提でコードを書く必要がある。