Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 61 lines (40 sloc) 2.114 kB
9c1d230 committing experimental branch content
Laurent Sansonetti authored
1 == MacRuby
2
3 MacRuby is a Ruby implementation based on Mac OS X technologies, such as the
4 Objective-C runtime and garbage collector, the CoreFoundation framework and the
5 LLVM compiler infrastructure.
6
7 It is the goal of MacRuby to enable the creation of full-fledged Mac OS X
8 applications which do not sacrifice performance in order to enjoy the benefits
9 of using Ruby.
10
11 MacRuby is copyrighted free software by Apple Inc and covered by the terms of
12 the Ruby license. Please refer to the COPYING file for more information.
13
14 The project website contains more documentation, such as tutorials and guides:
d7b0462 @alloy Another formatting fix.
alloy authored
15 http://macruby.org
9c1d230 committing experimental branch content
Laurent Sansonetti authored
16
17 === Requirements
18
19 * An Intel machine. PowerPC machines are not supported anymore, but may still
20 work. An Intel 64-bit machine (Intel Core Duo 2) is recommended.
21
173bee9 now requiring LLVM revision 72741
Laurent Sansonetti authored
22 * Mac OS X 10.5.6 or later.
9c1d230 committing experimental branch content
Laurent Sansonetti authored
23
26a21e4 @vincentisambart now recommend and use llvm trunk
vincentisambart authored
24 * LLVM trunk, compiled for both i386 and x86_64.
9c1d230 committing experimental branch content
Laurent Sansonetti authored
25
173bee9 now requiring LLVM revision 72741
Laurent Sansonetti authored
26 In case trunk reveals to be unstable we recommend revision 72741.
9c1d230 committing experimental branch content
Laurent Sansonetti authored
27
173bee9 now requiring LLVM revision 72741
Laurent Sansonetti authored
28 $ svn co -r 72741 https://llvm.org/svn/llvm-project/llvm/trunk llvm-trunk
ac7854b @alloy Fixed formatting.
alloy authored
29 $ cd llvm-trunk
30 $ ./configure
31 $ UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make
32 $ sudo env UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make install
9c1d230 committing experimental branch content
Laurent Sansonetti authored
33
265ddad @alloy Added extra note about compiling LLVM with make -jN.
alloy authored
34 Note that compiling LLVM can take quite a while. If you have a machine with
35 multiple cores, which is quite likely, you might want to speed up the process
36 by using all/more cores. However, doing this can make your machine
37 unresponsive during compilation. To use multiple cores pass the `-j N'
38 option, where `N' stands for the number of cores you'd like to use. So for a
39 Dore Duo the command would look like:
40
41 $ UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make -j2
42
6be705d rewrote the README to insist that this is an experimental version of …
Laurent Sansonetti authored
43 === Build Instructions
44
45 You can build MacRuby by doing the following command:
9c1d230 committing experimental branch content
Laurent Sansonetti authored
46
47 $ rake
6be705d rewrote the README to insist that this is an experimental version of …
Laurent Sansonetti authored
48
49 Once done, you can run the RubySpec-based regression tests as well as the
50 performance suite:
51
52 $ rake spec:ci
53 $ rake bench:ci
54
55 To install MacRuby on your machine:
56
9c1d230 committing experimental branch content
Laurent Sansonetti authored
57 $ sudo rake install
58
59 Then you should be all set! Please report us any problem you will find (the
60 http://macruby.org website has pointers). Thanks!
Something went wrong with that request. Please try again.