Jive Apps Command Line Tools - Apple Mac OS X Installation Instructions

Version 3

    Overview

     

    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.

     

    Legend

    • 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.

     

    Installation Steps:

     

    1. Mandatory pre-requisite:  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

     

    1. Go to the Git for OS X homepage.
    2. Follow the link to "Download the packages here."
    3. Download "git-1.7.4-x86_64-leopard.dmg" (or newer if available.)
    4. Open the dmg package, it should mount and open a directory.
    5. Double click to run "git-1.7.4-x86_64-leopard.pkg"
    6. Welcome to the Git Installer - Click "Continue."
    7. Standard Install on "Macintosh HD" - Click "Install."
    8. Enter your password and click "OK."
    9. Installing git... wait for it to complete.
    10. Install Succeeded - Click "Close".
    11. 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 "your_email@youremail.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 "your_email@youremail.com"

    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.