Added Job Scheduler

Author: Paul Ruiz

AndroidWearDigitalWatchFace/README.md

@@ -0,0 +1,7 @@
+### Tuts+ article: Using the Android JobScheduler
+
+### Instructor: Paul Trebilcox-Ruiz
+
+The JobScheduler API was introduced in Android Lollipop, and is used for batching and scheduling future tasks that run in the background of the device when certain conditions are met. 
+
+Available March 2015 on TutsPlus.com

JobScheduler/README.md

@@ -0,0 +1 @@
+/build

JobScheduler/app/.gitignore

@@ -0,0 +1,24 @@
+apply plugin: 'com.android.application'
+
+android {
+    compileSdkVersion 21
+    buildToolsVersion "21.1.2"
+
+    defaultConfig {
+        applicationId "com.tutsplus.jobscheduler"
+        minSdkVersion 21
+        targetSdkVersion 21
+        versionCode 1
+        versionName "1.0"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+    compile fileTree(dir: 'libs', include: ['*.jar'])
+}

JobScheduler/app/build.gradle

@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in /Users/paulruiz/Library/Android/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}

JobScheduler/app/proguard-rules.pro

@@ -0,0 +1,13 @@
+package com.tutsplus.jobscheduler;
+
+import android.app.Application;
+import android.test.ApplicationTestCase;
+
+/**
+ * <a href="http://d.android.com/tools/testing/testing_android.html">Testing Fundamentals</a>
+ */
+public class ApplicationTest extends ApplicationTestCase<Application> {
+    public ApplicationTest() {
+        super(Application.class);
+    }
+}

JobScheduler/app/src/androidTest/java/com/tutsplus/jobscheduler/ApplicationTest.java

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.tutsplus.jobscheduler" >
+
+    <application
+        android:allowBackup="true"
+        android:icon="@drawable/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/AppTheme" >
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name" >
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+
+        <service android:name=".JobSchedulerService"
+            android:permission="android.permission.BIND_JOB_SERVICE" />
+    </application>
+
+</manifest>

JobScheduler/app/src/main/AndroidManifest.xml

@@ -0,0 +1,35 @@
+package com.tutsplus.jobscheduler;
+
+import android.app.job.JobParameters;
+import android.app.job.JobService;
+import android.os.Handler;
+import android.os.Message;
+import android.widget.Toast;
+
+/**
+ * Created by paulruiz on 3/7/15.
+ */
+public class JobSchedulerService extends JobService {
+
+    private Handler mJobHandler = new Handler( new Handler.Callback() {
+        @Override
+        public boolean handleMessage( Message msg ) {
+            Toast.makeText( getApplicationContext(), "JobService task running", Toast.LENGTH_SHORT ).show();
+            jobFinished( (JobParameters) msg.obj, false );
+            return true;
+        }
+    } );
+
+    @Override
+    public boolean onStartJob(JobParameters params ) {
+        mJobHandler.sendMessage( Message.obtain( mJobHandler, 1, params ) );
+        return true;
+    }
+
+    @Override
+    public boolean onStopJob( JobParameters params ) {
+        mJobHandler.removeMessages( 1 );
+        return false;
+    }
+
+}

JobScheduler/app/src/main/java/com/tutsplus/jobscheduler/JobSchedulerService.java

@@ -0,0 +1,51 @@
+package com.tutsplus.jobscheduler;
+
+import android.app.Activity;
+import android.app.job.JobInfo;
+import android.app.job.JobScheduler;
+import android.content.ComponentName;
+import android.content.Context;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+
+
+public class MainActivity extends Activity {
+
+    private JobScheduler mJobScheduler;
+    private Button mScheduleJobButton;
+    private Button mCancelAllJobsButton;
+
+    @Override
+    protected void onCreate( Bundle savedInstanceState ) {
+        super.onCreate( savedInstanceState );
+        setContentView( R.layout.activity_main );
+        mJobScheduler = (JobScheduler) getSystemService( Context.JOB_SCHEDULER_SERVICE );
+        mScheduleJobButton = (Button) findViewById( R.id.schedule_job );
+        mCancelAllJobsButton = (Button) findViewById( R.id.cancel_all );
+
+        mScheduleJobButton.setOnClickListener( new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                JobInfo.Builder builder = new JobInfo.Builder( 1,
+                        new ComponentName( getPackageName(), JobSchedulerService.class.getName() ) );
+
+                builder.setPeriodic( 3000 );
+
+
+                if( mJobScheduler.schedule( builder.build() ) <= 0 ) {
+                    //If something goes wrong
+                }
+            }
+        });
+
+        mCancelAllJobsButton.setOnClickListener( new View.OnClickListener() {
+            @Override
+            public void onClick( View v ) {
+                mJobScheduler.cancelAll();
+            }
+        });
+    }
+}

JobScheduler/app/src/main/java/com/tutsplus/jobscheduler/MainActivity.java

@@ -0,0 +1,18 @@
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical">
+
+    <Button
+        android:id="@+id/schedule_job"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Schedule Job"/>
+
+    <Button
+        android:id="@+id/cancel_all"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Cancel All"/>
+
+</LinearLayout>

JobScheduler/app/src/main/res/drawable-hdpi/ic_launcher.png

@@ -0,0 +1,5 @@
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" tools:context=".MainActivity">
+    <item android:id="@+id/action_settings" android:title="@string/action_settings"
+        android:orderInCategory="100" android:showAsAction="never" />
+</menu>

JobScheduler/app/src/main/res/drawable-mdpi/ic_launcher.png

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="android:Theme.Material.Light">
+    </style>
+</resources>

JobScheduler/app/src/main/res/drawable-xhdpi/ic_launcher.png

@@ -0,0 +1,6 @@
+<resources>
+    <!-- Example customization of dimensions originally defined in res/values/dimens.xml
+         (such as screen margins) for screens with more than 820dp of available width. This
+         would include 7" and 10" devices in landscape (~960dp and ~1280dp respectively). -->
+    <dimen name="activity_horizontal_margin">64dp</dimen>
+</resources>

JobScheduler/app/src/main/res/drawable-xxhdpi/ic_launcher.png

@@ -0,0 +1,5 @@
+<resources>
+    <!-- Default screen margins, per the Android Design guidelines. -->
+    <dimen name="activity_horizontal_margin">16dp</dimen>
+    <dimen name="activity_vertical_margin">16dp</dimen>
+</resources>

JobScheduler/app/src/main/res/layout/activity_main.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">JobScheduler</string>
+    <string name="hello_world">Hello world!</string>
+    <string name="action_settings">Settings</string>
+
+</resources>

JobScheduler/app/src/main/res/menu/menu_main.xml

@@ -0,0 +1,8 @@
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="AppTheme" parent="android:Theme.Holo.Light.DarkActionBar">
+        <!-- Customize your theme here. -->
+    </style>
+
+</resources>

JobScheduler/app/src/main/res/values-v21/styles.xml

@@ -0,0 +1,19 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+
+buildscript {
+    repositories {
+        jcenter()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:1.0.0'
+
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle files
+    }
+}
+
+allprojects {
+    repositories {
+        jcenter()
+    }
+}

JobScheduler/app/src/main/res/values-w820dp/dimens.xml

@@ -0,0 +1,18 @@
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+# Default value: -Xmx10248m -XX:MaxPermSize=256m
+# org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true

JobScheduler/app/src/main/res/values/dimens.xml

@@ -0,0 +1,6 @@
+#Wed Apr 10 15:27:10 PDT 2013
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-2.2.1-all.zip