Building and running tests with Android
The easiest way to build libaddressinput for Android and run all the tests is
to use Gradle:
https://developer.android.com/build
http://www.gradle.org/
Prerequisite dependencies for using Gradle with Android
Android Studio: https://developer.android.com/sdk/index.html (recommended)
- Check Tools > SDK Manager.
Android SDK Tools: https://developer.android.com/sdk/index.html#Other
- Set the ANDROID_HOME environment variable to the root of the SDK.
Ensure the following packages are installed:
- Tools/Android SDK Platform-tools (Rev. 35.0.1)
- Android 14 (API 34)
- Extras/Android Support Library
After installing all the prerequisites, check that everything is working by
building the package and running the tests in Android Studio. Alternatively, the
following can be run by command line:
gradlew build
With an Android emulator running or an Android device connected, the following
command line then builds the library and runs the tests:
gradlew connectedAndroidTest
The test runner logs to the system log, which can be viewed using logcat:
adb logcat
Integrating with Android Apps
-
Clone libaddressinput from Github or download and unzip to a folder called 'libaddressinput'.
-
From a terminal window, change into the folder: cd libaddressinput/
-
Build the widget and library via gradle:
gradlew build
-
Copy the widget and the common libraries:
cp android/build/outputs/aar/android-release.aar path/to/project/app/libs/
cp common/build/libs/common.jar path/to/project/app/libs/
Note: Be sure top replace 'path/to/project' with the name of your project.
-
Import both modules into your app.
Note: If you use Android Studio, check out the user guide and follow the instructions under 'Add your library as a dependency'. Be sure to add both modules as dependencies of the app.
-
Add the widget to your app. Note: This Assumes a default empty project configuration:
i. In activity_main.xml add:
<LinearLayout
android:id="@+id/addresswidget"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"/>
ii. In MainActivity.java add the following import statements:
import android.view.ViewGroup;
import com.android.i18n.addressinput.AddressWidget;
import com.google.i18n.addressinput.common.FormOptions;
import com.google.i18n.addressinput.common.ClientCacheManager;
import com.google.i18n.addressinput.common.SimpleClientCacheManager;
iii. Define the widget on the object scope
private AddressWidget addressWidget;
iv. Add the widget to the ViewGroup
ViewGroup viewGroup = (ViewGroup) findViewById(R.id.addresswidget);
FormOptions defaultFormOptions = new FormOptions();
ClientCacheManager cacheManager = new SimpleClientCacheManager();
this.addressWidget = new AddressWidget(this, viewGroup, defaultFormOptions, cacheManager);
Example:
package com.example.google.widgetdemo;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.ViewGroup;
import com.android.i18n.addressinput.AddressWidget;
import com.google.i18n.addressinput.common.FormOptions;
import com.google.i18n.addressinput.common.ClientCacheManager;
import com.google.i18n.addressinput.common.SimpleClientCacheManager;
public class MainActivity extends AppCompatActivity {
private AddressWidget addressWidget;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ViewGroup viewGroup = (ViewGroup) findViewById(R.id.addresswidget);
FormOptions defaultFormOptions = new FormOptions();
ClientCacheManager cacheManager = new SimpleClientCacheManager();
this.addressWidget = new AddressWidget(this, viewGroup, defaultFormOptions, cacheManager);
}
}