For up to date installation instructions download Homebrewer’s Guide to Watir book. You can download the book for free. If you buy the book the money goes to Watir project.
Troubleshooting
Visit the following links for having trouble with installation:
Installing Behind an Authenticating Proxy
Watir drivers are packaged as gems, Ruby libraries that can be installed over the internet. If installing behind an authenticating proxy, first set the HTTP_PROXY environment variable:
Windows:
set HTTP_PROXY=http://username:password@your.proxy.com:80Linux:
export http_proxy=http://username:password@your.proxy.com:80Tips
Install Ruby on Linux
Use your relevant package manager to update or install Ruby with the following at a terminal window:
sudo apt-get install ruby # for Ubuntu / Debian userssudo yum install ruby # for Red Hat / Fedora users
Update RubyGems on Linux
Make sure you have the latest rubygems version 1.3.7 or above installed. Use your relevant package manager to install the latest version with the following at a terminal window:
sudo apt-get install rubygems# for Ubuntu / Debian userssudo yum install rubygems# for Red Hat / Fedora users
Install a HTML Inspector
To use Watir effectively, you’ll need to be able to browse through the structure of your application’s HTML pages. These tools help you do that.
- On Firefox, use Firebug
- On Internet Explorer, use the IE Developer Toolbar
Installing or Updating RubyGems
While updating RubyGems, or installing any of the gems, you can use the following additional flags:
--no-rdoc --no-ri
For example:
gem update --system --no-rdoc --no-ri
gem install watir --no-rdoc --no-ri
It will be much faster, but you will not install RDoc and ri.
Very good instructions. The Ubuntu setup went well. There’s this great article about setting up opera using apt-get which was helpful.
http://www.liberiangeek.net/2011/12/install-opera-web-browser-using-apt-get-in-ubuntu-11-10-oneiric-ocelot/
Do all this as root:
wget -O – http://deb.opera.com/archive.key | apt-key add -
echo deb http://deb.opera.com/opera/ stable non-free > /etc/apt/sources.list.d/opera.list
apt-get update
apt-get install opera
Pingback: Migrating Unit Tests from Selenium to Watir Webdriver
later versions of Xcode – 4.4 at least, possibly 4.0, require that you install the Xcode command line tools before you can install safariwatir, or anything else for that matter.
Watir-webdriver, apparently is more likely to be up to date than safariwatir.
Above, all links to the installation instructions are not working any more.
E.g. https://github.com/zeljkofilipin/watirbook/downloads leads to an Error 404 Page.
It would be nice, if somebody could fix this – thank you! :-)
Thanks for letting me know, the links are fixed now. I have moved the book recently and I thought I have fixed all links.
Still not working :(
What is not working?
https://github.com/zeljkofilipin/watirbook/downloads is still throwing 404.
Thanks.
That is what should happen, because the book has moved to leanpub.com/watirbook. Where did you find that link (so I can remove it)?
I don’t think it’s such a good idea to install ruby using apt-get or yum. If you do, you’re stuck with the latest version that the repository has, which is never current. You surrender finer control and benefits of the latest ruby environment. I would follow the install steps for rbenv or RVM (don’t do both!!!).
if you use RVM, you won’t yum install rubygems either. You’ll do “rvm rubygems current”. Easy-peasy.
Installing ruby on Linux via apt-get or yum is the simplest way. If somebody just wants to try Ruby or Watir, there is no need to install RVM. If later on they decide they need a Ruby version that is not supported by their package manager, they can install RVM then.
Personally I think it would be better to give download/install instructions OUTSIDE of the book that costs $$ unless you want to feel like an absolute wretch for downloading a book that obviously took effort, lots of time, thought and hard work; just to be able to install software that you’ve no clue if you really want to buy and wanted to try but not for $9.99, especially since it might be your $9.99 as trying to justify buying a book to just try software probably wouldn’t be met with a re-reimbursement….
If you offered how to download outside, you might get more people buying the book instead of looking at it, going back to the download page and re-reading, then going and looking at the price and deciding the guilt factor wasn’t worth it when there are lots of automation tools out there…
You can find installation instructions outside of the book here: https://github.com/watir/watirbook/tree/master/installation
You can get the book for free, just move the slider to the left until the amount is $0.00.