HN 日本語サマリー

← 一覧へ戻る
プログラミング

W4ME Station – Java ME搭載携帯電話向けのWASM-4ランタイム

W4ME Station – a WASM-4 runtime for Java ME phones (github.com)

18 pointsby sqshi3 コメント

要約

W4ME Stationは、2000年代中盤のフィーチャーフォンを含むCLDC 1.1 / MIDP 2.0デバイスで、未変更のWebAssemblyカートリッジを実行できるJava ME向けのWASM-4ランタイムです。275KBのJARファイルに13個のカートリッジがバンドルされており、JITやネットワーク接続なしで動作します。開発にはLinuxと特定のツールが必要です。

全文翻訳

W4ME Station

Java ME搭載携帯電話でWASM-4ゲームを実行しましょう。

W4ME Stationは、2000年代中盤のフィーチャーフォンを含むCLDC 1.1 / MIDP 2.0デバイスに、未変更のWebAssemblyカートリッジをもたらします。

[画像: CI] [画像: Nightly quality] [画像: Java ME: CLDC 1.1 / MIDP 2.0] [画像: 最新リリース] [画像: MITライセンス]

[画像: W4ME StationがNokia E71で実行されている様子]

約292 KiBのJARファイルに13個のカートリッジがバンドルされています。ランタイムはJITを使用せず、バンドルされたライブラリはネットワーク接続を必要としません。両方のリリースバリアントは300 KiB未満に収まります。

ダウンロード

バリアントアプリケーションデスクリプタ
オプションのJSR-75ファイルブラウジング付きフルバージョンw4me-station.jarw4me-station.jad
JSR-75クラスまたはパーミッションなしのベースバージョンw4me-station-base.jarw4me-station-base.jad

リリースノートとSHA-256チェックサムは、バージョン管理された1.1.0アーティファクトの隣に保存されています。

W4ME StationはCLDC 1.1 / MIDP 2.0デバイスを対象としています。WASM-4のメンテナーとは無関係であり、承認されていません。

カートリッジライブラリ

さらに.wasmファイルをデバイスからインストールできます。

[画像: SokobanがNokia E71で実行されている様子] [画像: Wasm WarsがNokia E71で実行されている様子] [画像: Plasma CubeがNokia E71で実行されている様子]

特徴

  • 固定幅の永続的なW4IRキャッシュによる検証済みWebAssembly実行。
  • WASM-4のグラフィックス、入力、オーディオ、ディスク、テキスト、トレーシングホストAPI。
  • 13個のバンドルカートリッジに加え、HTTP(S)、RMS、URL、およびオプションのJSR-75ローディング。
  • 携帯電話キー、キーボードコントロール、ポインター入力、およびオンスクリーンタッチパッド。
  • チェックサム付きRMS世代による、カートリッジごとの永続的なディスクストレージ。
  • ネイティブな一時停止ゲームメニュー(続行、状態の保存、状態のロード、設定、カートリッジの再起動、終了アクション付き)。
  • 1つのセッション中の一時的な状態保存/ロードスロット。
  • デバイス依存のMMAPIオーディオ(MIDIストリーミング、playTone、およびサイレントフォールバック付き)。
  • RMSベースのグローバルハードミュートおよびマスターボリュームコントロール。
  • 決定論的なホスト、KEmulator、およびオプションのphoneME検証。

リリースバージョンは1.1.0です。検証された範囲と残りの制限については、互換性で文書化されています。

要件

開発には、justとdockerコマンドがインストールされたLinuxが必要です。Docker Engineは直接動作します。Podmanユーザーは、Docker互換コマンドを提供できます。プロジェクトツールチェーンには、JDK 8、ProGuard、KEmulator、WABT、およびサポートユーティリティが含まれます。バージョンに依存するコンポーネントは、コンテナ定義によって固定されています。

just setup
just doctor

JavaソースとクラスファイルはJava 1.3に固定されています。

ビルド

just build

アーティファクトはdist/に書き込まれます。

アーティファクト目的
w4me-station.jar / .jadオプションのJSR-75ファイルブラウジング付きフルビルド
w4me-station-base.jar / .jadJSR-75クラスまたはパーミッションなしのビルド

両方のバリアントには同じ13個のカートリッジが含まれています。ベースビルドは、オプションのFileConnection APIを実装していないMIDP 2.0デバイスでも動作します。

電話機へのインストール

上記の表から対応する.jad/.jarのペアをダウンロードし、両方のファイルを同じディレクトリに保管してください。JSR-75 FileConnectionサポートを備えたデバイスにはフルバージョンを使用し、フルバージョンが拒否された場合やデバイスにそのオプションAPIがない場合はベースバージョンを使用してください。

電話機のアプリケーションマネージャーまたはファイルマネージャーから.jadを開きます。デバイスがJADインストールを受け付けない場合は、対応する.jarを転送して直接開いてください。インストールに関する詳細とトラブルシューティングは、インストールで説明されています。

コントロール

入力プレイヤー1プレイヤー2
移動矢印キーまたは方向キーE, S, D, F
ボタン 1X, Fire, または 5Tab
ボタン 2Z または 0Q

タッチスクリーンデバイスには、オンスクリーン方向パッドとアクションボタンが表示されます。画面が十分に大きい場合、コントロールは160×160フレームバッファの外側に配置されます。

ゲームプレイのソフトキーは、完了したフレーム境界でネイティブLCDUIシステムメニューを開きます。ゲームの更新、プレゼンテーションタイミング、入力、およびオーディオの進行は、再生が再開されるまで一時停止されます。メニューには、続行、状態の保存、状態のロード、設定、カートリッジの再起動、および終了があります。

サウンド設定は、カートリッジライブラリとゲーム内コマンドメニューから利用できます。明示的なWAV合成、MIDI合成、およびSimple tonesプロファイル、グローバルなサウンドオン/オフハードミュート、およびバックエンドがサポートする場合はマスターボリュームを提供します。選択したテクノロジーが利用できない場合、フォームはアクティブなフォールバックを報告します。サウンドオフは、ホストオーディオのブックキーピング、合成、プレイヤーの作業、およびフレーム終了時のオーディオティックをバイパスします。確認された設定は、MIDletの再起動後も保持されます。

ゲーム内メニューには、一時的な状態の保存/状態のロードスロットも1つ用意されています。これは次の保存で上書きされ、カートリッジが再起動、閉じられるか、ライブラリに戻るとクリアされます。これは永続的なWASM-4ディスクストレージとは別であり、MIDletの再起動後も保持されません。

テストしたNokia E71では、短い効果音は機能しますが、連続した音楽は途切れます。オーディオのタイミングと忠実度はデバイスに依存します。互換性およびオーディオアーキテクチャと診断を参照してください。

カートリッジのロード

ランチャーには、上記の13個のカートリッジがこの順序で含まれています。

追加の.wasmファイルは、HTTP(S)からインストールするか、file:// URLとして入力するか、サポートされているデバイスでJSR-75ブラウザを使用して選択できます。インストールされたカートリッジはRMSにコピーされ、元のファイルやネットワークソースなしで再起動できます。

カートリッジはサードパーティの作品です。それらの著者、アップストリームソース、ハッシュ、およびライセンスは、サードパーティ通知に記載されています。

検証

just fmt
just quality
just analysis
just security
just verify

just qualityとjust verifyは、ローカルでの最小限のゲートです。Javaのプロダクション変更は、just analysisでError ProneとSpotBugsも実行されます。依存関係、ワークフロー、パーミッション、リリースツール、セキュリティの変更にはjust securityを使用します。

メインのCIは、厳密な分析、セキュリティ、正確性、リリース、およびチェックインされたアーティファクトのチェックを繰り返します。週次および手動でトリガーされるNightly qualityワークフローは、外部リンクチェック、Trivyスキャン、CycloneDX SBOM、および再現可能なリリース比較を追加します。ローカルで同じディープゲートを実行するには、次を使用します。

just nightly

安定したコマンドはjust --listで一覧表示されます。専門的なKEmulator、phoneME、およびプロファイリングコマンドについては、開発で説明されています。生成されたログ、スクリーンショット、ベンチマークレシート、および監査レポートはbuild/reports/の下に書き込まれます。

ドキュメント

ライセンス

W4ME Stationのソースコードは、MITライセンスの下で利用可能です。バンドルされているカートリッジは独自のライセンスを保持しており、MITライセンスの対象ではありません。

オプションのローカルphoneMEリグはGPL-2.0-onlyであり、プロジェクトとは一緒に配布されません。その変更された対応ソースはまだ公開されていないため、そのバイナリはローカルに保持され、無視される必要があります。パフォーマンスを参照してください。