Răsfoiți Sursa

[Feat] [1.0.0] Add Readme

xcbosa mbp16 5 luni în urmă
părinte
comite
83624c3a59
2 a modificat fișierele cu 42 adăugiri și 23 ștergeri
  1. 16 23
      README
  2. 26 0
      README-buildroot

+ 16 - 23
README

@@ -1,26 +1,19 @@
-Buildroot is a simple, efficient and easy-to-use tool to generate embedded
-Linux systems through cross-compilation.
+# Python Code Develop PCDOS
 
-The documentation can be found in docs/manual. You can generate a text
-document with 'make manual-text' and read output/docs/manual/manual.text.
-Online documentation can be found at http://buildroot.org/docs.html
+PCDOS 是基于 BuildRoot 配置的最小 Linux 系统,仅包含运行 Python 所相关的动态库。  
+PCDOS 在 BuildRoot 的基础上,修改了 getty 程序,使其可以将终端重定向到 App 内。  
+PCDOS 在 BuildRoot 基础上新增的软件包代码采用 GPL 协议开源,未修改的原始代码按 BuildRoot 中原始软件包所规定的开源协议开源。
 
-To build and use the buildroot stuff, do the following:
+## 编译 RootFS
+> 目前 PCDOS 使用的自动发布流水线是运行 ARM Ubuntu 24.04 的 Apple MacMini M4 设备。维护者会保证在与流水线相同的操作系统环境中可以正常编译。  
+> M4 标准版真的很快,同样的代码在 14 核 E5 上全量编译需约 ~5h,在 M4 虚拟机上只需要 ~1h :)
 
-1) run 'make menuconfig'
-2) select the target architecture and the packages you wish to compile
-3) run 'make'
-4) wait while it compiles
-5) find the kernel, bootloader, root filesystem, etc. in output/images
-
-You do not need to be root to build or run buildroot.  Have fun!
-
-Buildroot comes with a basic configuration for a number of boards. Run
-'make list-defconfigs' to view the list of provided configurations.
-
-Please feed suggestions, bug reports, insults, and bribes back to the
-buildroot mailing list: buildroot@buildroot.org
-You can also find us on #buildroot on OFTC IRC.
-
-If you would like to contribute patches, please read
-https://buildroot.org/manual.html#submitting-patches
+产出 rootfs.tar 的完整编译脚本如下:
+```
+rm -rf output            # 删除缓存 (大部分时候增量编译的结果有问题)
+make -j10                # 编译和安装基本 BuildRoot
+chmod +x postbuild.sh    # 给 postbuild.sh 加执行权限
+./postbuild.sh           # 编译和安装 getty 等修改的软件包
+```
+目前 PCDOS 缺少 GNU-ToolChain 来支持其编译自身,也就是说您无法在 iPad 中直接完成源码编译,请使用独立的 Linux ARM 或 X86 系统编译 PCDOS。  
+我们很乐于看到您为 PCDOS 支持完整编译工具链提交的 PR,相关修改可能会在 Python Code Develop 的新版本中发布。

+ 26 - 0
README-buildroot

@@ -0,0 +1,26 @@
+Buildroot is a simple, efficient and easy-to-use tool to generate embedded
+Linux systems through cross-compilation.
+
+The documentation can be found in docs/manual. You can generate a text
+document with 'make manual-text' and read output/docs/manual/manual.text.
+Online documentation can be found at http://buildroot.org/docs.html
+
+To build and use the buildroot stuff, do the following:
+
+1) run 'make menuconfig'
+2) select the target architecture and the packages you wish to compile
+3) run 'make'
+4) wait while it compiles
+5) find the kernel, bootloader, root filesystem, etc. in output/images
+
+You do not need to be root to build or run buildroot.  Have fun!
+
+Buildroot comes with a basic configuration for a number of boards. Run
+'make list-defconfigs' to view the list of provided configurations.
+
+Please feed suggestions, bug reports, insults, and bribes back to the
+buildroot mailing list: buildroot@buildroot.org
+You can also find us on #buildroot on OFTC IRC.
+
+If you would like to contribute patches, please read
+https://buildroot.org/manual.html#submitting-patches