This document will guide you through the steps to install the Jive Apps Command Line Tools on Apple Macintosh OS X 10.6 Snow Leopard. 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. Sign up for the Jive Apps Developer Community.
You are probably already signed up if you are viewing this document. The command line tools and the sandbox use the same username and password as the community.
2. Install Git
- Go to the Git for OS X homepage.
- Follow the link to "Download the packages here."
- Download "git-1.7.4-x86_64-leopard.dmg" (or newer if available.)
- Open the dmg package, it should mount and open a directory.
- Double click to run "git-1.7.4-x86_64-leopard.pkg"
- Welcome to the Git Installer - Click "Continue."
- Standard Install on "Macintosh HD" - Click "Install."
- Enter your password and click "OK."
- Installing git... wait for it to complete.
- Install Succeeded - Click "Close".
- Reboot your system for the installation changes to take affect
3. Configure Git
Configure the following options in Git using the Terminal app:
$ 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 Terminal, 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 the Jive Apps Command Line Tools Gem
From the Terminal, install the gem by running this command:
$ sudo gem install jiveapps
Now you are ready to start creating apps! Proceed to the Creating a Basic "Hello World" App tutorial.