Java 桌面遊戲移植 Android：核心差異在繪圖機制（Paint vs Canvas）

核心結論

Java 桌面（Swing/AWT）與 Android 遊戲移植的最大障礙是繪圖機制完全不同：

• Java 桌面：java.awt.Graphics / Graphics2D，配合 paintComponent(Graphics g) 回調
• Android：android.graphics.Canvas，配合 onDraw(Canvas canvas) 或 SurfaceView / TextureView 主動繪製

關鍵 API 對照表

移植策略建議

1. 分離遊戲邏輯與渲染：核心邏輯（碰撞、物理、狀態機）保持純 Java/Kotlin，不依賴平台 API
2. 建立渲染介面介面：

   interface Renderer {
       void drawImage(Image img, float x, float y);
       void drawText(String text, float x, float y);
       // ...
   }
   

3. 分別實作：Java2DRenderer 給桌面，CanvasRenderer 給 Android
4. 輸入處理抽象化：鍵盤/滑鼠 → 觸控/手勢，統一為 InputEvent

推薦架構：LibGDX 等跨平台框架

若專案較大，建議直接使用 LibGDX：

• 單一代碼庫支援 Desktop、Android、iOS、Web
• 統一 API：SpriteBatch、Texture、InputProcessor 等
• 內建物理引擎、粒子系統、UI 框架

手動移植最小範例

// 共用邏輯
class GameEngine {
    void update(float delta) { /* 物理、AI、狀態 */ }
    void render(Renderer r) { /* 呼叫 r.draw*() */ }
}

// Android 實作
class GameView extends SurfaceView implements Runnable, Renderer {
    Canvas canvas;
    Paint paint = new Paint();
    // 實作 Renderer 介面方法...
    @Override public void drawImage(Image img, float x, float y) {
        canvas.drawBitmap(((AndroidImage)img).bmp, x, y, paint);
    }
    // 遊戲迴圈在 run() 中：lockCanvas → engine.render(this) → unlockCanvasAndPost
}

總結

Java 到 Android 遊戲移植核心是「Paint 換 Canvas」，但架構分離才是長久之計。小專案可手動抽象渲染層；中大型專案強烈建議遷移至 LibGDX 等成熟跨平台框架，避免重複造輪子並獲得效能優化。