为AppWidget添加配置Activity

最新推荐文章于 2021-05-28 22:01:11 发布
最新推荐文章于 2021-05-28 22:01:11 发布
阅读量611 收藏
点赞数 2
分类专栏： # Android窗口小部件 Android开发 文章标签： android 窗口小部件 配置
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yingaizhu/article/details/103584902
版权

文章目录

1. 前言

    在构建自己的窗口小部件的时候，为了更加定制化，会根据用户的喜好，让用户选择小部件的样式等，这种情况下，就需要为窗口小部件添加一个配置页面了。在用户添加窗口小部件的时候，会弹出配置页面，让用户根据自己的喜好配置小部件的样式等等属性。

2. 实现步骤

更多实现细节及注意事项请参考Google官方介绍：Creating an App Widget Configuration Activity

关于构建AppWidget相关内容参考：为你的Android应用构建窗口小部件（App Widget）

2.1 新建Activity及布局文件

    新建一个Activity及布局文件，并在内部实现相关代码

  • 新建配置Activity
package com.owen.clockwidget

import android.app.Activity
import android.appwidget.AppWidgetManager
import android.content.Context
import android.content.Intent
import android.content.SharedPreferences
import android.graphics.Color
import android.os.Bundle
import android.widget.RadioGroup
import android.widget.SeekBar
import kotlinx.android.synthetic.main.activity_config.*
import java.time.Clock

/**
 * 配置Activity
 * <br/>Author：yunying.zhang
 * <br/>Email: yinglovezhuzhu@gmail.com
 * <br/>Date: 2019/12/17
 */
class ConfigActivity: Activity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_config)
        val sp = getSharedPreferences("sp_widget_config", Context.MODE_PRIVATE)
        val appWidgetId = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, 0)

        sp.edit().putInt("${appWidgetId}_bg_color", Color.BLACK).apply()
        sp.edit().putInt("${appWidgetId}_bg_alpha", 100).apply()

        btnOk.setOnClickListener() {
            setResult(RESULT_OK, Intent().also {
                it.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId)
            })

            ClockWidgetProvider.updateWidget(this)

            finish()
        }

        btnCancel.setOnClickListener() {
            setResult(RESULT_CANCELED)
            finish()
        }

        colorGroup.setOnCheckedChangeListener() { group: RadioGroup, checkedId: Int -> UInt
            when(checkedId) {
                R.id.blue -> {
                    println("选择了蓝色背景")
                    sp.edit().putInt("${appWidgetId}_bg_color", Color.argb(0xff, 0x33, 0xb5, 0xe5)).apply()
                }
                R.id.gray -> {
                    println("选择了灰色背景")
                    sp.edit().putInt("${appWidgetId}_bg_color", Color.argb(0xff, 0xaa, 0xaa, 0xaa)).apply()
                }
                R.id.green -> {
                    println("选择了绿色背景")
                    sp.edit().putInt("${appWidgetId}_bg_color", Color.argb(0xff, 0x99, 0xcc, 0x00)).apply()
                }
                R.id.white -> {
                    println("选择了白色背景")
                    sp.edit().putInt("${appWidgetId}_bg_color", Color.argb(0xff, 0xff, 0xff, 0xff)).apply()
                }
            }
        }

        seekBar.setOnSeekBarChangeListener(object: SeekBar.OnSeekBarChangeListener {
            override fun onProgressChanged(seekBar: SeekBar?, progress: Int, fromUser: Boolean) {
                tvBgAlpha.text = "背景透明度：${progress}%"
                sp.edit().putInt("${appWidgetId}_bg_alpha", progress).apply()
            }

            override fun onStartTrackingTouch(seekBar: SeekBar?) {
            }

            override fun onStopTrackingTouch(seekBar: SeekBar?) {
            }
        })

        tvBgAlpha.text = "背景透明度：${seekBar.progress}%"
        sp.edit().putInt("${appWidgetId}_bg_alpha", seekBar.progress).apply()

    }
}
  • 布局文件
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/transparent"
    android:weightSum="2"
    android:gravity="bottom">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:orientation="vertical"
        android:layout_gravity="bottom"
        android:background="#FFBBBBBB"
        android:padding="10dp">
        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="选择字体颜色："
            android:textColor="@android:color/black"
            android:textSize="18sp"/>
        <RadioGroup
            android:id="@+id/colorGroup"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="horizontal">
            <RadioButton
                android:id="@+id/blue"
                android:layout_width="0dp"
                android:layout_height="wrap_content"
                android:layout_weight="1"
                android:background="@android:color/holo_blue_light"
                android:checked="true"
                android:layout_margin="5dp"/>
            <RadioButton
                android:id="@+id/gray"
                android:layout_width="0dp"
                android:layout_height="wrap_content"
                android:layout_weight="1"
                android:background="@android:color/darker_gray"
                android:layout_margin="5dp"/>
            <RadioButton
                android:id="@+id/white"
                android:layout_width="0dp"
                android:layout_height="wrap_content"
                android:layout_weight="1"
                android:background="@android:color/white"
                android:layout_margin="5dp"/>
            <RadioButton
                android:id="@+id/green"
                android:layout_width="0dp"
                android:layout_height="wrap_content"
                android:layout_weight="1"
                android:background="@android:color/holo_green_light"
                android:layout_margin="5dp"/>
        </RadioGroup>

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"
            android:layout_marginTop="15dp"
            android:orientation="vertical">
            <TextView
                android:id="@+id/tvBgAlpha"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:textSize="18sp"
                android:textColor="@android:color/black"
                android:text="背景透明度:100%" />

            <SeekBar
                android:id="@+id/seekBar"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_marginTop="15dp"
                android:progress="100"/>

        </LinearLayout>


        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="horizontal">
            <Button
                android:id="@+id/btnCancel"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="Cancel"/>
            <View
                android:layout_width="0dp"
                android:layout_height="0dp"
                android:layout_weight="1" />
            <Button
                android:id="@+id/btnOk"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="OK"/>
        </LinearLayout>

    </LinearLayout>
</LinearLayout>
  • 在AndroidManifest.xml中声明你的Activity
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.owen.clockwidget">

    <permission android:name="com.owen.clockwidget.ClockBroadcast" />


    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
        tools:ignore="GoogleAppIndexingWarning">


        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <activity android:name=".ConfigActivity"
            android:theme="@android:style/Theme.Translucent.NoTitleBar">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" />
            </intent-filter>
        </activity>

        <receiver android:name=".ClockWidgetProvider">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            <intent-filter>
                <action android:name="android.intent.action.TIME_SET" />
            </intent-filter>
            <intent-filter>
                <action android:name="com.owen.clockwidget.DaemonDie" />
            </intent-filter>

            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/clock_widget_info" />
        </receiver>

    </application>

</manifest>

2.2 在AppWidgetProviderInfo元数据中添加配置Activity配置

    之前的文章介绍过，AppWidget的元数据是以xml文件形式存储，只需要在xml中增加android:configure节点配置，因为这个Activity需要在外部调用，所以Activity名称必须使用完整类名（即含完整包名的类名）。

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="320dp"
    android:minHeight="40dp"
    android:minResizeWidth="110dp"
    android:minResizeHeight="40dp"
    android:updatePeriodMillis="0"
    android:previewImage="@drawable/ic_gift"
    android:initialLayout="@layout/clock_widget"
    android:resizeMode="horizontal|vertical"
    android:widgetCategory="home_screen"
    android:configure="com.owen.clockwidget.ConfigActivity">
</appwidget-provider>

2.3 注意事项

  • 配置Activity必须返回AppWidget的ID
        配置Activity由AppWidget主机启动，AppWidget主机会在启动Intent中传入一个AppWidget的ID，当配置完成时，必须将这个AppWidget的ID返回。返回该值的方法是通过Activity的setResult()方法返回，传递的key为AppWidgetManager.EXTRA_APPWIDGET_ID。如果没有完成这一步，添加AppWidget到主机的时候，总是会失败，无法添加。

  • 完成配置返回时必须手动更新AppWidget
        当用户向主机添加AppWidget的时候，会在AppWidget创建时回调onUpdate()方法，当配置Activity启动或者关闭时，系统不会发送ACTION_APPWIDGET_UPDATE的广播，因此必须在配置Activity中主动更新AppWidget，从配置Activity中更新AppWidget，可通过获取一个AppWidgetManager对象，并调用updateAppWidget()接口进行更新，以下是示例代码（详细代码可参考demo源码： ClockWidget）：

fun updateWidget(context: Context?) {
    val appWidgetManager = AppWidgetManager.getInstance(context)

    val componentName = ComponentName(context!!, ClockWidgetProvider::class.java)

    val appWidgetIds = appWidgetManager.getAppWidgetIds(componentName)
    appWidgetIds?.forEach {
        appWidgetManager.updateAppWidget(componentName, buildView(it, context))
    }
}

3. Demo项目源码

demo项目源码可在Github上下载：ClockWidget

说明：因demo源码会不断更新，当前文章的代码可能会跟Github上的存在差异

精装机械师
关注
专栏目录
android widget 启动activity,android之appwidget（二）启动新activity
weixin_34981046的博客
05-28 1164
紧接上集，appwidget的周期函数对应的事件：onUpdate：到达指定时间之后或者用户向桌面添加appwidget时候会调用这个方法。onDelete：当appwidget被删除时，会调用这个方法。onEnable：当一个appwidget第一次被创建，会调用这个方法。onDisable：当最后一个appwidget实例被删除后，会调用这个方法。onReveice：接受广播事件。调试出来了么...
App Widgets 详解二 Configuration Activity
默小铭的博客
06-22 2933
导读:本篇主要介绍 Configuration Activity 的配置与使用 App Widget 小部件系列其他文章链接: App Widgets 详解一 简单使用App Widgets 详解二 Configuration ActivityApp Widgets 详解三 Activity中添加App WidgetsApp Widgets 详解四 RemoteViews、RemoteViewsSe
Android开发之道（5）Widget、Activity与Intent
02-10 67
转载请注明来自“柳大的CSDN博客”：http://blog.csdn.net/poechant 一、Widget 1、TextView 每个 Widget 都有很多属性，有一些属性是几乎每个 Widget 都有的，比如“id”、“layout_width”、“layout_height”。下面以 TextView 的几个常用属性为例，作为一个示范。 &lt...
关于 App Widget Configuration Activity返回值调用的问题。
红色苦瓜的专栏
05-03 996
在官方的SDK中有这么一段话 http://developer.android.com/reference/android/appwidget/AppWidgetManager.html#ACTION_APPWIDGET_CONFIGURE If you return RESULT_OK using Activity.setResult(), the AppWidget will be
Android之AppWidget的按钮事件开启Activity
zhuangshn的专栏
04-01 1600
        由于App Widget只提供给我们一个可以使用RemoteViews的方法PendingIntent，因此只能采用PendingIntent方法来传递Intent。使用Intent实例化一个PendingIntent，调用PendingIntent的getActivity来启动另一个Activity。getActivity的最后一个参数：FLAG_CANCEL_CURRE
appWidget启动Activity
08-27
6. **添加到主屏幕**：最后，为了让用户能够在主屏幕上添加我们的`appWidget`，需要在应用中提供一个添加`appWidget`的界面，并调用`AppWidgetManager`的`addAppWidget()`方法。 完成以上步骤后，当用户在主屏幕上...
android之appwidget（二）启动新activity
03-27
5. **注意权限**：确保在AndroidManifest.xml中为`TargetActivity`添加了正确的权限，例如`<activity>`标签中可能需要包含`android:exported="true"`，以便外部组件（如AppWidget）可以启动它。 通过以上步骤，我们...
Android -- AppWidget源码.zip
04-12
3. **AppWidgetHostView**: 这是系统为每个AppWidget实例创建的视图容器，用于显示小部件的内容。它会根据AppWidgetInfo中的信息来初始化大小，并管理小部件的生命周期。 4. **Widget布局文件**: 通常是一个XML文件...
Android桌面插件App Widget用法分析
09-01
5. **配置活动（可选）**：如果需要，你可以创建一个配置Activity，让用户在添加App Widget时自定义设置。 App Widget的更新通常通过`onUpdate()`方法进行，这里可以使用AppWidgetManager类来更新App Widget的视图...
Android开发之App widget用法实例分析
09-02
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="300dp" android:minHeight="72dp" android:updatePeriodMillis="0" android:initialLayout="@layout/...
Android的startActivityForResult()与onActivityResult()与setResult()参数分析，activity带参数的返回...
anzhenji7632的博客
01-11 155
一、使用场景 　　在一个主界面(主Activity)通过意图跳转至多个不同子Activity上去，当子模块的代码执行完毕后再次返回主页面，将子activity中得到的数据显示在主界面/完成的数据交给主Activity处理。这种带数据的意图跳转需要使用activity的onActivityResult()方法。 （1）startActivityForResult(Intentinte...
Android App Widget创建步骤 带配置界面
晨光飞舞的专栏
04-07 906
本文来自http://blog.csdn.net/chenshaoyang0011转载请申明文章出处！ Android通知系统是它的一大特色，而其中，AppWidget是其中一个亮点。在开发应用的中，很多时候可以为其添加一个AppWidget显示在桌面中，及时方便的与用户进行 交互。这里就简单的熟悉一下开发一个AppWidget的流程吧。 想要在应用中创建一个AppWidget，至少需要以下几样东西： 1、需要创建一个AppWidgetProviderInfo，来描述AppWidget的元数据。2.
android开发之App widget
一名开发者
12-12 596
放在桌面上的控件叫做——App widget，例如可以在桌面上添加按钮、图片等等控件，例如桌面播放器的控制面板   AppWidgetProviderInfo对象，它为App Widget提供元数据，包括布局、更新频率等等数据，这个对象不是由我们自己生成的，而是由android自己定义配置完成，这个对象被定义在XML文件中 1、定义AppWidgetProviderInfo对象，在res/x
为您的Android应用程序编码小部件：添加配置活动
代码教主
06-17 183
应用程序小部件可让您的用户轻松访问应用程序最常用的功能，同时使应用程序出现在用户的主屏幕上。 通过将小部件添加到您的项目中，您可以提供更好的用户体验，同时鼓励用户继续使用您的应用程序，因为每当他们瞥一眼主屏幕时，就会看到您的小部件，显示您的应用程序中最有用和最有用的部分。有趣的内容。 在这个由三部分组成的系列文章中，我们将构建一个应用程序小部件，它具有几乎在每个 Android应用程序小部...
AppWidget 设置label
秋月夜的博客
10-31 354
默认widget label是app 的label，查了下文档AppWidgetProviderInfo 之前有label 标签，但是已经废弃，试了一下没有效果 最后发现在AndroidManifest中配置label可以生效 <receiver android:name=".app_widget.AppWidget" android:label="@string/app_widget_label"> <int.
android widget 开发实例
chenlb206的专栏
03-09 2830
本文转载自 silenceburn 大师 桌面便签软件是android上常用软件的一种，比如比较早的Sticky Note，就曾非常流行，Sticky Note的介绍可以参见 http://www.tompda.com/c/article/11778/ 而实际上使用android平台对widget开发的支持，桌面便签类软件是非常易于开发的。本文通过逐步实现一个简单的桌面便签软件，和大家分享进行widget开发的过程和方法。1.MyNote的最终实现效果为了提起大家阅读本文的兴趣，先介绍一下最终实现的效果。首
android app widget用户交互,Android 妙招解决App Widget用户交互
weixin_36460573的博客
05-28 217
【IT168技术】App Widget对于Android来说是非常强大的。通过它，开发人员可以创建简单的控件，在主屏幕上或在任何程序中提供类似的主机托管功能。在创建一主屏幕App Widget时，您学习了如何创建和配置一个App Widget。这个简单的应用程序插件播放了一个由用户预先设定时间间隔的图像幻灯片。但是，如果用户想改变这个时间间隔?如果他们想暂停幻灯片或立即跳到下一张图片他们该怎么做呢...
android widget 启动activity,解析Android Widget开发中如何构建Activity类
weixin_36486277的博客
05-28 283
本文和大家重点学习一下AndroidWidget开发中如何构建Activity类，本例中的Activity类和普通的Activity极为相似，只是在触发函数中加载完Activity信息后需要多加一些处理。AndroidWidget开发系列(三)3.构建Activity类本例AndroidWidget开发中的Activity类和普通的Activity极为相似，只是在触发函数中加载完Activity信...
Widget创建前先使用activity设置
lyblyblyblin的博客
04-06 371
Widget创建前先使用activity设置，与数据间的传递（使用SharedPreferences） 效果图 activity传入“abc”，显示在widget上 效果图 步骤 1，使用默认的配置创建一个widget 2，再创建一个activity（用于新建widget时候弹出，也可以直接用MainActivity，正式项目不建议） 3，在清单文件中添加acti...
Android App Widget开发入门教程
App Widget的基本原理是将一个小的UI界面（预先配置了各种Intent）放在用户的主屏幕上，用户可以通过点击App Widget来触发相应的行为，例如启动一个服务或跳转到特定的Activity。App Widget的核心是...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值