This document will guide you through the steps to install the Jive Apps Command Line Tools on a Windows machine. These tools utilize the Ruby programming language and the Git version control system, so we will need to install these as well.
- This is a step-by-step tutorial. You need to substitute your own values in the various steps below.
- Text in the comment-style boxes represents commands you will enter.
1. Mandatory Prerequisite: Create your account via the Dev Center
The account credentials you enter when you create your account are used to create your login for the command line tools and the sandboxes. If you are not already signed up, click on the link above; if someone from your company has already created a company account, please have them add you to that account; do not create another account as you will not be able to share/collaborate on the App and its submission.
2. Install Git
- Go to the Git for Windows (msysgit) homepage.
- Click link to download "Git-1.7.4-preview20110204.exe" (or newer if available)
- Download and run this file, the Git Setup Wizard should start
- Welcome to the Git Setup Wizard - Click "Next"
- GNU General Public License - Click "Next"
- Setup will install Git into the following folder - Accept Default "C:\Program Files (x86)\Git" - Click "Next"
- Select Components - Please check next to "Git Bash Here", then Click "Next"
- Select Start Menu Folder - Accept Default "Git", No Changes, Click "Next"
- Adjusting Your Path Environment - Accept Default "Use Git Bash Only", Click "Next"
- Configuring the line ending conventions - Accept Default "Checkout Windows-style, commit Unix Style", Click "Next"
- It should now extract all files, wait for it to complete.
- Completing the Git Setup Wizard, click "Finish"
Note: All remaining commands should be run from the Git Bash Shell.
3. Configure Git
From the Git Bash Shell, configure your name and email address in Git by running these commands.
$ git config --global user.name "FirstName LastName"
$ git config --global user.email "email@example.com"
4. Generate SSH Keys
Generate an SSH key pair if you don't already have one. From the Git Bash Shell, run this command. Press Enter at all prompts. No passphrase is needed provided you do not distribute your key files.
$ ssh-keygen -t rsa -C "firstname.lastname@example.org"
5. Install Ruby
- Go to the Ruby Installer for Windows homepage.
- Click "Download"
- Choose Ruby 1.9.2 (currently Ruby 1.9.2-p180)
- Download and run this file, the Ruby Setup Wizard should start
- Welcome to the Ruby 1.9.2-p180 Installer. Click "Next"
- Ruby 1.9.2-p136 License Agreement. Click "I Accept the License", then Click "Next"
- Installation Destination and Optional Tasks.
- Accept Default Location: "C:\Ruby192"
- Check "Add Ruby executables to your PATH"
- Check "Associate .rb and .rbw files with this installation"
- Click "Next"
- Extracting files... Wait for this to finish.
- Completing the Ruby 1.9.2-p180 Setup Wizard. Click "Finish".
6. Install the Jive Apps Command Line Tools Gem
First, close and reopen the Git Bash Shell to reload the environment, then install the gem by running this command:
$ gem install jiveapps
Note: For Windows, you must currently use the Git Bash Shell for all Jive Apps commands. This shell uses unix style commands, like "ls" instead of "dir".
Now you are ready to start creating apps! Proceed to the Creating a Basic "Hello World" App tutorial.