Skip to content

Commit d24f0cf

Browse files
RSARTE-176881: Updated build command for MacOS
1 parent f00fb4d commit d24f0cf

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

docs-sources/target-rts/build.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,17 @@ Follow these steps to build the TargetRTS from its sources:
1313
2. Make sure the unzipped folder, and everything it contains, is writable.
1414
3. From a command-line prompt with Perl in the PATH go into the `src` subfolder of the unzipped folder and invoke a command similar to the below:
1515

16+
```shell
17+
make PERL=perl CONFIG=MacT.AArch64-Clang-15.x
18+
```
19+
(this will build the TargetRTS for the MacOS ARM configuration that comes with {$product.name$})
20+
21+
If you have `rtperl` in the path, you can instead use this command:
22+
1623
``` shell
17-
perl Build.pl WinT.x64-MinGw-12.2.0 make all
24+
rtperl Build.pl WinT.x64-MinGw-12.2.0 make all
1825
```
26+
(this will build the TargetRTS for the MinGW 64 configuration that comes with {$product.name$})
1927

2028
The Perl script `Build.pl` drives the build process of the TargetRTS, but uses a make tool for the bulk of the work. The first argument to the script is the name of the [target configuration](index.md#target-configurations) to use. This is the same name as is specified with the TC property [`targetConfiguration`](../building/transformation-configurations.md#targetconfiguration). The second argument to the script is the make tool to use. It corresponds to the TC property [`makeCommand`](../building/transformation-configurations.md#makecommand). The final argument is a make target defined in the file `main.mk`. To build everything use the target `all`.
2129

@@ -36,6 +44,16 @@ Note that the default compiler flags in `LIBSETCCEXTRA` do not explicitly set th
3644
### Flat Builds
3745
The `Build.pl` script accepts an optional flag `-flat` which, if used, should be the first argument. This flag causes the script to concatenate all source files that belong to the same class into a single file (placed in the output folder), and then build those concatenated file. This significantly reduces the number of source files to compile and therefore often speeds up the build. But beware that when [debugging the TargetRTS](#debug), you will debug these concatenated files, rather than the original source code. Do not change the concatenated files as those changes will be lost the next time you build the TargetRTS with the `-flat` flag.
3846

47+
Below are the commands to use for doing flat builds, depending on if you use perl or rtperl:
48+
49+
```shell
50+
make PERL=perl BUILDOPTS=-flat CONFIG=MacT.AArch64-Clang-15.x
51+
```
52+
53+
```shell
54+
rtperl Build.pl -flat WinT.x64-MinGw-12.2.0 make all
55+
```
56+
3957
## Debug
4058
To be able to debug the TargetRTS, you need to build it with debug symbols included. Follow these steps (either in an existing target configuration, or in a new one you have created):
4159

0 commit comments

Comments
 (0)