[MOBILE-4503] Add a Jetpack Glance widget to the sample app (#1450)

* minor sample tidying, fix warning in DeviceTagSelector

* Add glance widget to sample app

* Launch app on widget tap

* spots

Author: jyaganeh

gradle/libs.versions.toml

@@ -15,6 +15,7 @@ ktlint = '1.1.1'
 # Kotlin
 kotlin = '1.9.21'
 kotlinx-coroutines = '1.7.3'
+kotlinx-serialization = '1.6.3' # Only used in Sample app
 
 # Compose
 compose-bom = '2024.02.02'
@@ -34,6 +35,9 @@ androidx-fragment = '1.6.2'
 androidx-lifecycle = '2.7.0'
 androidx-navigation = '2.7.7'
 
+# Using the RC to test the new features from I/O 2024 (Scaffold, TitleBar, LazyColumn, etc.)
+androidx-glance = '1.1.0-rc01' # Only used in Sample app
+
 androidx-activity-compose = '1.8.2'
 
 androidx-paging = '2.1.2'
@@ -92,6 +96,7 @@ dokka = '1.9.20'
 android-application = { id = 'com.android.application', version.ref = "androidGradlePlugin" }
 android-library = { id = 'com.android.library', version.ref = "androidGradlePlugin" }
 kotlin-allopen = { id = 'org.jetbrains.kotlin.plugin.allopen', version.ref = "kotlin" }
+kotlinx-serialization = { id = 'org.jetbrains.kotlin.plugin.serialization', version.ref = "kotlin" }
 google-services = { id = 'com.google.gms.google-services', version.ref = "googleServicesPlugin" }
 spotless = { id = 'com.diffplug.spotless', version.ref = "spotlessPlugin" }
 benmanes-versions = { id = 'com.github.ben-manes.versions', version.ref = "gradle-versions" }
@@ -103,6 +108,7 @@ kotlin-stdlib = { module = "org.jetbrains.kotlin:kotlin-stdlib", version.ref = "
 kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "kotlinx-coroutines"}
 kotlinx-coroutines-android = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-android", version.ref = "kotlinx-coroutines"}
 kotlinx-coroutines-test = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-test", version.ref = "kotlinx-coroutines"}
+kotlinx-serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "kotlinx-serialization" }
 
 # Compose
 compose-bom = { module = "androidx.compose:compose-bom", version.ref = "compose-bom" }
@@ -116,6 +122,11 @@ compose-ui-tooling-preview = { module = "androidx.compose.ui:ui-tooling-preview"
 compose-ui-test-manifest = { module = "androidx.compose.ui:ui-test-manifest" }
 compose-ui-test-junit4 = { module = "androidx.compose.ui:ui-test-junit4" }
 compose-material3 = { module = "androidx.compose.material3:material3" }
+compose-material = { module = "androidx.compose.material:material" }
+
+# Glance
+glance-appwidget = { module = "androidx.glance:glance-appwidget", version.ref = "androidx-glance" }
+glance-material3 = { module = "androidx.glance:glance-material3", version.ref = "androidx-glance" }
 
 # Androidx
 androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "androidx-activity-compose" }

sample/build.gradle

@@ -2,6 +2,7 @@ plugins {
     id 'com.android.application'
     id 'kotlin-android'
     id 'kotlin-kapt'
+    alias(libs.plugins.kotlinx.serialization)
 }
 
 android {
@@ -22,6 +23,11 @@ android {
     buildFeatures {
         dataBinding = true
         buildConfig = true
+        compose = true
+    }
+
+    composeOptions {
+        kotlinCompilerExtensionVersion = libs.versions.compose.compiler.get()
     }
 
     buildTypes {
@@ -47,6 +53,12 @@ android {
 }
 
 dependencies {
+    // Kotlin
+    implementation(libs.kotlinx.coroutines.android)
+    implementation(libs.kotlinx.coroutines.core)
+    implementation(libs.kotlinx.serialization.json)
+
+    // Jetpack
     implementation(libs.androidx.appcompat)
     implementation(libs.google.material)
     implementation(libs.androidx.preference)
@@ -58,6 +70,9 @@ dependencies {
     implementation(libs.playservices.instantapps)
     implementation(libs.playservices.location)
 
+    // Jetpack Glance
+    implementation(libs.glance.appwidget)
+
     // Airship ADM
     implementation project(':urbanairship-adm')
 

sample/src/main/AndroidManifest.xml

@@ -5,8 +5,9 @@
     <dist:module dist:instant="true" />
 
     <!-- Optional: Needed if using location in Airship. -->
-    <!-- Use "android.permission.ACCESS_COARSE_LOCATION" instead if GPS access is not necessary -->
+    <!-- Use only "android.permission.ACCESS_COARSE_LOCATION" if GPS access is not necessary -->
     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
 
     <application
         android:name="com.urbanairship.sample.SampleApplication"
@@ -44,6 +45,16 @@
             </intent-filter>
         </activity>
 
+        <receiver android:name=".glance.SampleAppWidgetReceiver"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+            </intent-filter>
+            <meta-data
+                android:name="android.appwidget.provider"
+                android:resource="@xml/sample_widget_info" />
+        </receiver>
+
     </application>
 
 </manifest>

sample/src/main/java/com/urbanairship/sample/CustomLiveUpdate.java

@@ -12,6 +12,7 @@
 import com.urbanairship.UAirship;
 import com.urbanairship.liveupdate.LiveUpdateManager;
 import com.urbanairship.messagecenter.MessageCenter;
+import com.urbanairship.sample.glance.SampleAppWidgetLiveUpdate;
 
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
@@ -55,6 +56,7 @@ public void onAirshipReady(@NonNull UAirship airship) {
         // Register handlers for Live Updates.
         LiveUpdateManager.shared().register("sports", new SampleLiveUpdate());
         LiveUpdateManager.shared().register("sports-async", new SampleAsyncLiveUpdate());
+        LiveUpdateManager.shared().register("medals-widget", new SampleAppWidgetLiveUpdate());
 
         MessageCenter.shared().setOnShowMessageCenterListener(messageId -> {
             // Use an implicit navigation deep link for now as explicit deep links are broken