Setting up Fire
Updated July 24.
Welcome to Fire. this post will run you thru what’s needed to get set up, Now, remember that Fire is still in beta, and the first place that shows is in actually getting it all set up so you can fully use it. Here’s the steps:
When you download Fire, it will be a zip file. Inside that zip file, you’ll find two things: Fire.app and a second zip, called “ RemObjects Elements - Mac Zip Distro - X.X.X.X.zip ” or some such thing.
Now, the .app itself will be ready to run as is. Just copy it to your /Applications folder and run it. Fire is a native Cocoa app, 95%, but it does (for now) use Mono to host the compiler, so that it can provide IDE smarts such as code completion, without us rewriting all that in Cocoa. You don’t need to install Mono separately for this, Fire comes with its own copy of 64-bit Mono inside. So you should be able to just run Fire.app and get the full experience (limited as it is for now), except for one thing: to build.
Right now, Fire just shoots off to xbuild, Mono’s implementation of MSBuild, and for that it uses the regular, global Mono install. So in order to build apps from inside Fire (and/or the command line, as well), you need to do two things:
-
install Mono 3.x from http://www.go-mono.com/mono-downloads/download.html. (someone has reported they needed the full MDK download)
-
install and register the Elements compiler with Mono. To do this, extract the .zip mentioned above to a permanent location (i.e. the place where you can/want to keep these files, don’t just unzip them to ~/Downloads and then delete the folder when done), go to the folder in Terminal.app and run ./install.sh. (this last step will add some compiler dlls to the Mono GAC, and create some XML files that will help the compiler find references.
The nice thing is that you can update the compiler and Fire independently from each other. So you can just grab a new compiler .zip (or indeed take the compiler .dlls from the Elements install on windows), install it, and the next time you hit Build in Fire, it will use the new compiler.
Please also do note that if you ever update Mono, that clears it’s GAC, so you will need to rerun the ./install.sh script afterwards.
Also note that you will need to have Xcode 5.1 installed (get it here) and have started it at least once.
What about CrossBox?
I’m pleased to say you won’t need CrossBox to build from Fire (or the command line), as the compiler chain has been updated to support “local” builds, when run on Mac (in Fact, current Fire doesn’t even expose access to rmeote CrossBoxes currently, and may not for 1.0). Just select “Local” form the CrossBox menu, and the build will happen ll locally, w/o network traffic.
That’s a lot of manual setup!
Yes. did i mention this is still pre-alpha?
The plan is that When Fire RTMs (probably even when it hits Beta for everyone), the external Mono and compiler install will no longer be needed, and Fire.app will have everything inside to work. Also, longer-term, I want Fire to not depend on Mono at all (except maybe for debugging Mono apps), as we’re switch to our internal InfraRed technology to run the managed parts natively. But let’s not worry about that just yet.
But enough talk, lets start cooking!