|
|
| (5 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | The ReactOS Release Engineer, are doing work concerning Releases, as bugging developers about changelogs, branch from trunk, applying some hacks to releases, which are not present in trunk. | + | The ReactOS Release Engineers are responsible for creating and publishing ReactOS releases along with all relevant resources (changelogs, information pages, etc.) |
| | | | |
| − | = Current Release Engineers = | + | == Current Release Engineers == |
| | * [[Colin Finck]] | | * [[Colin Finck]] |
| | * [[Ziliang Guo]] | | * [[Ziliang Guo]] |
| | | | |
| − | = Packaging ReactOS Releases =
| + | == Further information == |
| − | == Conventions == | + | * [[ReactOS Release Engineer/Step-by-Step Guide|Step-by-Step Guide about creating a ReactOS release]] |
| − | Replace ''%VERSION%'' with the version number of the ReactOS Release (e.g. 0.3.1)<br>
| + | * [[ReactOS Release Engineer/Packaging ReactOS Releases|Packaging ReactOS Releases]] |
| − | I assume that you run a multiprocessor system for compiling ReactOS and use TortoiseSVN for SVN work.<br>
| |
| − | All instructions for creating ZIP files are explained using the <u>Info-ZIP</u> <code>zip</code> command line utility.<br>
| |
| | | | |
| − | == Preparations ==
| |
| − | Now get a checkout of the reactos subdirectory of the ReactOS Release branch (URL is usually ''svn://svn.reactos.org/reactos/branches/ros-branch-X_Y_Z/reactos'') by using the SVN Checkout feature of TortoiseSVN.<br>
| |
| − | As of now (2008-08-23), we also integrate the following modules into a release:
| |
| − | * '''rosapps''' (''svn://svn.reactos.org/reactos/branches/ros-branch-X_Y_Z/rosapps'')
| |
| − | * '''wallpaper''' (''svn://svn.reactos.org/reactos/branches/ros-branch-X_Y_Z/wallpaper'')
| |
| − | Check out these modules into the ''modules'' subdirectory of the checked out ReactOS Release branch.<br>
| |
| − | Now we're ready for creating the packages.
| |
| | | | |
| − | == Creating the Packages ==
| + | {{Project positions}} |
| − | The following packages need to be created for a ReactOS Release:
| + | [[Category:Community]] |
| | | | |
| − | === ReactOS-%VERSION%-REL-iso.zip ===
| + | [[Category:ReactOS_Foundation]] |
| − | This package contains the ISO file for the ReactOS Installation on a hard disk. Most users will download this file.<br>
| |
| − | | |
| − | Creating this package:<br>
| |
| − | '''1.''' Open the ''config.rbuild'' file with a text editor.<br>
| |
| − | '''2.''' Open RosBE and enter the following commands to create the ISO file:<br>
| |
| − | | |
| − | clean
| |
| − | makex bootcd
| |
| − | | |
| − | '''3.''' Create a ZIP file, which only contains the created ''ReactOS.iso'' file:<br>
| |
| − | | |
| − | zip ReactOS-%VERSION%-REL-iso.zip ReactOS.iso
| |
| − | | |
| − | === ReactOS-%VERSION%-REL-live.zip ===
| |
| − | This package contains the ReactOS-LiveCD. It is built using the same settings, which were used for building the BootCD (see above).<br>
| |
| − | | |
| − | Creating this package:<br>
| |
| − | '''1.''' Type the following command into the same development environment used to create the ''[[#ReactOS-%VERSION%-REL-iso.zip|ReactOS-%VERSION%-REL-iso.zip]]'' package:<br>
| |
| − | | |
| − | makex livecd
| |
| − | | |
| − | '''2.''' Create a ZIP file, which only contains the created ''ReactOS-LiveCD.iso'' file:<br>
| |
| − | | |
| − | zip ReactOS-%VERSION%-REL-live.zip ReactOS-LiveCD.iso
| |
| − | | |
| − | === ''ReactOS''-'''%VERSION%'''-''REL-src.zip'' ===
| |
| − | This package contains the source code of the ReactOS release.<br>
| |
| − | | |
| − | Creating this package:<br>
| |
| − | '''1.''' Create a directory called ReactOS-%VERSION%.<br>
| |
| − | '''2.''' Right-click this directory, choose the ''TortoiseSVN'' entry and click on ''Export''. Then enter the URL to the ''reactos'' subdirectory of the branch and click on ''OK''.<br>
| |
| − | This way, we get the source files of this branch without the ''.svn'' directories.<br>
| |
| − | Also export all modules integrated into this ReactOS Release into the ''modules'' subdirectory of the exported ''reactos'' directory (see [[#Preparations|Preparations] for more details).<br>
| |
| − | '''3.''' Create a ZIP file, which contains this directory. Do not forget to activate the option to store the relative path names:<br>
| |
| − | | |
| − | zip -r ReactOS-%VERSION%-REL-src.zip ReactOS-%VERSION%
| |
| − | | |
| − | === ReactOS-%VERSION%-REL-qemu.zip ===
| |
| − | This package contains a preinstalled Debug build of ReactOS in a QEMU virtual machine along with QEMU for Windows.<br>
| |
| − | | |
| − | Creating this package:<br>
| |
| − | '''1.''' Copy the files from the subdirectory ''VM-Templates\QEMU'' into a directory called ''ReactOS-''%VERSION%''-QEMU''.
| |
| − | '''2.''' Download an up to date QEMU build for Windows from [http://www.h7.dion.ne.jp/~qemu-win/].<br>
| |
| − | '''NOTE:''' As of now (2008-08-23), I recommend using the official QEMU 0.9.0 build in favor of newer versions. Newer ones experience problems under Windows Vista.<br>
| |
| − | '''3.''' Put the QEMU program files in the files subdirectory of the ReactOS-%VERSION%-QEMU directory, including the QEMU ''files'' subdirectories.<br>
| |
| − | '''4.''' Remove alternative architecture versions, all HTML files, the Linux stuff, the PXE stuff, alternative BIOS files, all BAT files and the QEMU Readme's from the ''files'' directory.<br>
| |
| − | | |
| − | For QEMU 0.9.0, this leads to the following files remaining:
| |
| − | * ''keymaps'' subdirectory (unmodified)
| |
| − | * ''License'' subdirectory (unmodified)
| |
| − | * ''bios.bin''
| |
| − | * ''fmod.dll''
| |
| − | * ''libusb0.dll''
| |
| − | * ''qemu.exe''
| |
| − | * ''qemu-img.exe''
| |
| − | * ''SDL.dll''
| |
| − | * ''vgabios-cirrus.bin''
| |
| − | | |
| − | This exact list might change for future QEMU versions, so better adhere to the general list of unneeded files above.<br>
| |
| − | '''5.''' Use the following command to create the virtual hard disk:<br>
| |
| − | | |
| − | qemu-img create -f vmdk ReactOS.vmdk 2G
| |
| − | | |
| − | '''6.''' Copy the ''ReactOS.iso'' file created for the package ''ReactOS-%VERSION%-REL-iso.zip'' into the files subdirectory and run ''install.bat'' to install it.<br>
| |
| − | '''7.''' Remove the ''ReactOS.iso'' and ''install.bat'' files.<br>
| |
| − | '''8.''' Create a ZIP file, which contains this directory. Do not forget to activate the option to store the relative path names:<br>
| |
| − | | |
| − | zip -r ReactOS-%VERSION%-REL-qemu.zip ReactOS-%VERSION%-QEMU
| |
| − | | |
| − | === ReactOS-%VERSION%-REL-vmware.zip ===
| |
| − | This package contains a preinstalled Release version of ReactOS in a VMware virtual machine. The virtual machine is compatible with VMware Workstation 4.5 or later and all free VMware products.<br>
| |
| − | | |
| − | Creating this package:<br>
| |
| − | '''1.''' Copy the files in the subdirectory ''VM-Templates\VMware'' into a directory called ''ReactOS-%VERSION%-VMware''.<br>
| |
| − | '''2.''' Copy the ''ReactOS.iso'' file created for the package ''[[#ReactOS-%VERSION%-REL-iso.zip|ReactOS-%VERSION%-REL-iso.zip]]'' into this directory.<br>
| |
| − | '''3.''' Open the ''ReactOS-Installation.vmx'' file in your VMware product, click on ''Edit virtual machine settings'' and on ''Add''.<br>
| |
| − | '''4.''' Add a new hard disk called ''ReactOS.vmdk'' with 2 GB size and in a growable format (deselect ''Allocate all disk space'' now).<br>
| |
| − | '''5.''' Remove the just created ''Hard Disk 2'' entry as we already have a ''Hard Disk'' entry, which now uses the created file.<br>
| |
| − | '''6.''' Start the virtual machine and install ReactOS on it.<br>
| |
| − | '''7.''' Remove all files in this directory except ''ReactOS.vmx'', ''ReactOS.vmdk'' and ''Readme.txt''<br>
| |
| − | '''8.''' Create a ZIP file, which contains the ''ReactOS-%VERSION%-VMware'' directory. Do not forget to activate the option to store the relative path names:<br>
| |
| − | | |
| − | zip -r ReactOS-%VERSION%-REL-vmware.zip ReactOS-%VERSION%-VMware
| |
