Linux教程網 >> Linux編程 >> Linux編程 >> Android Widget 開發實例：桌面便簽程序的實現詳解和源碼

Android Widget 開發實例：桌面便簽程序的實現詳解和源碼

日期：2017/3/1 11:10:45 编辑：Linux編程

桌面便簽軟件是Android上常用軟件的一種，比如比較早的Sticky Note，就曾非常流行，而實際上使用android平台對widget開發的支持，桌面便簽類軟件是非常易於開發的。

本文通過逐步實現一個簡單的桌面便簽軟件，和大家分享進行widget開發的過程和方法。

同時本程序提供完整的工程源碼下載

免費下載地址在 http://linux.linuxidc.com/

用戶名與密碼都是www.linuxidc.com

具體下載目錄在 /pub/Android源碼集錦/2011年/10月/Android Widget 開發實例：桌面便簽程序的實現詳解和源碼/

1.MyNote的最終實現效果

為了提起大家閱讀本文的興趣，先介紹一下最終實現的效果。

首先可以通過桌面增加我們的MyNote小部件，如下圖所示：

圖中的“我的便簽”就是我們之後將要開發的便簽程序。

點擊後啟動添加日志界面，如下圖所示：

輸入便簽內容後，可以點擊下面所列的四種圖標之一作為便簽圖標。

比如點擊第一個後，桌面上就會添加一個便簽：

點擊桌面上的便簽，可以再次對便簽內容進行修改，並更換圖標。

桌面上可以同時存在多個便簽，並可以分別進行修改。

如下圖所示，我們將剛才創建的便簽的圖標修改一下，並新增了一個便簽：

每個便簽的內容都是分別獨立保存的，可以隨時點擊桌面圖標修改。

2.開發方式

開發的目的和追求的效果已經十分清楚了，首先我們確定一下開發方式。

在本文中，將采取一種漸進式的開發，也就是說不會一口氣從頭做到尾。

而是分為好幾個階段。每個階段都完成一定的目標，然後下個階段增加更多的功能，

每個階段都離最終目標更進一步，OK，你可以說這是一次敏捷開發 :)

第一個階段，首先我們會搭建一個widget原型程序，

它是完全可以運行的，可以創建桌面widget。

第二個階段，我們改進 widget 配置Activity 部分的實現

使其具備創建便簽的功能

第三個階段，我們改進 widget 點擊響應部分的實現，

使其具備修改便簽的功能

3.搭建widget原型程序

本節我們會做一個最簡單的widget程序原型，但是它是可以運行的。

一般來說 widget 程序由以下部分組成：

a. AppWidgetProvider 的實現

b. widget外觀布局定義文件

c. 新增widget時的配置Activity的實現（可選）

d. widget 參數配置文件

以下分別講解

a. AppWidgetProvider 的實現

首先我們新建一個android工程起名為MyNote，然後修改 MyNote.java 的代碼，

使MyNote繼承自 AppWidgetProvider ，並重寫 onUpdate 和 onDeleted 方法。

其中onUpdate 會在widget創建及被更新時調用， onDeleted 會在widget被刪除時調用。

目前我們不需要在這裡實現任何功能，只是簡單的記錄日志以便我們觀察其運行，編寫好的代碼如下：

package com.silenceburn;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.util.Log;
public class MyNote extends AppWidgetProvider {
/** Called when the activity is first created. */
final String mPerfName = "com.silenceburn.MyColorNoteConf";
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
// TODO Auto-generated method stub
final int N = appWidgetIds.length;
for (int i = 0; i < N; i++) {
int appWidgetId = appWidgetIds[i];
Log.i("myLog", "this is [" + appWidgetId + "] onUpdate!");
}
}
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
// TODO Auto-generated method stub
final int N = appWidgetIds.length;
for (int i = 0; i < N; i++) {
int appWidgetId = appWidgetIds[i];
Log.i("myLog", "this is [" + appWidgetId + "] onDelete!");
}
}
}

b. widget外觀布局定義文件

我們需要為widget編寫一個外觀布局文件，在本示例中，布局非常簡單，只需要一個imageView即可

編寫好的 my_note_widget.xml 文件如下：

<?xml version="1.0" encoding="utf-8"?>
<ImageView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/my_widget_img"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:src="@drawable/sketchy_paper_008"
android:clickable="true"/>

這裡用到了一個外部圖片 sketchy_paper_008.png，來源於網絡，感謝圖片原作者。

可以到 http://dryicons.com/free-icons/preview/sketchy-paper-icons/ 打包下載。

( 注意下載下來的包中的文件名可能和我寫的程序中的命名有差異，請注意自行調整。)

c. 新增widget時的配置Activity的實現（可選）

android平台為widget提供一個配置界面的功能，我們可以自定義一個Activity，

在widget參數配置文件中配置好相關參數後，此Activity會在用戶新增widget時自動調用。

一般來說，這個配置界面的作用是用戶新建widget時，讓用戶配置widget的一些屬性，比如顏色、大小等等。

但是在我們的這個示例程序中，我們用它來當做創建便簽的地方！

不過本節只是先實現一個原型程序，所以暫時不做處理，我們只是新建一個Activity即可。

新建名為MyNoteConf的Activity，重寫onCreate方法，在OnCreate方法中，

由於這個Activity是由系統在新增widget時自動調用的，

所以我們可以用getIntent獲取到傳入的widgetId。可以判斷其是否是一個有效的widgetId，

最後我們必須返回一個RESULT_OK的Intent，並結束當前Activity，系統才會認為配置成功，在桌面上放置這個widget。

如果返回RESULT_CANCELED，系統會認為配置失敗，終止widget的創建過程。

編寫好的MyNoteConf的代碼如下：

package com.silenceburn;
import android.app.Activity;
import android.appwidget.AppWidgetManager;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
public class MyNoteConf extends Activity {
int mAppWidgetId;
@Override
protected void onCreate(Bundle savedInstanceState) {
// TODO Auto-generated method stub
super.onCreate(savedInstanceState);
Log.i("myLog"," on WidgetConf ... ");
setResult(RESULT_CANCELED);
// Find the widget id from the intent.
Intent intent = getIntent();
Bundle extras = intent.getExtras();
if (extras != null) {
mAppWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID,
AppWidgetManager.INVALID_APPWIDGET_ID);
}
// If they gave us an intent without the widget id, just bail.
if (mAppWidgetId == AppWidgetManager.INVALID_APPWIDGET_ID) {
finish();
}
// return OK
Intent resultValue = new Intent();
resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID,
mAppWidgetId);
setResult(RESULT_OK, resultValue);
finish();
}
}

d. widget 參數配置文件

最後我們需要編寫一個widget參數配置文件，將布局文件、配置Activity關聯起來。

我們在res下新建目錄xml，在xml目錄下新增文件 my_note_widget.xml ，編寫如下：

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="72dp" android:minHeight="72dp"
android:updatePeriodMillis="86400000" android:initialLayout="@layout/my_note_widget"
android:configure="com.silenceburn.MyNoteConf">
</appwidget-provider>