4 The Mono project has developed mono, a CLI runtime. The build process
5 of each of these depends on nothing more than a C compiler and glib2.
7 However, to provide a working runtime environment, these programs must
8 be supplemented by the class libraries, which are written in C#. This
9 package contains the components written in C#: class libraries,
12 *********************************************************************
16 * Unless you are developing the class libraries, you should *
17 * not need to do any build steps in this directory. *
19 * Go to ../mono and read the README file to compile and *
22 * ../mono is where you have your `mono' source download *
24 *********************************************************************
26 If you only want to build a snapshot or a fresh CVS checkout of the
27 sources, you should go into the `mono' sibling directory and issue the
28 make bootstrap command, like this:
31 ./autogen.sh --prefix=/usr/local
35 The compilation is bundled with the build due to dependencies on the
36 class libraries on the runtime.
38 Build Features for Developers of Mono.
39 ======================================
41 These instructions apply to both Linux and Windows. To build this
42 package, you must already have a C# compiler installed. This means
43 that to build on Linux, you need to get a distribution of the MCS
44 binaries; these are called monocharges. They can be found at
45 www.go-mono.com/daily. On Windows, you can just use the
46 Microsoft compiler. You also need GNU make to build the software (on
47 Windows, you will need for example the Cygwin environment setup).
49 You can customize your MCS configuration by using:
51 ./configure [--prefix=PREFIX] [--profile=PROFILE]
53 If you do not run the above, the defaults are /usr/local for the
54 prefix, and `default' for the profile.
56 To build the compiler and class libraries, run:
60 The libraries will be placed in the directory class/lib/ and the mcs
61 compiler executable in mcs/.
63 To install them, run the following:
67 If you get "corlib out of sync" errors, try
71 The difference between the two modes is explained farther down.
76 We try to maintain the CVS tree such that it is bootstrapable from the
77 latest released version of mono and mcs. Occasionally, something in the
78 compiler or runtime changes enough that an existing installation cannot
79 complete a bootstrap from cvs. In this case, go to
80 http://go-mono.com/daily and download a monocharge or monolite tarball.
81 Unpack and copy the .dlls to $prefix/lib and .exes to $prefix/bin/.
82 Then you should be able to complete the build normally (i.e. using make
85 wget http://go-mono.com/daily/monolite-20040505.tar.gz
86 tar -zxvf monolite-20040505.tar.gz
88 env prefix=/usr/local sh recharge.sh
93 If you are tracking Mono's development, you may sometimes need to share
94 the compiled libraries with others, you can do:
98 Or a light version, which contains only the essential libraries and
99 results in a much smaller file:
106 If you want to change the configuration options for the build process,
107 place your configuration options in build/config.make
109 A list of variables that control the build are listed in the file
110 build/config-default.make.
112 Build profiles? What?
113 ======================
115 Don't worry about them too much. If you're wondering which to use:
116 use the default if you can (that's why it's the default!) and use
117 the atomic if you have to.
119 The default profile uses the C# compiler and class libaries as they
120 are built. This lets you build MCS without needing to have already
121 installed it, but can fail if the libraries change significantly.
122 (This is the source of the dreaded "corlib out of sync" warning, most
125 The atomic profile tries to use the system compiler and preexisting
126 MCS libraries. New libaries are built against this constant reference
127 point, so if a newly built library has a binary incompatibility, the
128 rest of your build can proceed.
130 If you want to always use the atomic profile, run this command:
132 ./configure --profile=atomic
134 More About the Build System
135 ===========================
137 More information is found in build/README.*. Here's a quick rundown
140 * Unified build system for Windows and Linux. Windows is still
141 fairly untested, but "should work." Unfortunately I don't
142 have a Windows machine to test on, but Gonzalo can get
143 corlib to build I think and that's about as complicated as
146 * Profile support. 'make PROFILE=profilename' or 'export
147 PROFILE=profilename ; make' will work. Profiles are defined
148 in build/profiles/profilename.make ; right now there isn't
149 too much going on. The 'bootstrap' profile will build the
150 way makefile.gnu did on Linux, by setting MONO_PATH and
151 using mcs/mcs.exe; the default profile will build against
152 the existing system libraries and compile with 'mcs', which
153 should reduce a lot of 'corlib out of sync' warnings.
155 * Important variables are shared among makefiles now; you can
156 edit build/config.make (see build/config-default.make for a
157 template) and give global settings, or just have a much
158 saner time of writing new makefiles.
160 * Response files, stamps, and other build trivia now all land
161 in build/deps/, making the library build directories
164 * Test libraries now live in class/Library/Library_test.dll,
165 not class/Library/Test. 'make test' will build the test DLL,
166 'make run-test' will actually run the nunit tests. Set the
167 variable TEST_HARNESS to run with a program other than
168 nunit-console (for example, nunit-gtk).
170 * Standardized recursive targets: all, clean, install, test,
171 run-test. Read build/README.makefiles for definitions of
174 * (Relatively) sane 'make dist' target; 'make distcheck'
175 support; cute 'make monocharge' and 'make monocharge-lite'
176 targets. They're made possible because 'make install' now
177 supports DESTDIR a la automake, which I'm sure someone cares