Adding views snippets module with Generated Preview samples (#384)

* Adding views snippets module with Generated Preview samples

* fixup

---------

Co-authored-by: Summers Pittman <mrsummers@google.com>

gradle/libs.versions.toml

@@ -11,7 +11,7 @@ androidx-coordinator-layout = "1.2.0"
 androidx-corektx = "1.13.1"
 androidx-emoji2-views = "1.5.0"
 androidx-fragment-ktx = "1.8.4"
-androidx-glance-appwidget = "1.1.0"
+androidx-glance-appwidget = "1.1.1"
 androidx-lifecycle-compose = "2.8.6"
 androidx-lifecycle-runtime-compose = "2.8.6"
 androidx-navigation = "2.8.2"

settings.gradle.kts

@@ -27,4 +27,6 @@ include(
         ":kotlin",
         ":compose:snippets",
         ":wear",
+        ":views",
 )
+

views/.gitignore

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

views/README.md

@@ -0,0 +1 @@
+This is a sample project that contains the code snippets seen on  https://android.devsite.corp.google.com/develop/ui/views

views/build.gradle.kts

@@ -0,0 +1,56 @@
+//Copyright 2024 The Android Open Source Project
+//
+//        Licensed under the Apache License, Version 2.0 (the "License");
+//you may not use this file except in compliance with the License.
+//You may obtain a copy of the License at
+//
+//https://www.apache.org/licenses/LICENSE-2.0
+//
+//Unless required by applicable law or agreed to in writing, software
+//distributed under the License is distributed on an "AS IS" BASIS,
+//WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//See the License for the specific language governing permissions and
+//        limitations under the License.
+
+plugins {
+    alias(libs.plugins.android.library)
+    alias(libs.plugins.kotlin.android)
+}
+
+android {
+    namespace = "com.example.example.snippet.views"
+    compileSdk = 35
+
+    defaultConfig {
+        minSdk = 35
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles("consumer-rules.pro")
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_1_8
+    }
+    kotlinOptions {
+        jvmTarget = "1.8"
+    }
+}
+
+dependencies {
+
+    implementation(libs.androidx.core.ktx)
+    implementation(libs.androidx.appcompat)
+    implementation(libs.google.android.material)
+    implementation(libs.androidx.glance.appwidget)
+
+}

views/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# 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 *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

views/src/main/AndroidManifest.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+ Copyright 2024 The Android Open Source Project
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+
+-->
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+</manifest>

views/src/main/java/com/example/example/snippet/views/appwidget/AppWidgetSnippets.kt

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2024 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.example.snippet.views.appwidget
+
+import android.appwidget.AppWidgetManager
+import android.appwidget.AppWidgetProvider
+import android.appwidget.AppWidgetProviderInfo
+import android.content.ComponentName
+import android.content.Context
+import android.widget.RemoteViews
+import androidx.glance.GlanceId
+import androidx.glance.appwidget.GlanceAppWidget
+import androidx.glance.appwidget.compose
+import com.example.example.snippet.views.R
+
+class ExampleAppWidget:GlanceAppWidget() {
+    override suspend fun provideGlance(context: Context, id: GlanceId) {
+        TODO("Not yet implemented")
+    }
+
+}
+
+private object GeneratedPreviewWithoutGlance {
+
+    lateinit var appContext: Context
+
+    fun MyWidgetPreview() {
+        // [START android_view_appwidget_generatedpreview_with_remoteview]
+        AppWidgetManager.getInstance(appContext).setWidgetPreview(
+            ComponentName(
+                appContext,
+                ExampleAppWidgetReceiver::class.java
+            ),
+            AppWidgetProviderInfo.WIDGET_CATEGORY_HOME_SCREEN,
+            RemoteViews("com.example", R.layout.widget_preview)
+        )
+        // [END android_view_appwidget_generatedpreview_with_remoteview]
+    }
+
+     suspend fun MyGlanceWidgetPreview() {
+        // [START android_view_appwidget_generatedpreview_with_glance]
+        AppWidgetManager.getInstance(appContext).setWidgetPreview(
+            ComponentName(
+                appContext,
+                ExampleAppWidgetReceiver::class.java
+            ),
+            AppWidgetProviderInfo.WIDGET_CATEGORY_HOME_SCREEN,
+            ExampleAppWidget().compose(
+                context = appContext
+            ),
+        )
+
+        // [END android_view_appwidget_generatedpreview_with_glance]
+    }
+}
+
+class ExampleAppWidgetReceiver: AppWidgetProvider() {
+
+}

views/src/main/res/layout/widget_preview.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+
+  Copyright 2024 The Android Open Source Project
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+
+-->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="horizontal">
+
+</LinearLayout>