概述

总是会被问道，失去源码了，我该如何上手？我想应用某某组件，我该如何疾速把它给用起来？我没有板子，想先相熟下代码，我该怎么办？我想在某块板子上把零碎跑起来，我又该怎么办？等等，各种各种的问题。

当第一次面对不相熟的货色，兴许咱们都会有着些许蛊惑。而疾速上手篇就是因解惑而生的，目标就是为了第一次拿到咱们的OneOS-Lite时，开发者们心中能多一份从容与淡定。

初见OneOS-Lite

在用Keil模拟器运行 STM32F103 示例工程代码时，咱们有必要先初步理解一下OneOS-Lite操作系统。进入到OneOS-Lite操作系统代码根目录下，咱们能够看到有多个文件夹和文件，如下图：

各个目录或文件的作用形容见下表。

目录或文件名称形容
arch寄存和 MCU（或 CPU ）架构体系相干的代码。
components寄存组件代码，可进行裁剪。
docs寄存一些文档，如疾速上手、开发工具应用等。
drivers寄存驱动的形象层代码和具体外设的驱动代码。
kernel寄存内核代码，如工作治理及调度、工作间同步以及通信、内存治理等代码。
projects各种开发板的示例工程
scripts寄存OneOS-Cube工具在编译结构时所须要的脚本文件。
_sidebar.mdLite版本文档索引
index.html本地文档网页浏览
KconfigMenuconfig配置文件，代码工程（如projects目录下的示例工程）中的Kconfig文件会援用此文件
SConscriptOneOS-Lite操作系统应用Scons构建工具时的根编译脚本，该脚本会援用其它目录的SConscript脚本，若在OneOS-Lite操作系统根目录减少新的代码目录，须要批改此文件。
LICENSELicense 受权阐明。

代码&&文档

OneOS-Lite仓库，不仅仅是代码仓库，同时也是一份文档仓库。docs目录寄存着疾速上手、开发工具应用等文档。而在代码的目录下，也均放有相干的帮忙手册README.md。这样搁置的益处在于，在拉取代码的同时，文档也一并被拉取。浏览代码的同时，能够查阅文档，辅助代码开发，事倍功半有奇效。

根目录下的_coverpage.md、_sidebar.md、index.html则是帮忙咱们用于生成网页。应用办法能够查看根目录的README.md。

开发第一步

拿到代码，开发的第一步就是，编译运行！这时，咱们须要进入projects目录，这里寄存着各种开发板的工程项目。如果你有开发板，你能够在外面抉择对应的开发板工程项目，进入其中。这里以咱们的万耦开发板stm32l475-cmcc-oneos为例。

应用OneOS cube（在应用该工具时，记得先装置好噢），输出命令menuconfig进行配置（如果对配置不相熟，能够先应用默认配置），最初输出命令scons进行编译。

如果你应用gcc，将编译生成elf文件，你能够在根目录下的out文件夹中找到她。

如果你应用mdk，你能够应用命令scons --ide=mdk5来生成mdk的我的项目工程，而后应用mdk进行编译。

如果你没有开发板，倡议应用stm32f103rc，来让Keil模仿STM32F103，以此来相熟咱们的rtos物联网零碎。详情可见Keil模仿STM32F103体验。