W4ME Station – Java ME搭載携帯電話向けのWASM-4ランタイム
W4ME Station – a WASM-4 runtime for Java ME phones (github.com)
要約
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.jar | w4me-station.jad |
| JSR-75クラスまたはパーミッションなしのベースバージョン | w4me-station-base.jar | w4me-station-base.jad |
リリースノートとSHA-256チェックサムは、バージョン管理された1.1.0アーティファクトの隣に保存されています。
W4ME StationはCLDC 1.1 / MIDP 2.0デバイスを対象としています。WASM-4のメンテナーとは無関係であり、承認されていません。
カートリッジライブラリ
| 番号 | カートリッジ |
|---|---|
| 1 | 倉庫番 |
| 2 | Wasm Wars |
| 3 | Annoying Robots |
| 4 | Waternet |
| 5 | Dragon Poker Draw |
| 6 | Tic Tac Toe |
| 7 | Watris |
| 8 | Glowfish Chess |
| 9 | Duck Maze |
| 10 | Untangle |
| 11 | Nyan Cat |
| 12 | Sound Demo |
| 13 | Plasma Cube |
さらに.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 / .jad | JSR-75クラスまたはパーミッションなしのビルド |
両方のバリアントには同じ13個のカートリッジが含まれています。ベースビルドは、オプションのFileConnection APIを実装していないMIDP 2.0デバイスでも動作します。
電話機へのインストール
上記の表から対応する.jad/.jarのペアをダウンロードし、両方のファイルを同じディレクトリに保管してください。JSR-75 FileConnectionサポートを備えたデバイスにはフルバージョンを使用し、フルバージョンが拒否された場合やデバイスにそのオプションAPIがない場合はベースバージョンを使用してください。
電話機のアプリケーションマネージャーまたはファイルマネージャーから.jadを開きます。デバイスがJADインストールを受け付けない場合は、対応する.jarを転送して直接開いてください。インストールに関する詳細とトラブルシューティングは、インストールで説明されています。
コントロール
| 入力 | プレイヤー1 | プレイヤー2 |
|---|---|---|
| 移動 | 矢印キーまたは方向キー | E, S, D, F |
| ボタン 1 | X, Fire, または 5 | Tab |
| ボタン 2 | Z または 0 | Q |
タッチスクリーンデバイスには、オンスクリーン方向パッドとアクションボタンが表示されます。画面が十分に大きい場合、コントロールは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/の下に書き込まれます。
ドキュメント
- 互換性と制限事項
- 電話機へのインストール
- 1.1.0 リリースノート
- 貢献
- リポジトリ自動化ルール
- セキュリティポリシー
- 開発とテスト
- パフォーマンス方法論
- リリースチェックリスト
- OpenSpecの変更
ライセンス
W4ME Stationのソースコードは、MITライセンスの下で利用可能です。バンドルされているカートリッジは独自のライセンスを保持しており、MITライセンスの対象ではありません。
オプションのローカルphoneMEリグはGPL-2.0-onlyであり、プロジェクトとは一緒に配布されません。その変更された対応ソースはまだ公開されていないため、そのバイナリはローカルに保持され、無視される必要があります。パフォーマンスを参照してください。