This document will guide you through the steps to install the Jive Apps Command Line Tools on Ubuntu Linux. 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.
$ fake command "Joe Smith"
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 & Ruby
From the terminal, run the following command to install the necessary packages:
$ sudo apt-get -y install build-essential git-core ruby1.8-dev rubygems1.8 ruby1.8 ri1.8 rdoc1.8 irb1.8 libreadline-ruby1.8 libruby1.8 libopenssl-ruby
3. Configure Git
Configure the following options in Git using the Terminal:
$ 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. Update your PATH
Ubuntu Linux does not automatically add the Ruby binaries to the PATH. Add this line to your ~/.bash_profile or ~/.bashrc file.
6. 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.