Android 桌面小組件使用

来源:https://www.cnblogs.com/stars-one/p/18073082
-Advertisement-
Play Games

原文: Android 桌面小組件使用-Stars-One的雜貨小窩 藉助公司上的幾個項目,算是學習了Android桌面小組件的用法,記下踩坑記錄 基本步驟 1.創建小組件佈局 這裡需要註意的事,小組件佈局里不能使用自定義View,只能使用原生的組件,比如說LinearLayout,TextView ...


原文: Android 桌面小組件使用-Stars-One的雜貨小窩

藉助公司上的幾個項目,算是學習了Android桌面小組件的用法,記下踩坑記錄

基本步驟

1.創建小組件佈局

這裡需要註意的事,小組件佈局里不能使用自定義View,只能使用原生的組件,比如說LinearLayout,TextView,連約束佈局都不能使用

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@color/white"
    android:orientation="vertical"
    android:padding="16dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">

        <TextView
            android:id="@+id/tvDate"
            style="@style/textStyle14"
            android:textColor="#313131"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="2023-12-10" />

        <ImageView
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1" />

        <TextView
            android:id="@+id/tvTime"
            android:textColor="#313131"
            style="@style/textStyle14"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="12:10" />

    </LinearLayout>

    <LinearLayout
        android:layout_marginTop="16dp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">
        <ImageView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:src="@drawable/result_clean"/>

        <LinearLayout
            android:orientation="vertical"
            android:layout_width="0dp"
            android:layout_marginStart="9dp"
            android:gravity="center_vertical"
            android:layout_height="match_parent"
            android:layout_weight="1" >
            <TextView
                style="@style/textStyle14"
                android:textColor="#313131"
                android:textStyle="bold"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="125.4MB"/>
            <TextView
                style="@style/textStyle14"
                android:textColor="#313131"
                android:textStyle="bold"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="Junk"/>
        </LinearLayout>

        <TextView
            android:layout_gravity="center_vertical"
            android:id="@+id/tvClean"
            android:textColor="#313131"
            style="@style/textStyle14"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Clean" />

    </LinearLayout>

</LinearLayout>

2.創建provider

import android.appwidget.AppWidgetManager
import android.appwidget.AppWidgetProvider
import android.content.Context
import android.widget.RemoteViews
import android.widget.RemoteViews.RemoteView
import ten.jou.recover.R

class CleaningWidget : AppWidgetProvider() {
    override fun onUpdate(
        context: Context,
        appWidgetManager: AppWidgetManager,
        appWidgetIds: IntArray
    ) {
        appWidgetIds.forEach {
			//如果小組件佈局中使用不支持的組件,這裡創建RemoteViews時候,IDE會報紅提示!
            val remoteView = RemoteViews(context.packageName, R.layout.widget_layout)
			//綁定數據
			remoteView.setTextViewText(R.id.tv1,"hello world")
            appWidgetManager.updateAppWidget(it, remoteView)
        }

    }
}

AppWidgetProvider本質就是一個廣播接收器,所以在清單文件需要聲明(見步驟4)

這裡先補充下,RemoteViews對於TextView,ImageView等View,有設置文本,字體顏色,圖片等相關方法,但並不是所有方法都支持,綁定數據的時候需要註意下小組件是否支持!

3.創建xml屬性聲明

在xml文件夾里新建widget_info.xml文件:

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:targetCellWidth="4"
    android:targetCellHeight="2"
    android:minWidth="250dp"
    android:minHeight="110dp"
    android:updatePeriodMillis="0"
    android:initialLayout="@layout/widget_layout"
    tools:targetApi="s">
</appwidget-provider>

Android12版本以上新增的2個屬性,聲明組件是4*2大小

  • targetCellWidth
  • targetCellHeight

4.清單文件聲明

<receiver
	android:name=".view.CleaningWidget"
	android:enabled="true"
	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/widget_info" />
</receiver>

5.代碼添加小組件

官方說Android12不允許直接通過代碼添加小組件,只能讓用戶手動去桌面拖動添加,但是我手頭的三星系統卻是支持的(也是Android12),具體還沒有細究...

而官方文檔上的寫的例子如下:

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
	val context = this@DesktopWidgetActivity

	val appWidgetManager: AppWidgetManager =
		context.getSystemService(AppWidgetManager::class.java)
	val myProvider = ComponentName(context, CleaningWidget::class.java)

	//判斷啟動器是否支持小組件pin
	val successCallback = if (appWidgetManager.isRequestPinAppWidgetSupported) {
		// Create the PendingIntent object only if your app needs to be notified
		// that the user allowed the widget to be pinned. Note that, if the pinning
		// operation fails, your app isn't notified.
		Intent(context, CleaningWidget::class.java).let { intent ->
			// Configure the intent so that your app's broadcast receiver gets
			// the callback successfully. This callback receives the ID of the
			// newly-pinned widget (EXTRA_APPWIDGET_ID).
			//適配android12的
			val flags = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
				PendingIntent.FLAG_MUTABLE
			} else {
				PendingIntent.FLAG_UPDATE_CURRENT
			}
			PendingIntent.getBroadcast(
				context,
				0,
				intent,
				flags
			)
		}
	} else {
		null
	}

	appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

這裡提下,上面的設置flags方法

val flags = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
	PendingIntent.FLAG_MUTABLE
} else {
	PendingIntent.FLAG_UPDATE_CURRENT
}

有個新項目的targetSdk為34(即Android14),如果使用上面的代碼會出現下麵崩潰錯誤提示

Targeting U+ (version 34 and above) disallows creating or retrieving a PendingIntent with FLAG_MUTABLE, an implicit Intent within and without FLAG_NO_CREATE and FLAG_ALLOW_UNSAFE_IMPLICIT_INTENT for security reasons. To retrieve an already existing PendingIntent, use FLAG_NO_CREATE, however, to create a new PendingIntent with an implicit Intent use FLAG_IMMUTABLE.

實際上提示已經告訴我們怎麼去改代碼了,我這裡把PendingIntent.FLAG_MUTABLE改為FLAG_IMMUTABLE就不會出現了上述的崩潰問題

應該是Android14添加的限制:

  • 如果Intent不傳數據,必須使用PendingIntent.FLAG_IMMUTABLE
  • 如果是需要傳遞數據,則還是需要使用PendingIntent.FLAG_MUTABLE

定時刷新小組件UI

首先,我們得知道,如何主動去更新數據:

val context = it.context
val appWidgetManager: AppWidgetManager = context.getSystemService(AppWidgetManager::class.java)
val myProvider = ComponentName(context, CleaningWidget::class.java)
val remoview = CleaningWidget.getRemoteViewTest(context)

//更新某類組件
appWidgetManager.updateAppWidget(myProvider,remoview)
//更新具體某個組件id
appWidgetManager.updateAppWidget(widgetId,remoview)

getRemoteViewTest方法就是創建一個remoteview,然後調用remoteview相關方法設置文本之類的進行數據填充,代碼就略過不寫了,詳見上述基本步驟2

上面的方法我們註意到updateAppWidget可以傳不同的參數,一般我們用的第二個方法,指定更新某個組件

但這裡又是需要我們傳一個組件id,所以就是在步驟2的時候,我們根據需要需要存儲下widgetId比較好,一般存入資料庫,或者使用SharePreference也可

然後,就是對於定時的情況和對應方案:

  1. 如果是間隔多長更新一次,可以使用開一個服務,在服務中開啟協程進行
  2. 如果是單純的時間文本更新,可以使用TextClock組件,比如說 12:21這種
  3. 小組件的xml中預設可以設置定時更新時長,不過最短只能需要15分鐘
  4. 可以使用鬧鐘服務AlarmManager來實現定時,不過此用法需要結合pendingintent和廣播接收器使用,最終要在廣播接收器里調用更新數據方法
  5. JobScheduler來實現定時更新,似乎受系統省電策略影響,適用於不太精確的定時事件(官方文檔上推薦這個)
  6. WorkManager來實現定時更新(實際上算是JobScheduler升級版),似乎受系統省電策略影響,適用於不太精確的定時事件

應該是除了第一種方法,其他都是可以在應用被殺死的情況進行更新小組件UI

小組件播放動畫

progressbar實現

幀動畫不手動調用anim.start()方法是不會播放的,然後在網上看到一篇文章,使用了progressbar來實現,步驟如下:

在drawable文件夾準備幀動畫文件

<?xml version="1.0" encoding="utf-8"?>
<animation-list xmlns:android="http://schemas.android.com/apk/res/android" android:oneshot="false" android:visible="true">
    <item android:drawable="@drawable/cat_1" android:duration="100" />
    <item android:drawable="@drawable/cat_2" android:duration="100" />
    <item android:drawable="@drawable/cat_3" android:duration="100" />
    <item android:drawable="@drawable/cat_4" android:duration="100" />
</animation-list>

<ProgressBar
	android:indeterminateDrawable="@drawable/cat_animdrawable"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content"/>

indeterminateDrawable設置為上面的幀動畫文件即可

layoutanim實現

主要是利用viewgroup的初次顯示的時候,會展示當前view的添加動畫效果,從而實現比較簡單的動畫效果,如平移,縮放等

可以看實現的敲木魚一文Android-桌面小組件RemoteViews播放木魚動畫 - 掘金

使用ViewFlipper

ViewFlipper主要是輪播使用的

裡面可放幾個元素,之後通過設置autoStart為true,則保證自動輪播

flipInterval屬性則是每個元素的間隔時間(幀動畫的時間),單位為ms

不過在remoteview中使用的話,缺點就是裡面的元素數目只能固定死

否則只能通過定義不同layout文件(如3個元素則是某個layout,4個元素則是某個layout,然後根據選擇來創建remoteview)

<ViewFlipper
        android:id="@+id/viewFlipper"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_gravity="center"
        android:layout_margin="4dp"
        android:autoStart="true"
        android:flipInterval="800">

        <ImageView
            android:id="@+id/vf_img_1"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:scaleType="fitXY"
            android:src="@drawable/peace_talisman_1" />

        <ImageView
            android:id="@+id/vf_img_2"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:scaleType="fitXY"
            android:src="@drawable/peace_talisman_2" />
    </ViewFlipper>

補充

獲取當前桌面的組件id列表

//獲得當前桌面已添加的組件的id列表(可能用戶添加了多個)
val context = it.context
val appWidgetManager: AppWidgetManager = context.getSystemService(AppWidgetManager::class.java)
val myProvider = ComponentName(context, CleaningWidget::class.java)

val info =appWidgetManager.getAppWidgetIds(myProvider)
toast(info.size.toString())

參考

提問之前，請先看提問須知 點擊右側圖標發起提問 聯繫我 或者加入QQ群一起學習 Stars-One安卓學習交流群 TornadoFx學習交流群:1071184701
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 實例帶你瞭解GaussDB的索引管理
    本文分享自華為雲社區《GaussDB資料庫的索引管理》，作者： Gauss松鼠會小助手2。 一、引言 GaussDB資料庫是華為公司傾力打造的自研企業級分散式關係型資料庫，索引的設計和管理對於提高查詢性能至關重要。下麵將通過實際例子深入研究GaussDB資料庫的索引管理。 二、GaussDB資料庫中 ...
  • PG14:adminpack 插件源碼分析
    adminpack 提供了大量支持功能，pgAdmin 和其他管理工具可以使用這些功能提供額外功能，例如遠程管理伺服器日誌文件。預設情況下，只有資料庫超級用戶才能使用所有這些功能，但其他用戶也可以使用 GRANT 命令使用這些功能。 我們先來看一下他支持的函數，可以通過 \dx+ adminpack ...
  • SQL Server索引查找/掃描沒有出現key lookup的案例淺析
    在我們講解這個案例前，我們先來瞭解/預熱一下SQL Server的兩個概念：鍵查找（key lookup)和RID查找（RID lookup),通常，當查詢優化器使用非聚集索引進行查找時，如果所選擇的列或查詢條件中的列只部分包含在使用的非聚集索引和聚集索引中時，就需要一個查找（lookup）來檢索其 ...
  • InnoDB是事務型資料庫的首選引擎
    支持事務安全表（ACID），支持行鎖定和外鍵; MySQL事務的ACID特性是確保數據準確性和可靠性的基本原則，包括**原子性（Atomicity）、一致性（Consistency）、隔離性（Isolation）和持久性（Durability）**。具體如下： 1. **原子性（Atomicity） ...
  • [20240313]toad gather_plan_statistics執行計劃相關問題.txt
    在MySQL 8.0中，可以通過創建自定義哈希函數來處理VARCHAR類型的欄位，以便用作分區鍵。下麵是一個簡單的示例，演示如何在MySQL8.0中創建自定義哈希函數來處理VARCHAR類型的欄位 分區後的表效果 方法一，自定義哈希函數，失敗而告終 創建自定義哈希函數： DELIMITER // C ...
  • 關於Sql server數據類型HierarchyID 數據類型用法和遞歸顯示完整路徑
    對於資料庫表中的大類,小類我們基本一直在使用id ,parentid的方式，今天發現了一種更清晰，更完美的解決方式。 SQL Server 2008版本之後的新類型HierarchyID 不知道大家有沒有瞭解， 該類型作為取代id, parentid的一種解決方案，讓人非常驚喜。 官方給的案例淺顯易 ...
  • 《行業指標體系白皮書》重磅發佈，剖析指標建設困境，構建前瞻性的指標體系（附下載）
    正處於企業指標建設過程中的你，是否經常遇到這樣的問題： • 各個部門獨立建設信息系統，由此產生的指標定義和計算方式各異，導致管理層無法快速準確地掌握整體業務運行狀況 • 缺乏對指標的統一管理和規範，產生重覆的指標計算工作，導致數據計算資源被過度消耗，增加運維成本和數據處理壓力 • 不知道指標體系建設 ...
  • 編譯GreatSQL with RocksDB引擎
    GreatSQL里也能用上RocksDB引擎 1. 前言 RocksDB 是基於Facebook 開源的一種支持事務的、高度可壓縮、高性能的MyRocks存儲引擎，特別適用於高度壓縮和大容量的數據。以下是一些關鍵特點： 高性能： LSM 樹結構使得RocksDB在寫入密集型負載下表現卓越。它能夠處理 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類