Install tools and import the WVA tutorial
This section describes how to install the required tools, and set up and import the tutorial.
Step 1: Install Java and Git
Your computer will need the following tools installed or adjusted:
- A Java Development Kit (JDK) available here. The Java Android Studio issues a warning if a JDK is not installed.
- Git, available here.
Step 2: Install Android Studio
This tutorial uses Android Studio to develop the sample application. If you do not already have Android Studio installed, please go to the Android Developer site and follow the directions to install it. Also, ensure that you have installed at least one SDK matching the Android platform you wish to target.
You should install the latest version of Android Studio, even if that version is a beta release.
If you are new to Android Studio, please review the Android build tools documentation.
Before you begin creating the application project and learning more about the WVA Library, verify that you can successfully run Android Studio without error.
Step 3: Get the WVA tutorial repository
Using Git, clone the repository https://github.com/digidotcom/wvalib_tutorial. This is optional, but allows you to refer to each step compared to what you have created or to begin directly at a particular example.
Step 4: Import the WVA tutorial into Android Studio
To import the tutorial into Android Studio, use the Import Project option on either the quick-start page of the Android Studio or under the File menu, and select the cloned repository’s root directory. By default this is wvalib_tutorial. Note that the name may be different if you cloned it to a different directory or have renamed it.
Depending on your device screen size, some text may be cut off. You can adjust the dimensions in the XML layout additions, specifically margin values, to fit the screen of the Android device being used.
The library configures the event channel of the WVA for JSON-formatted data. The format of the event channel follows the web services requests being made. Making requests for XML data independent of the library disrupts the library’s operation.