Fork me on GitHub

Troubleshooting

As badly as we want this process to be seamless and simple for everyone, there always seem to be bits of complexity that cause problems. We consider this a failure of Sprouts and would like to see improvements made so that manual debugging of Sprouts installations becomes a thing of the past. If you have an issue, please let us know and feel free to fork the source and submit a fix!

Following are some of the more common issues that have come up in the past.

General Issues

Bundler::GemNotFound

You may see something like the following after running rake or a generator within a project.

.../bundler-1.0.3/lib/bundler/spec_set.rb:87:in
'block in materialize': Could not find sprout-1.1.3.pre 
in any of the sources (Bundler::GemNotFound)
        from .../bundler-1.0.3/lib/bundler/spec_set.rb:81:in `map!'
        from .../bundler-1.0.3/lib/bundler/spec_set.rb:81:in `materialize'
        from .../bundler-1.0.3/lib/bundler/definition.rb:93:in `specs'
        from .../bundler-1.0.3/lib/bundler/definition.rb:137:in `specs_for'
        from .../bundler-1.0.3/lib/bundler/definition.rb:126:in `requested_specs'
        from .../bundler-1.0.3/lib/bundler/environment.rb:23:in `requested_specs'
        from .../bundler-1.0.3/lib/bundler/runtime.rb:11:in `setup'
        from .../bundler-1.0.3/lib/bundler.rb:100:in `setup'
        from .../bundler-1.0.3/lib/bundler.rb:112:in `require'
        from .../sprout-1.1.4.pre/bin/sprout-class:5:in `<top (required)>'
        from .../bin/sprout-class:19:in `load'
        from .../bin/sprout-class:19:in `<main>'

This error is generated because your Gemfile.lock is referring to a gem that is no longer installed. To fix this, just run:

bundle install

Windows

Ruby Version >= 1.9.2?

It is especially critical that Windows users be running a Ruby that is greater than or equal to version 1.9.2. The previous versions of Ruby had critical bugs that prevented this version of Sprouts from working.

We highly recommend Windows users get going with the Ruby Installer. You should know that this installer includes a version of Mingw

I haven’t tried it myself, but it might be worth checking out Pic (Ruby Version Manager for Windows).

Missing MSVCR71.dll

As far as I can tell, this issue appears to have something to do with Java and Microsoft trying to piss on each other, and since Adobe (in a supremely questionable decision) decided to used Java to build their compilers, we get to suffer the consequences.

I was able to find a copy of this dll on a (reasonably) fresh installation of Windows server 2008 here:

C:\Users\Administrator\AppData\LocalLow\Sun\Java\Deployment\SystemCache\6.0\46

I manually copied this file to:

C:\Users\Administrator\Sprouts\1.1\cache\flex4\4.1.0.16076\bin

Whenever I get a new Flex SDK, I have to copy this file into the newly unpacked bin folder.

If you have other information about this issue, please let us know.

OS X

Using Ruby Version Manager (RVM)?

Ruby Version Manager is a tool that makes it very easy to switch between different versions of Ruby. It also gets your system into a state where you don’t use sudo to install RubyGems.

Are XCode / Developer tools installed?

Be sure you have installed the OS X “Developer Tools” which should have been included with your operating system DVD.

Linux

Debian system (like Ubuntu) don’t like RubyGems in the path

You will likely need to update your system path to accomodate installed RubyGems.