Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 62 lines (41 sloc) 2.137 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 Eloy Durán 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
bb0b28c moving to LLVM r82747
Laurent Sansonetti authored
24 * LLVM ToT, compiled for both i386 and x86_64.
9c1d230 committing experimental branch content
Laurent Sansonetti authored
25
bb0b28c moving to LLVM r82747
Laurent Sansonetti authored
26 LLVM is a moving target and breaks periodically. We recommend to install
27 revision 82747.
9c1d230 committing experimental branch content
Laurent Sansonetti authored
28
bb0b28c moving to LLVM r82747
Laurent Sansonetti authored
29 $ svn co -r 82747 https://llvm.org/svn/llvm-project/llvm/trunk llvm-trunk
ac7854b Eloy Durán Fixed formatting.
alloy authored
30 $ cd llvm-trunk
31 $ ./configure
32 $ UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make
33 $ sudo env UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make install
9c1d230 committing experimental branch content
Laurent Sansonetti authored
34
265ddad Eloy Durán Added extra note about compiling LLVM with make -jN.
alloy authored
35 Note that compiling LLVM can take quite a while. If you have a machine with
36 multiple cores, which is quite likely, you might want to speed up the process
37 by using all/more cores. However, doing this can make your machine
38 unresponsive during compilation. To use multiple cores pass the `-j N'
39 option, where `N' stands for the number of cores you'd like to use. So for a
73f0fb5 fixing a typo (thanks mike at michaelakers.net)
Laurent Sansonetti authored
40 Core Duo the command would look like:
265ddad Eloy Durán Added extra note about compiling LLVM with make -jN.
alloy authored
41
42 $ UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make -j2
43
6be705d rewrote the README to insist that this is an experimental version of Mac...
Laurent Sansonetti authored
44 === Build Instructions
45
46 You can build MacRuby by doing the following command:
9c1d230 committing experimental branch content
Laurent Sansonetti authored
47
48 $ rake
6be705d rewrote the README to insist that this is an experimental version of Mac...
Laurent Sansonetti authored
49
50 Once done, you can run the RubySpec-based regression tests as well as the
51 performance suite:
52
53 $ rake spec:ci
54 $ rake bench:ci
55
56 To install MacRuby on your machine:
57
9c1d230 committing experimental branch content
Laurent Sansonetti authored
58 $ sudo rake install
59
60 Then you should be all set! Please report us any problem you will find (the
61 http://macruby.org website has pointers). Thanks!
Something went wrong with that request. Please try again.