简介：这份资源是JAVA ME游戏「9688雷霆战机」的个人移植源码包，面向希望入门J2ME移动游戏开发、想通过真实项目理解游戏框架的开发者与学习者。源码围绕KVM虚拟机、CLDC配置与MIDP简表展开，涵盖gameLogic、ui、sound、resource等模块，主类实现MIDlet接口负责初始化与生命周期管理，并包含GameLoop游戏循环、对象模型、碰撞检测、状态机控制、Canvas绘图与触摸事件响应、图像与音频资源管理等核心内容，同时涉及帧率控制、内存管理与缓存策略等优化思路。压缩包为zip格式，整体约4.4MB，文件类型明细上游暂未提供。目前已有1133人学习关注。读者可借助完整源码梳理JAVA ME游戏从启动到渲染、从事件处理到资源调度的整体流程，掌握游戏生命周期与性能调优方法，提升代码阅读与问题调试能力，为自行开发同类小游戏打下基础。
1. 从功能机到智能机：9688雷霆战机移植到底在移什么
手里还留着那台按键机的人，多半都动过一个念头：把当年玩得最顺的那款飞行射击游戏，搬到安卓或者桌面上再跑一遍。9688雷霆战机这类 JAVA ME 时代的横版弹幕游戏，当年跑在几百 KB 的堆内存里，屏幕分辨率普遍是 240×320，按键只有方向键加两个软键。现在要移植，不是把 jar 包丢进模拟器就完事——那叫运行，不叫移植。真正的移植，是把 MIDlet 的生命周期、Canvas 的绘制循环、RMS 存档、按键映射这一整套逻辑，重新落到一个新宿主上，同时保留原来的手感。
这件事适合两类人：一类是想练手 J2ME 图形与线程模型的开发者，一类是手里有老游戏资源、想让它在新设备上可控运行的折腾党。难点不在语言，Java 语法没变，难在 MIDP 的 API 在新平台上没有对应实现，你得自己补一层适配。下面按我实际做过的路径，从工程结构拆到绘制循环，再到按键和存档，最后讲几个必踩的坑。
2. 拆开一个 JAVA ME 游戏工程：MIDlet、Canvas 与 RMS 三件套
2.1 先认清 MIDlet 生命周期，别急着改绘制
J2ME 游戏的入口是MIDlet子类，它有三个必须实现的方法：startApp()、pauseApp()、destroyApp()。很多人移植时第一反应是去改paint()，结果发现游戏根本起不来，因为startApp()里没把Display设好。典型结构是这样：
public class ThunderMIDlet extends MIDlet { private ThunderCanvas canvas; protected void startApp() { if (canvas == null) { canvas = new ThunderCanvas(); } Display.getDisplay(this).setCurrent(canvas); // 关键：把画布设为当前显示 canvas.startLoop(); // 启动游戏主循环 } protected void pauseApp() { if (canvas != null) { canvas.pauseLoop(); // 暂停线程，释放 CPU } } protected void destroyApp(boolean unconditional) { if (canvas != null) { canvas.stopLoop(); } } }逻辑说明：startApp()可能被多次调用（比如从暂停恢复），所以canvas要做空判断，避免重复创建导致两个循环同时跑。pauseApp()里必须停掉游戏线程，否则来电或切后台时线程还在跑，回来就是花屏。参数上，destroyApp的unconditional为 true 时表示强制销毁，此时要保证资源释放，RMS 记录要落盘。
2.2 Canvas 的绘制循环：为什么不能直接在 paint 里写逻辑
J2ME 的Canvas提供paint(Graphics g)，但它是被系统回调的，你不能在里面写while(true)。正确做法是单独开一个游戏线程，按固定帧率更新状态，然后调用repaint()触发重绘。常见写法：
class ThunderCanvas extends Canvas implements Runnable { private volatile boolean running = false; private Thread loopThread; private int frameDelay = 40; // 约 25 FPS，老游戏常见节奏 public void startLoop() { running = true; loopThread = new Thread(this); loopThread.start(); } public void run() { while (running) { long start = System.currentTimeMillis(); updateGame(); // 更新飞机、子弹、敌机坐标 repaint(); // 请求重绘，系统会调 paint long cost = System.currentTimeMillis() - start; if (cost < frameDelay) { try { Thread.sleep(frameDelay - cost); } catch (Exception e) {} } } } protected void paint(Graphics g) { g.setColor(0x000000); g.fillRect(0, 0, getWidth(), getHeight()); drawPlayer(g); drawBullets(g); drawEnemies(g); } }逻辑说明：updateGame()只改数据，paint()只画数据，两者分离。frameDelay是节奏参数，设 40 毫秒约 25 帧，设 33 约 30 帧。老游戏很多逻辑是按帧写的，改帧率会直接影响弹幕速度和难度，所以移植时这个值要跟原版对齐，不能随手调。volatile保证running在线程间可见，避免停不下来。
2.3 RMS 存档：记录结构比 API 更容易翻车
J2ME 用RecordStore做持久化，移植时如果直接换文件存储，要注意记录格式。原版通常把最高分、关卡进度、音效开关打包成一个 byte 数组。读取时：
RecordStore rs = RecordStore.openRecordStore("thunder", true); if (rs.getNumRecords() > 0) { byte[] data = rs.getRecord(1); // recordId 从 1 开始 highScore = ((data[0] & 0xFF) << 8) | (data[1] & 0xFF); level = data[2]; } rs.closeRecordStore();逻辑说明：openRecordStore第二个参数 true 表示不存在就创建。getRecord的 id 从 1 开始，不是 0，这是血泪经验。高位在前还是低位在前取决于原版写法，移植前最好用旧设备或模拟器导出一份存档对比字节序，否则分数会变成乱码。
3. 把 MIDP 绘制搬到新宿主：Graphics 适配层怎么写
3.1 抽象一层 Graphics，别让业务代码直接依赖 MIDP
如果目标平台是安卓或桌面，最稳的做法不是重写游戏逻辑，而是写一个Graphics适配接口，把drawImage、drawRegion、setClip、drawString这些方法映射到新平台的画布上。业务代码只调适配层，这样原版逻辑几乎不用动。
public interface Gfx { void drawImage(Img img, int x, int y, int anchor); void drawRegion(Img img, int sx, int sy, int w, int h, int transform, int dx, int dy, int anchor); void setColor(int rgb); void fillRect(int x, int y, int w, int h); void drawString(String s, int x, int y, int anchor); void setClip(int x, int y, int w, int h); }逻辑说明：drawRegion是 J2ME 里做精灵动画的核心，它支持旋转和镜像（TRANS_MIRROR、TRANS_ROT90等）。适配到安卓时，用Matrix做变换；适配到桌面 Swing 时，用AffineTransform。anchor参数决定绘制锚点，常见值有Graphics.TOP | Graphics.LEFT、Graphics.HCENTER | Graphics.VCENTER，适配层要把它翻译成左上角坐标。
3.2 精灵图与 drawRegion 的坐标换算
原版游戏通常把飞机、敌机、爆炸帧打包成一张 PNG，用drawRegion按帧切。移植时最容易错的是源矩形坐标。假设精灵图每帧宽 24、高 24，第 n 帧的源坐标是(n % 列数) * 24和(n / 列数) * 24。适配层里要保证这个换算和原版一致，否则动画会串帧。
// 假设 sprite 是整张精灵图，frameW=24, frameH=24, cols=4 int sx = (frameIndex % cols) * frameW; int sy = (frameIndex / cols) * frameH; gfx.drawRegion(sprite, sx, sy, frameW, frameH, 0, screenX, screenY, Gfx.TOP | Gfx.LEFT);逻辑说明：frameIndex是当前动画帧号，cols是精灵图每行帧数。如果原版用了镜像，transform传TRANS_MIRROR，适配层要对应做水平翻转。参数上，screenX、screenY是屏幕坐标，注意原版可能用的是相对画布坐标，移植到不同分辨率时要加缩放系数。
3.3 分辨率适配：240×320 到全面屏的缩放策略
原版按 240×320 设计，新设备分辨率五花八门。常见做法是保持逻辑坐标 240×320，渲染时整体缩放并居中，两侧留黑边。这样游戏逻辑不用改，手感也一致。缩放系数取min(screenW / 240, screenH / 320)，然后用画布变换统一缩放。
float scale = Math.min(screenW / 240f, screenH / 320f); int offsetX = (int) ((screenW - 240 * scale) / 2); int offsetY = (int) ((screenH - 320 * scale) / 2); // 绘制前：translate(offsetX, offsetY); scale(scale, scale);逻辑说明：scale取较小值保证画面完整不裁切。offsetX、offsetY是居中偏移。注意触摸事件坐标要反向变换回逻辑坐标，否则按键区域会对不上。如果目标设备是横屏，还要考虑旋转 90 度，这时逻辑坐标和屏幕坐标的映射要重新算。
4. 按键映射与手感还原：从数字键盘到触摸和手柄
4.1 原版键值到新平台的映射表
J2ME 的按键常量是Canvas.KEY_NUM2、KEY_NUM4等，方向键对应 2/4/6/8，开火通常是 5 或软键。移植到安卓触摸时，常见做法是画一个虚拟摇杆加开火按钮，但手感会变。更稳的是保留方向键布局，用触摸区域映射。
| 原版键值 | 功能 | 安卓触摸区域 | 手柄映射 |
|---|---|---|---|
| KEY_NUM2 | 上 | 屏幕左下摇杆上 | 十字键上 |
| KEY_NUM4 | 左 | 摇杆左 | 十字键左 |
| KEY_NUM6 | 右 | 摇杆右 | 十字键右 |
| KEY_NUM8 | 下 | 摇杆下 | 十字键下 |
| KEY_NUM5 | 开火 | 右下圆形按钮 | A 键 |
| 左软键 | 暂停 | 顶部暂停图标 | Start |
逻辑说明：映射表要可配置，不同玩家习惯不同。触摸区域用矩形或圆形判定，按下时置位对应的keyState，抬起时清位。手柄映射用KeyEvent的keyCode判断，注意不同手柄的键值可能不同，要做兼容。
4.2 连发与按键去抖：为什么你的飞机总是慢半拍
原版游戏很多是按住开火键就自动连发，移植时如果只在keyPressed里发一颗子弹，按住不会连发。正确做法是在游戏循环里检查keyState，按固定间隔发射。
private boolean firePressed = false; private int fireCooldown = 0; // 在 updateGame() 里 if (firePressed) { if (fireCooldown <= 0) { spawnBullet(); fireCooldown = 6; // 每 6 帧一发，约 4 发/秒 } else { fireCooldown--; } } else { fireCooldown = 0; }逻辑说明：fireCooldown控制射速，值越小射速越快。原版如果是每帧一发，这个值设 1；如果是固定间隔，按原版帧率换算。按键去抖方面，触摸事件可能一次按下触发多次，要在keyPressed里判断状态是否已置位，避免重复触发。
4.3 触摸滑动的方向判定：别用简单的上下左右分区
虚拟摇杆如果只按上下左右四个矩形分区，斜向移动会很难受。常见做法是用角度判定：计算触摸点相对摇杆中心的角度，映射到 8 个方向或直接输出归一化向量。
float dx = touchX - centerX; float dy = touchY - centerY; float dist = (float) Math.sqrt(dx * dx + dy * dy); if (dist > deadZone) { float angle = (float) Math.atan2(dy, dx); // 按 45 度分区映射到 8 方向，或直接归一化 moveX = (float) Math.cos(angle); moveY = (float) Math.sin(angle); }逻辑说明：deadZone是死区半径，防止手指轻微抖动就触发移动。moveX、moveY是归一化方向向量，直接乘速度就是位移。如果原版只支持 4 方向，就把角度量化到最近的 90 度。注意触摸坐标要先从屏幕坐标反变换回逻辑坐标。
5. 移植避坑：那些让游戏跑不起来的常见问题
5.1 现象：游戏启动后黑屏，日志无报错
原因：startApp()里setCurrent之前就调了repaint()，或者Canvas的paint里抛了异常被吞掉。J2ME 的异常处理很弱，很多设备直接黑屏。
解决：在paint最外层包 try-catch，把异常打到控制台或文件。检查setCurrent是否在repaint之前调用。如果是适配层，确认Gfx实现类的初始化没有依赖还没创建的资源。
5.2 现象：子弹和敌机不同步，越玩越卡
原因：游戏循环里做了耗时操作，比如每帧都读 RMS 或加载图片。老设备 CPU 慢，这些操作会拖垮帧率。
解决：RMS 只在存档点读写，图片在startApp时一次性加载到内存。updateGame里只做坐标运算和碰撞检测，碰撞检测用简单的矩形相交，别用像素级检测。
5.3 现象：存档读出来分数是乱码或负数
原因：字节序搞反了，或者getRecord的 id 用错。J2ME 的RecordStoreid 从 1 开始，不是 0。
解决：用ByteArrayInputStream和DataInputStream按原版顺序读，别手动拼字节。如果原版是writeInt，就用readInt，别用readShort。移植前先用模拟器导出一份存档，对比字节。
5.4 现象：触摸开火按钮按了没反应，或者一直连发
原因：触摸事件的坐标没做反向变换，按钮判定区域对不上；或者keyPressed和keyReleased没配对，状态一直是按下。
解决：在触摸回调里先把屏幕坐标转成逻辑坐标，再判定按钮区域。用pointerPressed置位、pointerReleased清位，中间不要重复置位。如果用了多点触控，要跟踪每个 pointer 的 id。
5.5 现象：游戏在部分设备上闪退，日志显示 OutOfMemory
原因：精灵图太大，或者每帧创建临时对象导致 GC 频繁。J2ME 堆内存很小，移植到新平台虽然内存大了，但逻辑没改的话，频繁创建对象依然会卡。
解决：精灵图按需切分，别一次性加载整张大图。游戏循环里复用对象，子弹用对象池，别每发都new。如果目标平台是安卓，注意Bitmap的回收。
6. 进阶：用固定时间步长让移植版手感对齐原版
前面说的frameDelay是按帧睡眠，但新设备性能差异大，同样 40 毫秒，有的设备跑 25 帧，有的跑 20 帧，弹幕速度就不一样了。要让手感对齐，得用固定时间步长：逻辑更新按固定 dt 累加，渲染按实际帧率。
private static final long FIXED_DT = 40; // 逻辑步长，毫秒 private long accumulator = 0; private long lastTime = System.currentTimeMillis(); public void run() { while (running) { long now = System.currentTimeMillis(); long delta = now - lastTime; lastTime = now; if (delta > 200) delta = 200; // 防止切后台后一次性追帧 accumulator += delta; while (accumulator >= FIXED_DT) { updateGame(); // 固定步长更新 accumulator -= FIXED_DT; } repaint(); // 按实际帧率渲染 try { Thread.sleep(1); } catch (Exception e) {} } }逻辑说明：FIXED_DT是逻辑步长，设 40 毫秒对应原版 25 帧。accumulator累加实际经过的时间，每满一个步长就更新一次逻辑。delta上限 200 毫秒防止切后台回来一次性追太多帧导致卡顿。这样无论设备跑 30 帧还是 60 帧，游戏逻辑速度一致，弹幕密度和原版对齐。
验证方法：在游戏里加一个帧率显示，跑几分钟看逻辑帧率是否稳定在 25。如果波动大，检查updateGame里有没有耗时操作。另一个验证是录屏对比原版，看同一关的敌机出现时间和弹幕密度是否一致。
我自己的习惯是，移植任何老游戏前，先用模拟器跑一遍原版，录一段 30 秒的视频，然后移植版跑同样的 30 秒，逐帧对比。这个笨办法能发现 90% 的手感偏差。希望帮到你。
本文还有配套的精品资源，点击获取
