Jetpack架构组件学习——使用Glance实现桌面小组件

根本使用


1.添加依靠


添加Glance依靠:

1. // For AppWidgets support
2.    implementation "androidx.glance:glance-appwidget:1.1.0"
4.    // For interop APIs with Material 3
5.    implementation "androidx.glance:glance-material3:1.1.0"
7.    // For interop APIs with Material 2
8.    implementation "androidx.glance:glance-material:1.1.0"

复制代码

2.正常的相干设置


xml文件夹添加小组件widget_info.xml设置:

1. <?xml version="1.0" encoding="utf-8"?>
2. <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
3.     xmlns:tools="http://schemas.android.com/tools"
4.     android:targetCellWidth="2"
5.     android:targetCellHeight="2"
6.     android:minWidth="250dp"
7.     android:minHeight="250dp"
8.     android:updatePeriodMillis="0"
9.     android:initialLayout="@layout/glance_default_loading_layout"
10.     tools:targetApi="s">
11. </appwidget-provider>

复制代码

清单文件设置:

1. <receiver android:name=".appwidgets.MyAppWidgetReceiver"
2.         android:exported="true">
3.         <intent-filter>
4.                 <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
5.         </intent-filter>
6.         <meta-data
7.                 android:name="android.appwidget.provider"
8.                 android:resource="@xml/widget_info" />
9. </receiver>

复制代码

3.创建widget对象和实现界面


必要留意的几点:

1、界面的Row,Column,Text等,留意要使用Glance的包下的,否则会无法正常表现界面

   官方也是阐明白,Row,Box,Column现实末了创建的对象对应的Linearlayout和Framelayout
  
2、点击跳转的对应actionStartActivity方法,现实是返回一个Action对象 通过GlanceModifier.clickable(actionStartActivity(MainActivity::class.java))举行对应跳转

除了activity外,还能启动Service,BoardCast,详见此文档处置惩罚用户互动 | Jetpack Compose | Android Developers

3、关于配景圆角的方法,现在接纳Box内里套一个Image和具体内容实现,Image去加载我们drawable里的矢量图对象(shape的那种)来实现

4、remember在内里可用,但如果联合animateColorAsState这种动画结果,现实上并没有用果(只是单纯的变更,没有中心过渡过程)

1. class MyAppWidgetReceiver : GlanceAppWidgetReceiver() {
2.     //MyAppWidget里就是类似我们remoteview的创建
3.     override val glanceAppWidget: GlanceAppWidget = MyAppWidget()
4. }
6. class MyAppWidget : GlanceAppWidget() {
8.     override suspend fun provideGlance(context: Context, id: GlanceId) {
10.         // In this method, load data needed to render the AppWidget.
11.         // Use `withContext` to switch to another thread for long running
12.         // operations.
13.         provideContent {
14.             val upSpeed by DataRespotiy.upSpeed.asFlow().collectAsState(initial = 0L)
15.             val downloadSpeed by DataRespotiy.downloadSpeed.asFlow().collectAsState(initial = 0L)
17.             Box(GlanceModifier.fillMaxSize()) {
18.                 Image(provider = ImageProvider(R.drawable.app_widget_bg), contentDescription = null, modifier = GlanceModifier.fillMaxSize())
20.                 Column(GlanceModifier.fillMaxSize()) {
21.                     Spacer(GlanceModifier.height(28.dp))
22.                     Row(GlanceModifier.fillMaxWidth().padding(horizontal = 20.dp)) {
23.                         androidx.glance.Image(provider = ImageProvider(R.mipmap.logo), contentDescription = null, modifier = GlanceModifier.size(108.dp))
25.                         Spacer(modifier = GlanceModifier.width(24.dp))
26.                         Column(GlanceModifier.defaultWeight()) {
27.                             Row(modifier = GlanceModifier.wrapContentHeight(), horizontalAlignment = Alignment.End, verticalAlignment = Alignment.Vertical.CenterVertically) {
28.                                 Text(text = "${upSpeed} Kb/s", style = TextStyle(color = ColorProvider(APP_Primary_color), fontSize = 22.sp))
29.                                 Spacer(modifier = GlanceModifier.width(4.dp))
30.                                 androidx.glance.Image(provider = ImageProvider(R.drawable.icon_upload_widget), contentDescription = null, modifier = GlanceModifier.size(32.dp))
31.                             }
33.                             Spacer(modifier = GlanceModifier.height(18.dp))
35.                             Row(modifier = GlanceModifier, horizontalAlignment = Alignment.End, verticalAlignment = Alignment.Vertical.CenterVertically) {
36.                                 Text(text = "${downloadSpeed} Kb/s", style = TextStyle(color = ColorProvider(APP_Bigfile_color), fontSize = 22.sp))
37.                                 Spacer(modifier = GlanceModifier.width(4.dp))
38.                                 androidx.glance.Image(provider = ImageProvider(R.drawable.icon_down_widget), contentDescription = null, modifier = GlanceModifier.size(32.dp))
39.                             }
40.                         }
41.                     }
42.                     Spacer(GlanceModifier.height(28.dp))
44.                     Box(modifier = GlanceModifier.fillMaxWidth().defaultWeight()) {
45.                         Image(provider = ImageProvider(R.drawable.app_widget_bg1), contentDescription = null, modifier = GlanceModifier.fillMaxSize())
46.                         Row(
47.                             modifier = GlanceModifier.fillMaxSize()
48.                                 .padding(horizontal = 20.dp,16.dp), horizontalAlignment = Alignment.CenterHorizontally
49.                         ) {
50.                             val modifier = GlanceModifier.defaultWeight()
51.                             //todo 不同的item类型
52.                             repeat(3) { index ->
53.                                 Row(modifier, horizontalAlignment = Alignment.CenterHorizontally, verticalAlignment = Alignment.Vertical.CenterVertically) {
54.                                     androidx.glance.Image(
55.                                         provider = ImageProvider(R.drawable.icon_net_test), contentDescription = null, modifier = GlanceModifier
56.                                             .size(108.dp)
57.                                             .clickable(actionStartActivity(MainActivity::class.java))
58.                                     )
59.                                 }
61.                                 Spacer(GlanceModifier.width(20.dp))
62.                             }
64.                         }
65.                     }
67.                 }
68.             }
70.         }
71.     }
72. }

复制代码

其他增补


更新小组件方法:

1. val manager = GlanceAppWidgetManager(application)
2. val widget = MyAppWidget()
3. val glanceIds = manager.getGlanceIds(widget.javaClass)
5. glanceIds.forEach { glanceId ->
6.         widget.update(application, glanceId)
7. }
9. //第二种方式(实际上和上面的方法是一样的,下面这个是官方给我们封装的另外个方法)
10. MyAppWidget().updateAll(application)

复制代码

   文章转载自：Stars-one
  原文链接：Jetpack架构组件学习(6)——使用Glance实现桌面小组件 - Stars-one - 博客园
  体验地点：引迈 - JNPF快速开辟平台_低代码开辟平台_零代码开辟平台_流程计划器_表单引擎_工作流引擎_软件架构