Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
5.0 Building Shoes
Clone this wiki locally
Building Shoes from source
I'm going to apologize right up top. This is not as easy as you expect nor as easy as we would like. Ruby 1.9.3 introduced some internal changes that profoundly changed things for building Shoes. That led to a very important concept in Shoes 3.2: Tight Shoes and Loose Shoes.
_BEWARE: Things change a lot in this corner of the world. It's guidelines below - not absolute rules.
Tight Shoes is one you can bundle up and send to someone else. It lives in its own sandbox and includes a copy of Ruby (the Ruby it was built with). Your Ruby is probably not built to do that successfully. It's called Tight because its a very controlled setup.
Loose Shoes doesn't have those restrictions it just uses whatever it can find for a Ruby and it links against that Ruby's libs. It doesn't have to carry around a copy of Ruby or bundle up dependencies and gems. That makes it small and quick to compile and you can install it (on your system) if you like it. It allows Shoes access to all the gems you've installed. What you can't do is distribute that Shoes.
In Windows, the tight/loose distinction is a little more subtle because you have to have all the DLL's in any Shoes but the distinction still exists (gems primarily), even on Windows.
In OSX there is no difference between tight and loose - it's always tight.
Here is where the bulk of ugly lives. Shoes uses lots of open source libraries which we call dependencies. Ruby is a dependency and the the libraries Ruby needs are also dependencies. We need to build A Ruby our way and it lib's and then the libs Shoes wants. It's not hard if you know how to read error messages (some folks do get confused - so it's a skill to learn). It may not be hard but it is a lenghty process - give your self a couple of full days OR you can download prebuild dependencies for OSX 10.9, 10.6 and Windows.
Linux is not a free walk either because we setup chroots and install an older version of Linux in it before we build Ruby in it and apt-get all the easy stuff. It's even more interesting settup up chroot that runs QEMU before we install the armhf debian and use it to build dependencies (including Ruby). It takes time and some Linux knowledge to set things up for a Tight Shoes build.
Rake files and yaml
Just to confuse you more, you need a Ruby to build Shoes and it may not be the Ruby you include in the built Shoes. There is a Ruby to build with and a Ruby to build for and include with Shoes.
Show me the stuff:
- Build Servers An overview of building - System Admin Level
- Shoes Rakefiles
- Rake files
- App.yaml secrets
- Gems for Shoes
- Building Shoes on Linux
- Building Shoes on Pi2
- Mingw Dependencies
- Building Shoes on Windows
- Cross compile mingw
- NSIS Installer for Windows
- OSX 10.9 Dependencies
- OSX 10.6 Dependencies
- Msys2 and Shoes for Windows
- Setup an schroot build environment
- FreeBSD and Shoes