Banan-os 开源项目教程

Banan-os 开源项目教程

banan-os Mirror of banan-os, my hobby operating system 项目地址: https://gitcode.com/gh_mirrors/ba/banan-os

1. 项目的目录结构及介绍

Banan-os 是一个用 C++ 编写的爱好操作系统，支持 x86_64 和 i686 架构。以下是项目的目录结构及各部分的简要介绍：

• assets/: 存储项目的一些资源文件，如图标、字体等。
• bootloader/: 包含引导加载程序的代码，支持自定义 BIOS 引导加载程序和 UEFI 引导加载程序。
• kernel/: 操作系统的核心部分，包括内存管理、进程管理、文件系统等。
• ports/: 包含各种硬件设备的驱动程序，如硬盘、网络适配器等。
• script/: 存储一些脚本文件，用于编译、运行和调试操作系统。
• toolchain/: 包含构建操作系统所需的工具链，如编译器、链接器等。
• userspace/: 包含用户空间的应用程序和库，如命令行工具、图形界面等。
• .clangd/: 用于 Clang 语言服务器的配置文件。
• .gitignore: 指定 Git 忽略的文件和目录。
• .gitmodules: 包含子模块的信息。
• .pre-commit-config.yaml: 配置 pre-commit 钩子，用于代码提交前的格式化和检查。
• CMakeLists.txt: CMake 的配置文件，用于构建项目。
• LICENSE: 项目的许可证文件，采用 BSD-2-Clause 协议。
• README.md: 项目的说明文件，包含项目的基本信息和构建、运行指南。

2. 项目的启动文件介绍

项目的启动文件包括引导加载程序和内核的入口点。以下是简要介绍：

• bootloader/: 包含引导加载程序的代码，负责加载内核映像到内存并跳转到内核入口点。
• kernel/entry.cpp: 包含内核的入口点 start_kernel() 函数，是操作系统启动后执行的第一段代码。

3. 项目的配置文件介绍

项目的配置文件主要用于定义编译选项、工具链路径和项目特定的变量。以下是简要介绍：

• toolchain/Makefile: 工具链的 Makefile 文件，定义了编译器和链接器的路径等信息。
• CMakeLists.txt: CMake 的配置文件，定义了项目的构建过程和依赖关系。可以通过修改此文件来调整编译选项和项目设置。

在构建项目之前，确保已经安装了所需的依赖包和工具链，然后按照以下步骤编译和运行项目：

./bos toolchain  # 构建工具链（只需执行一次）
./bos kernel     # 编译内核
./bos image      # 创建磁盘映像
./bos qemu       # 在 QEMU 模拟器中运行操作系统

按照以上步骤，你就可以开始探索 Banan-os 的功能了。祝你学习愉快！

banan-os Mirror of banan-os, my hobby operating system 项目地址: https://gitcode.com/gh_mirrors/ba/banan-os