Difference between revisions of "Building Modules"

From ReactOS Wiki
Jump to: navigation, search
(Downloading the Modules: Removed all the svn instructions and updated the text.)
Line 10: Line 10:
== Downloading the Modules ==
== Downloading the Modules ==
The following example will show how to download the "rostests" module. To download any other module follow the same steps but using the name of the desired module.
There is now no need to download the modules separately, because they will be included in the cloned source and are located in '''\reactos\modules'''. See also  ([https://reactos.org/wiki/ReactOS_Git_For_Dummies#Cloning_the_repository Cloning the repository])
==== Step 1 ====
Find the <tt>reactos\modules</tt> (Windows) or <tt>reactos/modules</tt> (Unix) folder
==== Step 2 ====
As we want to download the "rostests" module create a folder named <tt>rostests</tt>.
==== Step 3 ====
Right click in that new folder and select checkout("SVN Checkout..")
==== Step 4 ====
The "URL of repository" of "rostest" is:  svn://svn.reactos.org/reactos/trunk/rostests
==== Step 5 ====
Hit OK. It'll begin downloading the needed files. Compile as usual and you'll have the modules integrated in the ISO.
If you want to download the ''rosapps'' or ''wallpaper'' module, just create a <tt>rosapps</tt> or <tt>wallpapers</tt> folder inside
<tt>reactos/modules</tt> and use the following links as the URL of repository:
* Rosapps: svn://svn.reactos.org/reactos/trunk/rosapps
* Wallpaper: svn://svn.reactos.org/reactos/trunk/wallpapers
== List available ninja targets ==
== List available ninja targets ==

Revision as of 08:22, 4 March 2021

There are many applications, tests, and extra subsystems in the ReactOS SVN. We don't include them because they're usually not part of everyday's development/testing/use.

Available Modules

We currently have the following modules in the SVN Tree:

  • rosapps – Various non-core applications, like additional screensavers, devutils and cmdutils.
  • rostests - Home of our testing framework (Winetests and Rostests), which includes API conformance tests (both usermode and kernelmode APIs), plus the automatic application testing suite (based on AutoHotkey)
  • wallpapers – Several wallpapers for ReactOS Desktop.

Downloading the Modules

There is now no need to download the modules separately, because they will be included in the cloned source and are located in \reactos\modules. See also (Cloning the repository)

List available ninja targets

To list available targets do:

ninja -t targets


ninja -t targets >target_list

Select from there target for build or clean:

ninja <target1>_clean
ninja <target1>

Removing or Updating a Module

If you remove a Module folder after CMake picks it up, it will not notice, until you tell it to reconfigure.

The reconfigure command depends on the Build System you are using.

With ninja do:

ninja rebuild_cache

For other build systems use:

nmake rebuild_cache


make rebuild_cache

Technical information

In the reactos/modules or reactos\modules folder, depending on whether you're on a UNIX or Windows system, there is a file called directory.cmake.

The Build system will read the directory.cmake file and look if the subfolders named in this file exist. If a folder exists, the Build System will process its directory.cmake file. This way the folder gets integrated into the building process.