EKA2L1 项目安装与使用教程

1. 项目目录结构及介绍

EKA2L1 是一个 Symbian OS/N-Gage 模拟器，其项目目录结构如下：

EKA2L1/
├── cmake/
├── miscs/
├── natives/
├── screenshots/
├── scripts/
├── src/
├── .clang-format
├── .gitignore
├── .gitmodules
├── BUILDING.md
├── CMakeLists.txt
├── Doxyfile
├── LICENSE
├── README.md
├── changelog.txt
├── clang-format-all.sh
├── crowdin.yml
├── format.bat

目录介绍

• cmake/: 包含 CMake 构建脚本和配置文件。
• miscs/: 包含项目的一些杂项文件。
• natives/: 包含与平台相关的本地代码。
• screenshots/: 包含项目的截图文件。
• scripts/: 包含项目的脚本文件，用于自动化任务。
• src/: 包含项目的主要源代码。
• .clang-format: 用于代码格式化的配置文件。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置。
• BUILDING.md: 构建项目的说明文档。
• CMakeLists.txt: CMake 主配置文件。
• Doxyfile: Doxygen 文档生成配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• changelog.txt: 项目更新日志。
• clang-format-all.sh: 用于格式化所有代码的脚本。
• crowdin.yml: Crowdin 翻译平台配置文件。
• format.bat: Windows 平台下的代码格式化脚本。

2. 项目启动文件介绍

EKA2L1 的启动文件主要位于 src/ 目录下，其中包含主要的模拟器逻辑和功能实现。以下是一些关键的启动文件：

• src/main.cpp: 主程序入口文件，负责初始化模拟器并启动 Symbian OS 的模拟。
• src/kernel/kernel.cpp: 模拟 Symbian OS 内核的实现文件。
• src/emu/emu.cpp: 模拟器核心逻辑的实现文件。

3. 项目配置文件介绍

EKA2L1 的配置文件主要用于项目的构建和代码格式化。以下是一些关键的配置文件：

• CMakeLists.txt: 用于配置 CMake 构建系统，定义项目的构建目标和依赖关系。
• .clang-format: 用于配置 Clang-Format 工具，定义代码格式化的规则。
• Doxyfile: 用于配置 Doxygen 文档生成工具，定义文档生成的规则和输出格式。

配置文件示例

CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(EKA2L1)

set(CMAKE_CXX_STANDARD 17)

add_subdirectory(src)
add_subdirectory(cmake)

.clang-format

Language: Cpp
BasedOnStyle: LLVM
IndentWidth: 4
ColumnLimit: 120

Doxyfile

PROJECT_NAME           = "EKA2L1"
OUTPUT_DIRECTORY       = docs
GENERATE_LATEX         = NO
GENERATE_HTML          = YES

通过以上配置文件，可以确保项目的构建、代码格式化和文档生成按照预期进行。