3 # resolve python-version to use
4 if [ "$PYTHON" == "" ] ; then
5 if ! PYTHON=$(command -v python || command -v python2 || command -v python 2.7)
7 echo "Unable to locate build-dependency python2.x!" 1>&2
12 # validate python-dependency
13 # useful in case of explicitly set option.
14 if ! command -v $PYTHON > /dev/null
16 echo "Unable to locate build-dependency python2.x ($PYTHON)!" 1>&2
22 echo "Usage: $0 [BuildArch] [BuildType] [verbose] [coverage] [cross] [clangx.y] [ninja] [configureonly] [skipconfigure] [skipnative] [skipmscorlib] [skiptests] [cmakeargs] [bindir]"
23 echo "BuildArch can be: x64, x86, arm, armel, arm64"
24 echo "BuildType can be: debug, checked, release"
25 echo "coverage - optional argument to enable code coverage build (currently supported only for Linux and OSX)."
26 echo "ninja - target ninja instead of GNU make"
27 echo "clangx.y - optional argument to build using clang version x.y."
28 echo "cross - optional argument to signify cross compilation,"
29 echo " - will use ROOTFS_DIR environment variable if set."
30 echo "crosscomponent - optional argument to build cross-architecture component,"
31 echo " - will use CAC_ROOTFS_DIR environment variable if set."
32 echo "pgoinstrument - generate instrumented code for profile guided optimization enabled binaries."
33 echo "configureonly - do not perform any builds; just configure the build."
34 echo "skipconfigure - skip build configuration."
35 echo "skipnative - do not build native components."
36 echo "skipmscorlib - do not build mscorlib.dll."
37 echo "skiptests - skip the tests in the 'tests' subdirectory."
38 echo "skipnuget - skip building nuget packages."
39 echo "portableLinux - build for Portable Linux Distribution"
40 echo "verbose - optional argument to enable verbose build output."
41 echo "-skiprestore: skip restoring packages ^(default: packages are restored during build^)."
42 echo "-disableoss: Disable Open Source Signing for System.Private.CoreLib."
43 echo "-sequential: force a non-parallel build ^(default is to build in parallel"
44 echo " using all processors^)."
45 echo "-officialbuildid=^<ID^>: specify the official build ID to be used by this build."
46 echo "-Rebuild: passes /t:rebuild to the build projects."
47 echo "skipgenerateversion - disable version generation even if MSBuild is supported."
48 echo "cmakeargs - user-settable additional arguments passed to CMake."
49 echo "bindir - output directory (defaults to $__ProjectRoot/bin)"
50 echo "buildstandalonegc - builds the GC in a standalone mode. Can't be used with \"cmakeargs\"."
57 if [ "$__HostOS" == "Linux" ]; then
58 if [ ! -e /etc/os-release ]; then
59 echo "WARNING: Can not determine runtime id for current distro."
62 source /etc/os-release
63 __HostDistroRid="$ID.$VERSION_ID-$__HostArch"
70 if [ $__CrossBuild == 1 ]; then
71 if [ "$__BuildOS" == "Linux" ]; then
72 if [ ! -e $ROOTFS_DIR/etc/os-release ]; then
73 echo "WARNING: Can not determine runtime id for current distro."
76 source $ROOTFS_DIR/etc/os-release
77 export __DistroRid="$ID.$VERSION_ID-$__BuildArch"
81 export __DistroRid="$__HostDistroRid"
84 # Portable builds target the base RID only for Linux based platforms
85 if [ $__PortableLinux == 1 ]; then
86 export __DistroRid="linux-$__BuildArch"
92 echo Setting up directories for build
94 mkdir -p "$__RootBinDir"
97 mkdir -p "$__IntermediatesDir"
99 if [ $__CrossBuild == 1 ]; then
100 mkdir -p "$__CrossComponentBinDir"
101 mkdir -p "$__CrossCompIntermediatesDir"
105 # Check the system to ensure the right prereqs are in place
109 echo "Checking prerequisites..."
111 # Check presence of CMake on the path
112 hash cmake 2>/dev/null || { echo >&2 "Please install cmake before running this script"; exit 1; }
115 hash clang-$__ClangMajorVersion.$__ClangMinorVersion 2>/dev/null || hash clang$__ClangMajorVersion$__ClangMinorVersion 2>/dev/null || hash clang 2>/dev/null || { echo >&2 "Please install clang-$__ClangMajorVersion.$__ClangMinorVersion before running this script"; exit 1; }
120 generate_event_logging_sources()
122 if [ $__SkipCoreCLR == 1 ]; then
126 # Event Logging Infrastructure
127 __GeneratedIntermediate="$__IntermediatesDir/Generated"
128 __GeneratedIntermediateEventProvider="$__GeneratedIntermediate/eventprovider_new"
129 if [[ -d "$__GeneratedIntermediateEventProvider" ]]; then
130 rm -rf "$__GeneratedIntermediateEventProvider"
133 if [[ ! -d "$__GeneratedIntermediate/eventprovider" ]]; then
134 mkdir -p "$__GeneratedIntermediate/eventprovider"
137 mkdir -p "$__GeneratedIntermediateEventProvider"
138 if [[ $__SkipCoreCLR == 0 || $__ConfigureOnly == 1 ]]; then
139 echo "Laying out dynamically generated files consumed by the build system "
140 echo "Laying out dynamically generated Event Logging Test files"
141 $PYTHON -B -Wall -Werror "$__ProjectRoot/src/scripts/genXplatEventing.py" --man "$__ProjectRoot/src/vm/ClrEtwAll.man" --exc "$__ProjectRoot/src/vm/ClrEtwAllMeta.lst" --testdir "$__GeneratedIntermediateEventProvider/tests"
143 if [[ $? != 0 ]]; then
147 #determine the logging system
150 echo "Laying out dynamically generated Event Logging Implementation of Lttng"
151 $PYTHON -B -Wall -Werror "$__ProjectRoot/src/scripts/genXplatLttng.py" --man "$__ProjectRoot/src/vm/ClrEtwAll.man" --intermediate "$__GeneratedIntermediateEventProvider"
152 if [[ $? != 0 ]]; then
161 echo "Cleaning the temp folder of dynamically generated Event Logging files"
162 $PYTHON -B -Wall -Werror -c "import sys;sys.path.insert(0,\"$__ProjectRoot/src/scripts\"); from Utilities import *;UpdateDirectory(\"$__GeneratedIntermediate/eventprovider\",\"$__GeneratedIntermediateEventProvider\")"
163 if [[ $? != 0 ]]; then
167 rm -rf "$__GeneratedIntermediateEventProvider"
174 intermediatesForBuild="$3"
175 extraCmakeArguments="$4"
178 if [ $skipCondition == 1 ]; then
179 echo "Skipping $message build."
183 # All set to commence the build
184 echo "Commencing build of $message for $__BuildOS.$__BuildArch.$__BuildType in $intermediatesForBuild"
189 if [ $__UseNinja == 1 ]; then
191 buildFile="build.ninja"
192 if ! buildTool=$(command -v ninja || command -v ninja-build); then
193 echo "Unable to locate ninja!" 1>&2
198 if [ $__SkipConfigure == 0 ]; then
199 # if msbuild is not supported, then set __SkipGenerateVersion to 1
200 if [ $__isMSBuildOnNETCoreSupported == 0 ]; then __SkipGenerateVersion=1; fi
201 # Drop version.cpp file
202 __versionSourceFile="$intermediatesForBuild/version.cpp"
203 if [ $__SkipGenerateVersion == 0 ]; then
205 "$__ProjectRoot/run.sh" build -Project=$__ProjectDir/build.proj -generateHeaderUnix -NativeVersionSourceFile=$__versionSourceFile $__RunArgs $__UnprocessedBuildArgs
207 # Generate the dummy version.cpp, but only if it didn't exist to make sure we don't trigger unnecessary rebuild
208 __versionSourceLine="static char sccsid[] __attribute__((used)) = \"@(#)No version information produced\";"
209 if [ -e $__versionSourceFile ]; then
210 read existingVersionSourceLine < $__versionSourceFile
212 if [ "$__versionSourceLine" != "$existingVersionSourceLine" ]; then
213 echo $__versionSourceLine > $__versionSourceFile
217 pushd "$intermediatesForBuild"
218 # Regenerate the CMake solution
219 echo "Invoking \"$__ProjectRoot/src/pal/tools/gen-buildsys-clang.sh\" \"$__ProjectRoot\" $__ClangMajorVersion $__ClangMinorVersion $platformArch $__BuildType $__CodeCoverage $__IncludeTests $generator $extraCmakeArguments $__cmakeargs"
220 "$__ProjectRoot/src/pal/tools/gen-buildsys-clang.sh" "$__ProjectRoot" $__ClangMajorVersion $__ClangMinorVersion $platformArch $__BuildType $__CodeCoverage $__IncludeTests $generator "$extraCmakeArguments" "$__cmakeargs"
224 if [ ! -f "$intermediatesForBuild/$buildFile" ]; then
225 echo "Failed to generate $message build project!"
229 # Get the number of processors available to the scheduler
230 # Other techniques such as `nproc` only get the number of
231 # processors available to a single process.
232 if [ `uname` = "FreeBSD" ]; then
233 NumProc=`sysctl hw.ncpu | awk '{ print $2+1 }'`
234 elif [ `uname` = "NetBSD" ]; then
235 NumProc=$(($(getconf NPROCESSORS_ONLN)+1))
237 NumProc=$(($(getconf _NPROCESSORS_ONLN)+1))
241 if [ $__ConfigureOnly == 1 ]; then
242 echo "Finish configuration & skipping $message build."
246 # Check that the makefiles were created.
247 pushd "$intermediatesForBuild"
249 echo "Executing $buildTool install -j $NumProc"
251 $buildTool install -j $NumProc
253 echo "Failed to build $message."
260 build_cross_arch_component()
262 __SkipCrossArchBuild=1
264 # check supported cross-architecture components host(__HostArch)/target(__BuildArch) pair
265 if [[ "$__BuildArch" == "arm" && "$__CrossArch" == "x86" ]]; then
266 export CROSSCOMPILE=0
267 __SkipCrossArchBuild=0
269 # building x64-host/arm-target cross-architecture component need to use cross toolchain of x86
270 if [ "$__HostArch" == "x64" ]; then
271 export CROSSCOMPILE=1
278 export __CMakeBinDir="$__CrossComponentBinDir"
279 export CROSSCOMPONENT=1
282 if [ $CROSSCOMPILE == 1 ]; then
283 TARGET_ROOTFS="$ROOTFS_DIR"
284 if [ -n "$CAC_ROOTFS_DIR" ]; then
285 export ROOTFS_DIR="$CAC_ROOTFS_DIR"
287 export ROOTFS_DIR="$__ProjectRoot/cross/rootfs/$__CrossArch"
291 __ExtraCmakeArgs="-DCLR_CMAKE_TARGET_ARCH=$__BuildArch -DCLR_CMAKE_TARGET_OS=$__BuildOS -DCLR_CMAKE_PACKAGES_DIR=$__PackagesDir -DCLR_CMAKE_PGO_INSTRUMENT=$__PgoInstrument"
292 build_native $__SkipCrossArchBuild "$__CrossArch" "$__CrossCompIntermediatesDir" "$__ExtraCmakeArgs" "cross-architecture component"
294 # restore ROOTFS_DIR, CROSSCOMPONENT, and CROSSCOMPILE
295 if [ -n "$TARGET_ROOTFS" ]; then
296 export ROOTFS_DIR="$TARGET_ROOTFS"
298 export CROSSCOMPONENT=
299 export CROSSCOMPILE=1
302 isMSBuildOnNETCoreSupported()
304 # This needs to be updated alongwith corresponding changes to netci.groovy.
305 __isMSBuildOnNETCoreSupported=0
307 if [ "$__HostArch" == "x64" ]; then
308 if [ "$__HostOS" == "Linux" ]; then
309 case "$__HostDistroRid" in
311 __isMSBuildOnNETCoreSupported=1
314 __isMSBuildOnNETCoreSupported=1
317 __isMSBuildOnNETCoreSupported=1
320 __isMSBuildOnNETCoreSupported=1
323 __isMSBuildOnNETCoreSupported=1
326 __isMSBuildOnNETCoreSupported=1
329 __isMSBuildOnNETCoreSupported=1
332 __isMSBuildOnNETCoreSupported=1
335 __isMSBuildOnNETCoreSupported=1
338 __isMSBuildOnNETCoreSupported=1
341 __isMSBuildOnNETCoreSupported=1
345 elif [ "$__HostOS" == "OSX" ]; then
346 __isMSBuildOnNETCoreSupported=1
353 if [ $__SkipCoreCLR == 0 -a -e $__BinDir/crossgen ]; then
354 echo "Generating native image for System.Private.CoreLib."
355 $__BinDir/crossgen $__BinDir/System.Private.CoreLib.dll
356 if [ $? -ne 0 ]; then
357 echo "Failed to generate native image for System.Private.CoreLib."
361 echo "Generating native image for MScorlib Facade."
362 $__BinDir/crossgen $__BinDir/mscorlib.dll
363 if [ $? -ne 0 ]; then
364 echo "Failed to generate native image for mscorlib facade."
368 if [ "$__BuildOS" == "Linux" ]; then
369 echo "Generating symbol file for System.Private.CoreLib."
370 $__BinDir/crossgen /CreatePerfMap $__BinDir $__BinDir/System.Private.CoreLib.ni.dll
371 if [ $? -ne 0 ]; then
372 echo "Failed to generate symbol file for System.Private.CoreLib."
382 if [ $__isMSBuildOnNETCoreSupported == 0 ]; then
383 echo "System.Private.CoreLib.dll build unsupported."
387 if [ $__SkipMSCorLib == 1 ]; then
388 echo "Skipping building System.Private.CoreLib."
392 echo "Commencing build of managed components for $__BuildOS.$__BuildArch.$__BuildType"
395 $__ProjectRoot/run.sh build -Project=$__ProjectDir/build.proj -MsBuildLog="/flp:Verbosity=normal;LogFile=$__LogsDir/System.Private.CoreLib_$__BuildOS__$__BuildArch__$__BuildType.log" -BuildTarget -__IntermediatesDir=$__IntermediatesDir -__RootBinDir=$__RootBinDir -BuildNugetPackage=false -UseSharedCompilation=false $__RunArgs $__UnprocessedBuildArgs
397 if [ $? -ne 0 ]; then
398 echo "Failed to build managed components."
402 # The cross build generates a crossgen with the target architecture.
403 if [ $__CrossBuild != 1 ]; then
404 # The architecture of host pc must be same architecture with target.
405 if [[ ( "$__HostArch" == "$__BuildArch" ) ]]; then
407 elif [[ ( "$__HostArch" == "x64" ) && ( "$__BuildArch" == "x86" ) ]]; then
409 elif [[ ( "$__HostArch" == "arm64" ) && ( "$__BuildArch" == "arm" ) ]]; then
417 generate_NugetPackages()
419 # We can only generate nuget package if we also support building mscorlib as part of this build.
420 if [ $__isMSBuildOnNETCoreSupported == 0 ]; then
421 echo "Nuget package generation unsupported."
425 # Since we can build mscorlib for this OS, did we build the native components as well?
426 if [ $__SkipCoreCLR == 1 ]; then
427 echo "Unable to generate nuget packages since native components were not built."
431 echo "Generating nuget packages for "$__BuildOS
434 $__ProjectRoot/run.sh build -Project=$__SourceDir/.nuget/packages.builds -MsBuildLog="/flp:Verbosity=normal;LogFile=$__LogsDir/Nuget_$__BuildOS__$__BuildArch__$__BuildType.log" -BuildTarget -__IntermediatesDir=$__IntermediatesDir -__RootBinDir=$__RootBinDir -BuildNugetPackage=false -UseSharedCompilation=false $__RunArgs $__UnprocessedBuildArgs
436 if [ $? -ne 0 ]; then
437 echo "Failed to generate Nuget packages."
442 echo "Commencing CoreCLR Repo build"
444 # Argument types supported by this script:
446 # Build architecture - valid values are: x64, ARM.
447 # Build Type - valid values are: Debug, Checked, Release
449 # Set the default arguments for build
451 # Obtain the location of the bash script to figure out where the root of the repo is.
452 __ProjectRoot="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
454 # Use uname to determine what the CPU is.
456 # Some Linux platforms report unknown for platform, but the arch for machine.
457 if [ "$CPUName" == "unknown" ]; then
463 echo "Unsupported CPU $CPUName detected, build might not succeed!"
474 echo "Unsupported CPU $CPUName detected, build might not succeed!"
485 echo "Unknown CPU $CPUName detected, configuring as if for x64"
491 # Use uname to determine what the OS is.
525 echo "Unsupported OS $OSName detected, configuring as if for Linux"
533 __IncludeTests=Include_Tests
535 # Set the various build properties here so that CMake and MSBuild can pick them up
536 __ProjectDir="$__ProjectRoot"
537 __SourceDir="$__ProjectDir/src"
538 __PackagesDir="$__ProjectDir/packages"
539 __RootBinDir="$__ProjectDir/bin"
540 __UnprocessedBuildArgs=
553 __ClangMajorVersion=0
554 __ClangMinorVersion=0
555 __NuGetPath="$__PackagesDir/NuGet.exe"
559 __SkipGenerateVersion=0
564 if [ $# -le 0 ]; then
568 lowerI="$(echo $1 | awk '{print tolower($0)}')"
608 __CodeCoverage=Coverage
616 if [ "$__BuildOS" == "Linux" ]; then
619 echo "ERROR: portableLinux not supported for non-Linux platforms."
629 __ClangMajorVersion=3
630 __ClangMinorVersion=5
634 __ClangMajorVersion=3
635 __ClangMinorVersion=6
639 __ClangMajorVersion=3
640 __ClangMinorVersion=7
644 __ClangMajorVersion=3
645 __ClangMinorVersion=8
649 __ClangMajorVersion=3
650 __ClangMinorVersion=9
672 # Use "skipnative" to use the same option name as build.cmd.
677 # Accept "skipcoreclr" for backwards-compatibility.
690 __SkipGenerateVersion=1
709 echo "ERROR: 'cmakeargs' requires a non-empty option argument"
717 if [ ! -d $__RootBinDir ]; then
720 __RootBinParent=$(dirname $__RootBinDir)
721 __RootBinName=${__RootBinDir##*/}
722 __RootBinDir="$(cd $__RootBinParent &>/dev/null && printf %s/%s $PWD $__RootBinName)"
725 echo "ERROR: 'bindir' requires a non-empty option argument"
730 __cmakeargs="-DFEATURE_STANDALONE_GC=1"
733 __UnprocessedBuildArgs="$__UnprocessedBuildArgs $1"
740 __RunArgs="-BuildArch=$__BuildArch -BuildType=$__BuildType -BuildOS=$__BuildOS"
742 # Configure environment if we are doing a verbose build
743 if [ $__VerboseBuild == 1 ]; then
745 __RunArgs="$__RunArgs -verbose"
748 # Set default clang version
749 if [[ $__ClangMajorVersion == 0 && $__ClangMinorVersion == 0 ]]; then
750 if [ $__CrossBuild == 1 ]; then
751 __ClangMajorVersion=3
752 __ClangMinorVersion=6
754 __ClangMajorVersion=3
755 __ClangMinorVersion=5
759 # Set dependent variables
760 __LogsDir="$__RootBinDir/Logs"
762 # init the host distro name
765 # Set the remaining variables based upon the determined build configuration
766 __BinDir="$__RootBinDir/Product/$__BuildOS.$__BuildArch.$__BuildType"
767 __PackagesBinDir="$__BinDir/.nuget"
768 __ToolsDir="$__RootBinDir/tools"
769 __TestWorkingDir="$__RootBinDir/tests/$__BuildOS.$__BuildArch.$__BuildType"
770 export __IntermediatesDir="$__RootBinDir/obj/$__BuildOS.$__BuildArch.$__BuildType"
771 __TestIntermediatesDir="$__RootBinDir/tests/obj/$__BuildOS.$__BuildArch.$__BuildType"
772 __isMSBuildOnNETCoreSupported=0
773 __CrossComponentBinDir="$__BinDir"
774 __CrossCompIntermediatesDir="$__IntermediatesDir/crossgen"
776 __CrossArch="$__HostArch"
777 if [[ "$__HostArch" == "x64" && "$__BuildArch" == "arm" ]]; then
780 if [ $__CrossBuild == 1 ]; then
781 __CrossComponentBinDir="$__CrossComponentBinDir/$__CrossArch"
783 __CrossgenCoreLibLog="$__LogsDir/CrossgenCoreLib_$__BuildOS.$BuildArch.$__BuildType.log"
784 __CrossgenExe="$__CrossComponentBinDir/crossgen"
786 # Init if MSBuild for .NET Core is supported for this platform
787 isMSBuildOnNETCoreSupported
789 # CI_SPECIFIC - On CI machines, $HOME may not be set. In such a case, create a subfolder and set the variable to set.
790 # This is needed by CLI to function.
791 if [ -z "$HOME" ]; then
792 if [ ! -d "$__ProjectDir/temp_home" ]; then
795 export HOME=$__ProjectDir/temp_home
796 echo "HOME not defined; setting it to $HOME"
799 # Specify path to be set for CMAKE_INSTALL_PREFIX.
800 # This is where all built CoreClr libraries will copied to.
801 export __CMakeBinDir="$__BinDir"
803 # Configure environment if we are doing a cross compile.
804 if [ $__CrossBuild == 1 ]; then
805 export CROSSCOMPILE=1
806 if ! [[ -n "$ROOTFS_DIR" ]]; then
807 export ROOTFS_DIR="$__ProjectRoot/cross/rootfs/$__BuildArch"
811 # init the target distro name
814 # Make the directories necessary for build if they don't exist
820 # Generate event logging infrastructure sources
821 generate_event_logging_sources
823 # Build the coreclr (native) components.
824 __ExtraCmakeArgs="-DCLR_CMAKE_TARGET_OS=$__BuildOS -DCLR_CMAKE_PACKAGES_DIR=$__PackagesDir -DCLR_CMAKE_PGO_INSTRUMENT=$__PgoInstrument"
825 build_native $__SkipCoreCLR "$__BuildArch" "$__IntermediatesDir" "$__ExtraCmakeArgs" "CoreCLR component"
827 # Build cross-architecture components
828 if [[ $__CrossBuild == 1 && $__DoCrossArchBuild == 1 ]]; then
829 build_cross_arch_component
832 # Build System.Private.CoreLib.
836 # Generate nuget packages
837 if [ $__SkipNuget != 1 ]; then
838 generate_NugetPackages
844 echo "Repo successfully built."
845 echo "Product binaries are available at $__BinDir"