HOW TO BUILD OMEA 3.0 FROM SOURCE NOTE: Before you get too far, you might want to read my recent post to this newsgroup entitled: "Omea 3.0 extremely slow to start". As its title indicates, Omea 3.0 takes ~15 minutes for me to start up. Once
... [More]
started, things seem to work okay. The problem may indicate I've done something wrong during the build process (that I'm about to lay out below). If this turns out to be the case, I'll post a follow-up in this thread. ASSUMPTIONS: - I have Microsoft Visual Studio 2008 installed on my machine. I don't know if you must have this application. - I don't know if the free Visual Studio Express (http://www.microsoft.com/express/download/) will work as a substitute for the above or, in fact, if either application is actually necessary at all. THINGS YOU'LL DEFINITELY NEED: - You build the entire Omea 3.0 suite (plugins and all) with MSbuild.exe. This command-line application is part of the .NET framework distributed freely from Microsoft. Make sure you get .NET v3.5 (http://www.microsoft.com/downloads/details.aspx?familyid=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en) - You need sn.exe to generate a private strong name key. I believe this is also part of the .NET framework. - You need xsd.exe to generate source from XML. I believe this is also part of the .NET framework. - You need a Subversion client to get the latest source from the Jetbrains site. I use TortoiseSVN (http://tortoisesvn.net/downloads) STEP 1: GET THE SOURCE - Make sure you have an installed SVN client (see above) - Make a directory on your machine where you want the Omea source to reside - Assuming you're using TortoiseSVN, you can right-click in the folder you just created in Windows Explorer and select "Checkout SVN" from the menu. - Set the "URL of repository" to http://svn.jetbrains.org/omeaopen/trunk/Omea - Make sure "Checkout directory" is the directory you want the source to be located. This field will probably be filled in for you. - Click OK to begin downloading the files STEP 2: GET READY TO BUILD - Open a DOS command prompt. (I don't know if the build will work in Cygwin or Powershell.) - Make sure you have the needed applications in your path: - Find msbuild.exe. Mine was in C:\Windows\Microsoft.NET\Framework\v3.5\ - Add msbuild.exe to your path: - from the command prompt type (w/o quotes) "set PATH=%PATH%;C:\Windows\Microsoft.NET\Framework\v3.5\" (of course, substitute your location if different) - Find sn.exe and xsd.exe. I put them together because they were in the same directory for me C:\Program Files\Microsoft SDKs\Windows\v6.0A\bin\ - Add them to your path as in the previous step STEP 3: GENERATE A PRIVATE STRONG NAME KEY - With your open command prompt, go to Omea's Lib directory. It's a directory below the root of the SVN source. - Generate your key via: "sn -k Key.snk" STEP 4: BUILD OMEA - With the same command prompt, go the the Build directory. It's a sibling of the Lib directory you're currently in. - Kick off the build via: "msbuild /target:Build" - It took me 2 minutes 18 seconds to complete the build - There were hundreds of warnings that scrolled past during this time. - I finished with 1380 warnings, 0 errors STEP 5: UNINSTALL PREVIOUS OMEA - I did not remove my existing data, only the application itself. STEP 6: INSTALL OMEA 3.0 - Use Windows Explorer to browse to Omea's BinRelease directory (another sibling of Lib and Build). - Double-click OmeaSetup.msi to run the Omea 3.0 installer - Install as you would any application in Windows STEP 7: ENJOY OMEA 3.0 - But note my note at the beginning of this post. I takes me 15 minutes to start Omea 3.0 before I can do anything with it. If this is "just the way it is" with 3.0, I'll definitely be going back to 2.2. My guess is that I've done something wrong or have an incompatible environment. Good luck! Please post a follow-up if I was unclear or wrong on any of these steps. Sean [Less]
|