]> glassweightruler.freedombox.rocks Git - Ventoy.git/blobdiff - DOC/BuildVentoyFromSource.txt
Fix the "Unsupported vtoy type unknown" error when boot a VDI file created by Virtual...
[Ventoy.git] / DOC / BuildVentoyFromSource.txt
index 37a07c5bea7f8d0dc755b06cfe3231e0298ce217..b9c13aa9a199655f5aa8c75b9e9b6f7e98b7b60a 100644 (file)
@@ -3,7 +3,7 @@
 1. Compile Environment\r
 ==========================================\r
     My build environment is CentOS 7.8 x86_64. So here I first explain how to create the build environment from scratch.\r
-    Because Ventoy is based on many open source projects, so the environment is important. I suggest you test it on a virtual machine firstly.\r
+    Ventoy is based on many open source projects, so the build environment is important. I suggest you first test it on a virtual machine.\r
 \r
 1.1 Install CentOS 7.8\r
     I use CentOS-7-x86_64-Everything-2003.iso and select Minimal install\r
 ==========================================\r
 2. Download Source Code\r
 ==========================================\r
-2.1 Download Ventoy source code from github and decompress it. \r
+2.1 Download Ventoy source code from GitHub and decompress it. \r
     Next I assume that you have unzipped the code into the /home directory (check /home/Ventoy-master/README.md file for the directory layout).\r
     \r
-2.2 Download third-part source code and tool\r
+2.2 Download third-party source code and tool\r
     \r
     https://www.fefe.de/dietlibc/dietlibc-0.34.tar.xz                    ===>  /home/Ventoy-master/DOC/dietlibc-0.34.tar.xz\r
     https://musl.libc.org/releases/musl-1.2.1.tar.gz                     ===>  /home/Ventoy-master/DOC/musl-1.2.1.tar.gz\r
@@ -34,7 +34,7 @@
     https://codeload.github.com/libfuse/libfuse/zip/fuse-2.9.9           ===>  /home/Ventoy-master/ExFAT/libfuse-fuse-2.9.9.zip\r
     https://releases.linaro.org/components/toolchain/binaries/7.4-2019.02/aarch64-linux-gnu/gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu.tar.xz           ===>  /opt/gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu.tar.xz\r
     https://toolchains.bootlin.com/downloads/releases/toolchains/aarch64/tarballs/aarch64--uclibc--stable-2020.08-1.tar.bz2 ===> /opt/aarch64--uclibc--stable-2020.08-1.tar.bz2\r
-    http://ftp.loongnix.cn/toolchain/gcc/release/mips/gcc7/mips-loongson-gcc7.3-2019.06-29-linux-gnu.tar.gz ===> /opt/mips-loongson-gcc7.3-2019.06-29-linux-gnu.tar.gz    \r
+    https://github.com/ventoy/vtoytoolchain/releases/download/1.0/mips-loongson-gcc7.3-2019.06-29-linux-gnu.tar.gz ===> /opt/mips-loongson-gcc7.3-2019.06-29-linux-gnu.tar.gz\r
     https://github.com/ventoy/musl-cross-make/releases/download/latest/output.tar.bz2 ===> /opt/output.tar.bz2\r
 \r
 \r
@@ -42,7 +42,7 @@
     http://www.tinycorelinux.net/11.x/x86_64/release/distribution_files/corepure64.gz ===> /home/Ventoy-master/LiveCD/ISO/EFI/boot/corepure64.gz\r
     http://www.tinycorelinux.net/11.x/x86_64/release/distribution_files/modules64.gz ===> /home/Ventoy-master/LiveCD/ISO/EFI/boot/modules64.gz    \r
 \r
-2.3 Prepare third-part tools\r
+2.3 Prepare third-party tools\r
     cd /home/Ventoy-master/DOC/\r
     tar xf musl-1.2.1.tar.gz\r
     cd musl-1.2.1\r
 ==========================================\r
 3. All in one script\r
 ==========================================\r
-    I have made a all_in_one.sh, you can run this script to build and pack ventoy.\r
+    I have made an all-in-one script `all_in_one.sh`. You can run this script to build and pack ventoy.\r
     If you want to compile a certain part separately, you can continue to refer to the later chapters of this text.\r
     \r
     cd /home/Ventoy-master/INSTALL\r
     sh all_in_one.sh\r
 \r
     It should be noted that:\r
-    1. Only grub2/EDK2/IPXE will be recompiled in all_in_one.sh. Other part contains the binaries and are few modified, so will no be recompiled everytime.\r
+    1. Only grub2/EDK2/IPXE will be recompiled in all_in_one.sh. Other parts contain binaries and are rarely modified, so will not be recompiled everytime.\r
        You can rebuild these parts separately if you want.\r
        \r
-    2. some part of Ventoy has 32bit&64bit version (like 4.9 4.10 4.11 follows)\r
-       all_in_one.sh only build 64bit version of them, if you want to rebuild the 32bit verison. You should create a 32bit CentOS environment and build them.\r
-       Fortunately these parts are few modified, you only need to build once or you can directly use the binary I have built.\r
+    2. Some parts of Ventoy have a 32-bit and 64-bit version (like 4.9, 4.10, 4.11 follows)\r
+       all_in_one.sh only builds the 64bit version of them. If you want to rebuild the 32bit verison, you should create a 32-bit CentOS environment and build them.\r
+       Fortunately these parts are rarely modified, so you only need to build once or you can directly use the binaries I have built.\r
 \r
-    Besides, after a fully compile and pack, you can only build the part you modified (for example grub2) and run ventoy_pack.sh to generate the package.\r
+    Besides, after a full compile and packaging, you can only build the part you modified (for example grub2) and run ventoy_pack.sh to generate the package.\r
 \r
 ==========================================\r
 4. Build every part of Ventoy\r
     After that, copy EXFAT/shared/mkexfatfs         ===> /home/Ventoy-master/INSTALL/tool/mkexfatfs_64\r
     After that, copy EXFAT/shared/mount.exfat-fuse  ===> /home/Ventoy-master/INSTALL/tool/mount.exfat-fuse_64\r
 \r
-    Use the same build step to build exfat-util 32bit in a 32bit CentOS system and get mkexfatfs_32 and mount.exfat-fuse_32\r
+    Use the same build step to build exfat-util 32-bit in a 32-bit CentOS system and get mkexfatfs_32 and mount.exfat-fuse_32\r
 \r
 4.10 == Build vtoy_fuse_iso_64/vtoy_fuse_iso_32 ==\r
     cd /home/Ventoy-master/FUSEISO\r
     sh build_libfuse.sh\r
     sh build.sh\r
     \r
-    Use the same build step to build in a 32bit CentOS system and get vtoy_fuse_iso_32\r
+    Use the same build step to build in a 32-bit CentOS system and get vtoy_fuse_iso_32\r
    \r
 4.11 == Build unsquashfs_64/unsquashfs_32 ==\r
     cd /home/Ventoy-master/SQUASHFS/SRC\r
     cd /home/Ventoy-master/SQUASHFS/squashfs-tools-4.4/squashfs-tools\r
     sh build.sh\r
     \r
-    Use the same build step to build in a 32bit CentOS system and get unsquashfs_32\r
+    Use the same build step to build in a 32-bit CentOS system and get unsquashfs_32\r
    \r
 4.12 == Build vblade_64/vblade_32 ==\r
     cd /home/Ventoy-master/VBLADE/vblade-master\r