tasks-android-sample

Instructions for the Tasks V1 Android Sample

Browse Online

Browse Source, or main file TasksSample.java

Prerequisites

Install Java (requires 6 or higher)
Install Git (suggested 1.7.10 or higher) or GitHub client (Mac) (Windows)
Unzip Gradle 2.2.1
Install either Android Studio (which bundles the Android SDK) or just Android SDK if you don't want to use Android Studio. Set your ANDROID_HOME to the Android SDK installation directory, which for Android Studio is in the "sdk" subdirectory.

Register Your Application

Visit the Google Cloud console flow for the Google Tasks API.
If necessary, sign in to your Google Account, select or create a project, and agree to the terms of service. Click Continue.
For Platform select "Android".
- For "Package name" you should make up a unique name that has never been used before by anyone, e.g. using your name and date like "org.example.tasks.janedoe20130911".
  - Note: Make sure to pick a legal Java package name since we will be using it in the Android project source code. The full package name must have at least two parts, so for example "janedoe20130911" will not work.
  - Note: If you try to register a package name that has already been registered, you may get an error reading "An unexpected error has occurred." In particular, "com.google.api.services.samples.tasks.android" has already been registered, so you must change the package name.
- For "SHA1 fingerprint", use the value that is output when running this command in a Terminal:
```
keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore | openssl sha1
```
  When asked, use "android" (without the quotes) as the keystore password.
- Click Register.
Click on "APIs" under "APIs & auth" in the left sidebar and make sure "Tasks API" is enabled.

Checkout Instructions

cd [someDirectory]
git clone https://github.com/google/google-api-java-client-samples.git
cd google-api-java-client-samples/tasks-android-sample

Set Up Project in Android Studio

Run the Android SDK Manager:
- Run this command in a terminal:
```
$ANDROID_HOME/tools/android sdk
```
- Under "Tools", check on "Android SDK Build-tools" revision 22.0.1.
- Under "Android 5.1.1 (API 22)", check on "SDK Platform" and "Google APIs".
- Under "Extras", check on "Android Support Repository", "Android Support Library", and "Google Repository".
- Click on "Install X packages..."
Start Android Studio by running this command in a terminal:
```
android-studio/bin/studio.sh
```
Import tasks-android-sample project
- Select "Import Project..." or File > Import Project...
- Select [someDirectory]/google-api-java-client-samples/build.gradle and click OK.
  - Note: it will not work if you try to import [someDirectory]/google-api-java-client-samples/tasks-android-sample/build.gradle.
- Select "Use local gradle distribution" with "Gradle home" of [someDirectory]/gradle-2.2.1 and click OK.
Open AndroidManifest.xml and change the package attribute of the manifest, initially "com.google.api.services.samples.tasks.android", to match the name you registered in the Google Cloud Console, e.g. "org.example.tasks.janedoe20130911".
Rename the Java package: right-click on src/main/java, click New, click Package, and then enter the name you registered in the Google Cloud Console, e.g. "org.example.tasks.janedoe20130911". Next, select the Java classes in the package "com.google.api.services.samples.tasks.android", drag them into the new package you just created, and then click Refactor.
- Note: If you get a compile error for "R", try right-clicking on the Java package and then clicking "Optimize Imports" to remove unused imports containing the "R". Another possibility is that the "package" in the AndroidManifest.xml file doesn't match the Java package name.
Run > Run 'tasks-android-sample'
- Note: you must use a physical device for developing and testing because Google Play services cannot be installed on an emulator. Read this page for more information on how to set up a device.
- To enable logging of HTTP requests and responses (highly recommended when developing):
```
$ANDROID_HOME/platform-tools/adb shell setprop log.tag.HttpTransport DEBUG
```
  and then change TasksSample.LOGGING_LEVEL to Level.CONFIG.
- Note: If get "[Error] Access Not Configured" it usually means the Android app registration didn't work or doesn't match your app's package name and SHA1 fingerprint. It may also be because "Tasks API" isn't enabled for your project in the Google Cloud Console (see instructions above).