Skip to content

robertmabbs/railsinstaller-windows

 
 

Repository files navigation

RailsInstaller

Rails development environment installer for Windows. This is attempt to get the installer to work agian. 4.0.0-alpha Pre-release now available check out How to install or Releases to downlaod.

Overview

The goal of this project is to generate an installer that when run installs all of the most common components for a Rails development environment with no required prerequisites on a Windows system.

How to Install

Currently RailsInstaller does not include everything to get rails to work on Windows. Slowly each part will get added back in, but for now you will need to follow instructions below to get rails installed.

  1. Download and install Git.

  2. Download and install Nodejs.

  3. Download and install Yarn.

  4. Download and install RailsInstaller.

RailsInstaller Components

The next few sections detail the core components that make up RailsInstaller.

Ruby 3.1.2 on Windows

RubyInstaller is a self contained package installer which installs Ruby and RubyGems on a windows system, head over to http://rubyinstaller.org/ for more information.

Development Kit (DevKit)

A MSYS/MinGW based toolkit that enables RailsInstaller to build native C/C++ packages, both for Ruby and gems. DevKit is built and maintained by the wonderful folks over at the RubyInstaller project.

Packaging/Installer

We are using Inno Setup, a free installer for Windows programs.

How to Contribute

The information below is out of date and will be updated soon.

RailsInstaller project code repository is located on GitHub and is bootstrapped, built and packaged via rake tasks.

  1. Download and install the latest RailsInstaller.

  2. Download and install latest Inno Setup Quick Start Pack, add iscc.exe in your PATH

    C:\Program Files (x86)\Inno Setup 6\ISCC.exe 
    
  3. Fork the RailsInstaller project on github into your own GitHub account.

  4. Open the the command prompt from the start menu and change directory to where you like to keep your projects.

  5. Clone your fork of the project.

    git clone https://github.com/{{your GitHub user name}}/railsinstaller-windows.git
    cd railsinstaller-windows
  6. Update from origin master branch and checkout a new topic branch for your feature/bugfix.

    git checkout master
    git pull origin master
    git checkout -b mybranchname
  7. Bootstrap the project. From the project root run:

    rake bootstrap
  8. Implement your new feature and/or fix your bug in your newly forked Railsinstaller project code.

  • The configuration file for specifying required packages can be found at config/railsinstaller.yml.

  • Building of the installer into the stage path for packaging is implemented by Ruby code in the lib/ directory, starting with the file lib/railsinstaller/actions.rb.

  • Methods called by the actions.rb file are implemented by lib/railsinstaller/methods.rb.

  1. Next build all components onto the stage (into the stage/ directory)

    rake build
  2. Use Inno Setup to package the installer into an executable (.exe) for testing/distribution.

    Add iscc.exe in your PATH

    C:\Program Files (x86)\Inno Setup 6\ISCC.exe 
    rake package
    
  • This creates the executable (.exe) package file in the pkg/ directory from the files staged during the build process in the stage/ directory.

  • NOTE - You can run the package task with --trace for debugging output if the package fails to build or if you simply want to see what is being done as it is done).

  1. Once you have verified your new feature/bug-fix, push your branch up to GitHub.

    git commit -a -m "Implemented featureX/bugfixX which <description>..."
    git push origin mybranchname
  2. Now issue a pull request on GitHub.

About

RailsInstaller for Windows

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 51.9%
  • Inno Setup 40.7%
  • Batchfile 3.8%
  • HTML 3.6%