FreeJ2ME 项目使用教程
项目地址: https://gitcode.com/gh_mirrors/fr/freej2me 1. 项目目录结构及介绍
FreeJ2ME 是一个开源的 J2ME 模拟器，支持 libretro、AWT 和 SDL2 前端。项目的目录结构如下：
freej2me/
├── META-INF/
├── resources/
│ └── org/
│ └── recompile/
├── src/
│ ├── libretro/
│ ├── sdl2/
│ └── ...
├── .gitignore
├── KEYMAP.md
├── LICENSE
├── README.md
└── build.xml
目录结构介绍
- META-INF/: 包含项目的元数据文件。
- resources/: 包含项目所需的资源文件。
- src/: 包含项目的源代码，分为 libretro 和 SDL2 两个子目录。
- .gitignore: Git 忽略文件，指定哪些文件或目录不需要被版本控制。
- KEYMAP.md: 按键映射说明文件。
- LICENSE: 项目的开源许可证文件。
- README.md: 项目的主说明文件。
- build.xml: Ant 构建脚本文件。
2. 项目启动文件介绍
FreeJ2ME 提供了三种不同的启动方式，分别对应不同的前端：
2.1 AWT 前端
启动 AWT 前端的文件是 freej2me.jar。可以通过以下命令启动：
java -jar freej2me.jar 'file:///path/to/midlet.jar' [width] [height] [scale]
其中：
file:///path/to/midlet.jar是你要运行的 J2ME 应用程序的路径。width和height是模拟屏幕的宽度和高度（可选）。scale是窗口的初始缩放因子（可选）。
2.2 SDL2 前端
启动 SDL2 前端的文件是 freej2me-sdl.jar。可以通过以下命令启动：
java -jar freej2me-sdl.jar 'file:///path/to/midlet.jar' [width] [height]
其中：
file:///path/to/midlet.jar是你要运行的 J2ME 应用程序的路径。width和height是模拟屏幕的宽度和高度（可选）。
2.3 Libretro 前端
启动 Libretro 前端的文件是 freej2me-lr.jar，需要将其放置在 libretro 前端的 system/ 目录下。Libretro 核心文件 freej2me_libretro.so（Linux）或 freej2me_libretro.dll（Windows）需要放置在 libretro 前端的 cores/ 目录下。
3. 项目配置文件介绍
FreeJ2ME 的配置文件通常位于项目的根目录下，主要包括以下几个文件：
3.1 build.xml
build.xml 是 Ant 构建脚本文件，用于编译和打包项目。可以通过以下命令进行编译：
cd freej2me/
ant
编译后会生成三个不同的 JAR 文件：
freej2me.jar: 独立的 AWT 前端可执行文件。freej2me-lr.jar: Libretro 可执行文件。freej2me-sdl.jar: SDL2 前端可执行文件。
3.2 KEYMAP.md
KEYMAP.md 文件包含了按键映射的说明，介绍了如何在不同的前端中使用键盘控制模拟器。
3.3 README.md
README.md 是项目的主说明文件，包含了项目的概述、使用方法、编译步骤等信息。
3.4 LICENSE
LICENSE 文件包含了项目的开源许可证信息，说明项目的使用条款和条件。
通过以上介绍，你可以更好地理解和使用 FreeJ2ME 项目。