Getting Started

Overview

This sections explains the prerequisites and procedures required to start working on the BBCT code. If you encounter any problems with any of the steps below, please email us at bbct-list@lists.sourceforge.net.

Prerequisites

You must download and install the following applications to access and compile the BBCT code:

2. Git
3. Java JDK version 7 or later
4. Android Studio

First steps

After installing the Prerequisites,

1. Create a GitHub account.
2. Fork the BBCT repository.

Clone your GitHub repo to a local repository

1. Ensure that you have the git installed on your local system. See Prerequisites.
2. Open Git Gui.
3. Click Click Clone Existing Repository.
4. Obtain the source repository URL: a. Log into your git hub account. b. In HTTPS clone URL, copy the URL.
5. In Source Location, in Git Gui, paste the source repository URL.
6. In Target Location, in Git Gui, define the location of your local repository. Note: Ensure that the local repository folder does not already exist.
7. Click Clone to download the BBCT code to the local repository.

Install Android SDK with Android Studio

1. Ensure that you have installed the Java SDK and Android Studio on your local system. See Prerequisites.
2. Start Android Studio.
3. On the first dialog box "Complete Installation", click OK.
4. Wait for the Android Studio splash screen.
5. In the Welcome wizard, click Next several times until you reach the License Agreement.
6. Click on the Accept radio button and then click the Finish button.
7. Wait for the SDK download to finish.
8. Click Finish

Import the source code into Android Studio

1. Ensure that you have installed the Java SDK and Android Studio on your local system. See Prerequisites.
2. Ensure that you have installed the Android SDK. See Install Android SDK with Android Studio.
3. Start Android Studio.
4. In the Android Studio Setup Wizard, click "Check out project from Version Control" and select GitHub from the drop down list.
5. Enter your username and password which you created in First Steps and click on Login.
6. In the Setup Master Password dialgo, enter a master password if you wish Android Studio to store your GitHub password. This will allow Android Studio to log into GitHub automatically when you push or pull changes. Note that this step is optional. You can leave the master password blank if you do not want to use this feature.
7. In the Clone Repository dialog, first select your clone of the BBCT repository. The URL should look something like https://github.com/${username}/bbct.git.
8. Now choose a Parent Directory where your local repository will be stored. It may be necessary for you to use a file system management tool, such as Windows Explorer to create this directory. Note that a folder named bbct will be created inside the parent directory which you select. You do not need to create the bbct folder manually as Android Studio will do this for you.
9. Click Clone.
10. In the Checkout From Version Control dialog box, click No.
11. In the Android Studio Setup Wizard, click Open an existing Android Studio project.
12. In the Open File or Project dialog box, navigate to the parent directory which you created earlier and expand the bbct subfolder.
13. Select the gradle subfolder and click OK.
14. Close the Tip of the Day.