Merge pull request #111 from Omega-R/feature/timer_intent_builder

Feature/timer intent builder

Author: anton-knyazev

core/src/main/AndroidManifest.xml

@@ -5,6 +5,7 @@
     <uses-permission android:name="android.permission.INTERNET"/>
     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+    <uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
 
     <application>
         <provider

core/src/main/java/com/omega_r/libs/omegaintentbuilder/OmegaIntentBuilder.kt

@@ -14,6 +14,8 @@ package com.omega_r.libs.omegaintentbuilder
 import android.app.Activity
 import android.app.Service
 import android.net.Uri
+import android.os.Build
+import androidx.annotation.RequiresApi
 import com.omega_r.libs.omegaintentbuilder.builders.*
 import com.omega_r.libs.omegaintentbuilder.builders.pick.PickBuilder
 import com.omega_r.libs.omegaintentbuilder.builders.share.EmailIntentBuilder
@@ -141,6 +143,13 @@ object OmegaIntentBuilder {
     @JvmStatic
     fun insertContact() = InsertContactIntentBuilder()
 
+    /**
+     * @return AlarmIntentBuilder
+     */
+    @JvmStatic
+    @RequiresApi(Build.VERSION_CODES.KITKAT)
+    fun createTimer() = TimerIntentBuilder()
+
     /**
      * @return SearchWebIntentBuilder
      */

core/src/main/java/com/omega_r/libs/omegaintentbuilder/builders/TimerIntentBuilder.kt

@@ -0,0 +1,67 @@
+package com.omega_r.libs.omegaintentbuilder.builders
+
+import android.content.Context
+import android.content.Intent
+import android.provider.AlarmClock.*
+
+class TimerIntentBuilder : BaseActivityBuilder() {
+    private var message: String? = null
+    private var seconds: Int? = null
+    private var skipUI: Boolean? = null
+
+    /**
+     * Set custom message for the timer.
+     * <p>
+     * The value is a {@link String}.
+     * </p>
+     *
+     * @param message String
+     * @return This TimerIntentBuilder for method chaining
+     */
+    fun message(message: String): TimerIntentBuilder {
+        this.message = message
+        return this
+    }
+
+    /**
+     * Set the length of the timer in seconds.
+     *
+     * @param seconds String
+     * @return This TimerIntentBuilder for method chaining
+     */
+    fun seconds(seconds: Int): TimerIntentBuilder {
+        this.seconds = seconds
+        return this
+    }
+
+    /**
+     * Bundle extra: Whether or not to display an activity after performing the action.
+     * If true, the application is asked to bypass any intermediate UI. If false, the application
+     * may display intermediate UI like a confirmation dialog or settings.
+     *
+     * @param skipUI Boolean
+     * @return This TimerIntentBuilder for method chaining
+     */
+    fun skipUI(skipUI: Boolean): TimerIntentBuilder {
+        this.skipUI = skipUI
+        return this
+    }
+
+    override fun createIntent(context: Context): Intent {
+        return Intent(ACTION_SET_TIMER).apply {
+            message?.let {
+                putExtra(EXTRA_MESSAGE, it)
+            }
+
+            seconds?.let {
+                putExtra(EXTRA_LENGTH, it)
+            }
+
+            skipUI?.let {
+                putExtra(EXTRA_SKIP_UI, it)
+            }
+
+        }
+    }
+
+}

examples/src/main/java/com/omega_r/omegaintentbuilder/MainActivity.java

@@ -287,4 +287,12 @@ private void onSearchWebClicked() {
                 .startActivity(this);
     }
 
+    private void onCreateTimerClicked() {
+        OmegaIntentBuilder
+                .createTimer()
+                .message("It's your timer")
+                .seconds(5)
+                .startActivity(this);
+    }
+
 }

examples/src/main/res/layout/activity_main.xml

@@ -153,6 +153,13 @@
             android:theme="@style/ButtonStyle"
             android:text="@string/insert_contact"/>
 
+        <Button
+            android:id="@+id/button_create_timer"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:theme="@style/ButtonStyle"
+            android:text="@string/create_timer"/>
+
     </LinearLayout>
 
 </androidx.core.widget.NestedScrollView>

examples/src/main/res/values/strings.xml

@@ -21,6 +21,7 @@
     <string name="service_extra">Extras to Service</string>
     <string name="title_activity_tab">TabActivity</string>
     <string name="fragment_extra">Extras to Fragment</string>
+    <string name="create_timer">Create Timer</string>
     <string name="insert_contact">Insert Contact</string>
     <string name="search_web">Search Web</string>
 </resources>