There are three steps involved in installing FireWatir:
If you are behind a proxy/firewall, see this page on how to still use ruby gems.
You may need to first update rubygems using this command:
The correct extension depends on your platform and your version of Firefox.
|Platform||Firefox 2.0||Firefox 3.0||Firefox 3.5||Firefox 3.6|
(Ubuntu 10.10 64bit) install
For Windows users who are installing XPI for Firefox 3.0, make sure you have also installed "Redistributed package for VS 2005 SP1". Thanks to "Ryan Huynh" for figuring out this requirement. You can get the package from here
For Windows users who are installing XPI for Firefox 3.5 or above, you may have to install "Redistributed package for VS 2008 SP1". You can get the package from here
For Debian user who are installing XPI for Firefox 3.0 and 3.5 you may have to install xulrunner development package: sudo aptitude install xulrunner-dev.
In addition to the above add-ons, there is a patched extension that some people are using with a patched version of FireWatir. This version supports driving multiple browsers concurrently, using multiple profiles. It is not compatible with production FireWatir.
Find out more about this here
Certain firefox settings need to be changed to ensure FireWatir functions correctly. These instructions can be followed to get the Firefox#attach command to work.
- Make sure that pop ups are allowed in Firefox. You can allow all popups, or only for certain sites that you are testing.
- Make sure that Firefox opens a new window instead of a new tab when a link is clicked.
You will need to open Firefox using acommand line argument to get FireWatir to recognize jssh. To do this, open your command prompt, or a terminal, and run:
from the appropriate folder, depending on your platform.
- XPI installation failure. The downloaded theme or extension will not install
Some web sites offer the option to download a theme or extension instead of installing it. The downloaded file will have a ".jar" or ".xpi" extension. Do not try to open these files directly. After the download is complete, drag the downloaded .jar or .xpi file icon from the desktop (or other location) and drop it onto an open Firefox "Add-ons" window ("Extensions" or "Themes" window in Firefox 1.5 and earlier).