Installation and Setup instructions are also available in the Installation Instructions document, downloadable from the Documentation section of the Resources.

Installation

In order to run Scripture App Builder, you need to have 3 components installed on your computer:

  1. Scripture App Builder (SAB)
  2. Java SE Development Kit (JDK)
  3. Android Software Development Kit (SDK)

Here are more details on installing each of these three components.

1. Installing Scripture App Builder

Download and run the setup program to install Scripture App Builder on your computer.

2. Installing Java SE Development Kit (JDK)

Go to the Java SE Downloads page: http://www.oracle.com/technetwork/java/javase/downloads
Click on the Download button under JDK.

You will be taken to the Java SE Development Kit 8 Downloads page. There are many download files on this page. You are looking for the download that corresponds to your computer’s operating system.

  • Find the Windows x86 download if you are using 32-bit Windows.
  • Find the Windows x64 download if you are using 64-bit Windows.

You’ll need to accept the License Agreement before you download.

When the file has downloaded, run it to install the JDK on your computer.
This will normally be installed into the C:\Program Files\Java folder.

3. Installing Android Software Development Kit (SDK)

To install the Android SDK, you need the basic Android command line tools rather than the full Android Studio installation.
The installation will be done in two steps:

  • A. Download and install the basic Android command line tools.
  • B. Download and install additional packages in the SDK Manager.

A. Download and install the basic Android SDK tools
Do the following:

  1. Go to the Android SDK web page: http://developer.android.com/sdk
  2. Scroll down to the bottom of the page, where you will find a section titled ‘Get just the command line tools’.
  3. Download the latest Windows package, e.g. tools_r25.2.3-windows.zip. The file is around 290 MB.
  4. Before downloading, you will need to click to confirm you agree with the terms and conditions.
  5. When the file has downloaded, unzip it to a folder on your computer, such as C:\SDK.

When the file is unzipped, the C:\SDK folder should contain a single sub-folder named ‘tools’. You do not need to run any setup program here.

B. Download and install additional SDK packages in the SDK Manager
The Android SDK as it stands will not be sufficient to build an app. You need to use the SDK Manager to download 3 additional packages for it, namely:

  • Android SDK Platform-tools,
  • Android SDK Build-tools, and
  • Android SDK Platform.

Do the following:

  1. Open the SDK Manager program. To do this, go to where you installed the SDK and click on SDK Manager.exe. If SDK Manager does not appear (perhaps a command box appears briefly and then disappears), follow the instructions in the Troubleshooting section at the end of this document.
  2. Click the Deselect All link at the bottom of the page. You will not need to download all the packages selected by default.
  3. Select the following 3 packages:
    • Android SDK Platform-tools
    • Android SDK Build-tools (the latest version), and
    • Android 5.0.1 (API 21) – SDK Platform. (You might need to scroll down the screen to find this item if more recent and preview versions are displayed first.)


4. Click Install 3 packages…
5. Before downloading, you will need to click to confirm you accept the licence.

6. When this process is complete, you will get a confirmation message ‘Done loading packages’.
image10
7. Click Close and the SDK Manager should look like this:

8. Ensure that the 4 packages highlighted above have been installed.

The Android SDK has now been installed for use by Scripture App Builder.

How to build your first app

To build your first app with Scripture App Builder, follow the instructions in the first chapter of the document Scripture App Builder – 2 Building Apps.

Troubleshooting

When I try to launch Scripture App Builder, I get the message “Could not find the main class… Program will exit”.
This might be because your computer is running an older version of the Java Runtime Environment (JRE). Scripture App Builder requires at least Java 7. Java 6 and earlier versions are no longer being supported, so it is a good idea to upgrade your Java installation for security reasons.
You can find the download here: https://www.java.com/en/download

SDK Manager is not loading
It is not uncommon to have problems launching SDK Manager. This is normally due to path problems. SDK Manager cannot find the Java paths it needs to run. You can try some of the following ideas:

top