pl5p3gmvy
/
Millet4531
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Compare commits

base: pl5p3gmvy:master
Branches Tags
pl5p3gmvy:master
pl5p3gmvy:develop
pl5p3gmvy:qiu_branch
pl5p3gmvy:xue_branch
pl5p3gmvy:main
..
compare: pl5p3gmvy:main
Branches Tags
pl5p3gmvy:master
pl5p3gmvy:develop
pl5p3gmvy:qiu_branch
pl5p3gmvy:xue_branch
pl5p3gmvy:main

No commits in common. 'master' and 'main' have entirely different histories.
master ... main

9 changed files with 2 additions and 941 deletions
Show Stats

2
README.md
Unescape View File

@ -0,0 +1,2 @@
# Millet4531

BIN
doc/~$运行截图.docx
View File

Binary file not shown.

BIN
doc/小米便签开源代码的泛读报告.docx
View File

Binary file not shown.

BIN
doc/运行截图.docx
View File

Binary file not shown.

256
src/model/Note.java
Unescape View File

@ -1,256 +0,0 @@
package net.micode.notes.model;
import android.content.ContentProviderOperation;
import android.content.ContentProviderResult;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.Context;
import android.content.OperationApplicationException;
import android.net.Uri;
import android.os.RemoteException;
import android.util.Log;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.CallNote;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.Notes.TextNote;
import java.util.ArrayList;
/**
* 便签（Note）核心模型类，负责便签数据的创建、修改、同步等操作
* 通过ContentProvider与数据库交互，支持文本和通话记录两种数据类型
*/
public class Note {
private ContentValues mNoteDiffValues; // 记录便签基础属性的变更（如修改时间、本地标记等）
private NoteData mNoteData; // 内部类，管理便签的具体数据（文本或通话记录）
private static final String TAG = "Note";
/**
* 生成新的便签ID，并在数据库中创建对应的基础记录
* @param context 上下文对象
* @param folderId 所属文件夹ID
* @return 新生成的便签ID（若失败返回0）
*/
public static synchronized long getNewNoteId(Context context, long folderId) {
// 初始化基础字段
ContentValues values = new ContentValues();
long createdTime = System.currentTimeMillis();
values.put(NoteColumns.CREATED_DATE, createdTime);
values.put(NoteColumns.MODIFIED_DATE, createdTime);
values.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
values.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记为本地已修改
values.put(NoteColumns.PARENT_ID, folderId);
// 插入数据库并解析返回的URI获取noteId
Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
long noteId = 0;
try {
noteId = Long.parseLong(uri.getPathSegments().get(1)); // 解析URI路径中的ID
} catch (NumberFormatException e) {
Log.e(TAG, "解析便签ID异常: " + e);
noteId = 0;
}
if (noteId == -1) {
throw new IllegalStateException("非法的便签ID: " + noteId);
}
return noteId;
}
public Note() {
mNoteDiffValues = new ContentValues();
mNoteData = new NoteData();
}
/**
* 设置便签基础属性值（如标题、父文件夹等）
* 自动标记本地修改状态和修改时间
*/
public void setNoteValue(String key, String value) {
mNoteDiffValues.put(key, value);
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
}
// 以下方法操作文本数据
public void setTextData(String key, String value) {
mNoteData.setTextData(key, value);
}
public void setTextDataId(long id) {
mNoteData.setTextDataId(id);
}
public long getTextDataId() {
return mNoteData.mTextDataId;
}
// 以下方法操作通话记录数据
public void setCallDataId(long id) {
mNoteData.setCallDataId(id);
}
public void setCallData(String key, String value) {
mNoteData.setCallData(key, value);
}
/**
* 检查是否有本地未同步的修改
* @return true表示存在未同步的修改
*/
public boolean isLocalModified() {
return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
}
/**
* 同步便签数据到数据库
* @param context 上下文对象
* @param noteId 目标便签ID
* @return 同步是否成功
*/
public boolean syncNote(Context context, long noteId) {
if (noteId <= 0) {
throw new IllegalArgumentException("非法的便签ID: " + noteId);
}
if (!isLocalModified()) {
return true; // 无修改直接返回成功
}
// 1. 先更新便签基础属性
int updateCount = context.getContentResolver().update(
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
mNoteDiffValues, null, null);
if (updateCount == 0) {
Log.e(TAG, "便签基础属性更新失败");
}
mNoteDiffValues.clear();
// 2. 更新具体数据（文本/通话记录）
if (mNoteData.isLocalModified() &&
mNoteData.pushIntoContentResolver(context, noteId) == null) {
return false; // 数据更新失败
}
return true;
}
/**
* 内部类：管理便签的具体数据（文本/通话记录）
* 通过ContentProviderOperation实现批量数据库操作
*/
private class NoteData {
private long mTextDataId; // 文本数据项的ID
private ContentValues mTextDataValues; // 文本数据键值对
private long mCallDataId; // 通话记录数据项的ID
private ContentValues mCallDataValues; // 通话记录数据键值对
private static final String TAG = "NoteData";
public NoteData() {
mTextDataValues = new ContentValues();
mCallDataValues = new ContentValues();
mTextDataId = 0;
mCallDataId = 0;
}
/**
* 检查是否有未同步的数据修改
*/
boolean isLocalModified() {
return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
}
// 文本数据操作 ------
void setTextDataId(long id) {
if (id <= 0) throw new IllegalArgumentException("文本数据ID必须大于0");
mTextDataId = id;
}
void setTextData(String key, String value) {
mTextDataValues.put(key, value);
// 同步标记父便签为已修改
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
}
// 通话记录操作 ------
void setCallDataId(long id) {
if (id <= 0) throw new IllegalArgumentException("通话记录ID必须大于0");
mCallDataId = id;
}
void setCallData(String key, String value) {
mCallDataValues.put(key, value);
// 同步标记父便签为已修改
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
}
/**
* 将数据变更推送到数据库
* @return 操作结果的URI，失败返回null
*/
Uri pushIntoContentResolver(Context context, long noteId) {
if (noteId <= 0) throw new IllegalArgumentException("非法的便签ID: " + noteId);
ArrayList<ContentProviderOperation> operationList = new ArrayList<>();
ContentProviderOperation.Builder builder;
// 处理文本数据 ------
if (mTextDataValues.size() > 0) {
mTextDataValues.put(DataColumns.NOTE_ID, noteId); // 关联父便签
if (mTextDataId == 0) { // 新增文本数据项
mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
Uri uri = context.getContentResolver().insert(
Notes.CONTENT_DATA_URI, mTextDataValues);
try {
setTextDataId(Long.parseLong(uri.getPathSegments().get(1)));
} catch (NumberFormatException e) {
Log.e(TAG, "插入文本数据失败，便签ID: " + noteId);
mTextDataValues.clear();
return null;
}
} else { // 更新现有文本数据项
builder = ContentProviderOperation.newUpdate(
ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, mTextDataId));
builder.withValues(mTextDataValues);
operationList.add(builder.build());
}
mTextDataValues.clear();
}
// 处理通话记录数据 ------
if (mCallDataValues.size() > 0) {
mCallDataValues.put(DataColumns.NOTE_ID, noteId);
if (mCallDataId == 0) { // 新增通话记录数据项
mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
Uri uri = context.getContentResolver().insert(
Notes.CONTENT_DATA_URI, mCallDataValues);
try {
setCallDataId(Long.parseLong(uri.getPathSegments().get(1)));
} catch (NumberFormatException e) {
Log.e(TAG, "插入通话记录数据失败，便签ID: " + noteId);
mCallDataValues.clear();
return null;
}
} else { // 更新现有通话记录数据项
builder = ContentProviderOperation.newUpdate(
ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, mCallDataId));
builder.withValues(mCallDataValues);
operationList.add(builder.build());
}
mCallDataValues.clear();
}
// 执行批量操作（仅更新操作需要）
if (!operationList.isEmpty()) {
try {
ContentProviderResult[] results = context.getContentResolver()
.applyBatch(Notes.AUTHORITY, operationList);
return (results != null && results.length > 0 && results[0] != null) ?
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId) : null;
} catch (RemoteException | OperationApplicationException e) {
Log.e(TAG, "批量操作异常: " + e.getMessage());
return null;
}
}
return null;
}
}
}

348
src/model/WorkingNote.java
Unescape View File

@ -1,348 +0,0 @@
package net.micode.notes.model;
import android.appwidget.AppWidgetManager;
import android.content.ContentUris;
import android.content.Context;
import android.database.Cursor;
import android.text.TextUtils;
import android.util.Log;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.CallNote;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.DataConstants;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.Notes.TextNote;
import net.micode.notes.tool.ResourceParser.NoteBgResources;
/**
* 当前活动便签的管理类，负责便签的创建、加载、属性设置和数据库同步
* 封装便签业务逻辑，并通过监听器实现与UI的交互
*/
public class WorkingNote {
// 核心数据对象
private Note mNote; // 便签数据模型
private long mNoteId; // 当前便签的数据库ID（0表示未持久化）
private String mContent; // 便签文本内容
private int mMode; // 模式（如普通模式/待办清单模式）
// 属性字段
private long mAlertDate; // 提醒时间（毫秒时间戳，0表示未设置）
private long mModifiedDate; // 最后修改时间
private int mBgColorId; // 背景颜色ID（对应资源索引）
private int mWidgetId; // 关联的小部件ID
private int mWidgetType; // 小部件类型（如2x、4x）
private long mFolderId; // 所属文件夹ID
// 上下文与状态
private Context mContext; // 上下文对象
private static final String TAG = "WorkingNote";
private boolean mIsDeleted; // 标记是否已删除
// 监听器接口
private NoteSettingChangedListener mNoteSettingStatusListener; // 属性变更监听器
// 数据库查询字段定义
/** 数据表（Data表）查询字段 */
public static final String[] DATA_PROJECTION = new String[] {
DataColumns.ID, // 数据项ID
DataColumns.CONTENT, // 内容（文本或通话记录）
DataColumns.MIME_TYPE, // MIME类型（区分文本/通话记录）
DataColumns.DATA1, // 扩展字段1（如模式）
DataColumns.DATA2, // 扩展字段2
DataColumns.DATA3, // 扩展字段3
DataColumns.DATA4, // 扩展字段4
};
/** 便签表（Note表）查询字段 */
public static final String[] NOTE_PROJECTION = new String[] {
NoteColumns.PARENT_ID, // 父文件夹ID
NoteColumns.ALERTED_DATE, // 提醒时间
NoteColumns.BG_COLOR_ID, // 背景色ID
NoteColumns.WIDGET_ID, // 关联小部件ID
NoteColumns.WIDGET_TYPE, // 小部件类型
NoteColumns.MODIFIED_DATE // 修改时间
};
// 数据表字段索引常量 --------------------------------
private static final int DATA_ID_COLUMN = 0;
private static final int DATA_CONTENT_COLUMN = 1;
private static final int DATA_MIME_TYPE_COLUMN = 2;
private static final int DATA_MODE_COLUMN = 3;
// 便签表字段索引常量 --------------------------------
private static final int NOTE_PARENT_ID_COLUMN = 0;
private static final int NOTE_ALERTED_DATE_COLUMN = 1;
private static final int NOTE_BG_COLOR_ID_COLUMN = 2;
private static final int NOTE_WIDGET_ID_COLUMN = 3;
private static final int NOTE_WIDGET_TYPE_COLUMN = 4;
private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
// 构造方法 ----------------------------------------
/**
* 新建便签的私有构造方法
* @param context 上下文
* @param folderId 所属文件夹ID
*/
private WorkingNote(Context context, long folderId) {
mContext = context;
mAlertDate = 0; // 默认无提醒
mModifiedDate = System.currentTimeMillis();
mFolderId = folderId;
mNote = new Note(); // 初始化空Note对象
mNoteId = 0; // 新便签未持久化，ID为0
mIsDeleted = false;
mMode = 0; // 默认普通模式
mWidgetType = Notes.TYPE_WIDGET_INVALIDE; // 初始无小部件关联
}
/**
* 加载现有便签的私有构造方法
* @param context 上下文
* @param noteId 目标便签ID
* @param folderId 所属文件夹ID（可传入0，后续从数据库加载）
*/
private WorkingNote(Context context, long noteId, long folderId) {
mContext = context;
mNoteId = noteId;
mFolderId = folderId;
mIsDeleted = false;
mNote = new Note();
loadNote(); // 从数据库加载数据
}
// 核心方法 ----------------------------------------
/**
* 从数据库加载便签基础属性（Note表）
*/
private void loadNote() {
// 查询便签表
Cursor cursor = mContext.getContentResolver().query(
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId),
NOTE_PROJECTION, null, null, null);
if (cursor != null) {
if (cursor.moveToFirst()) {
// 解析字段
mFolderId = cursor.getLong(NOTE_PARENT_ID_COLUMN);
mBgColorId = cursor.getInt(NOTE_BG_COLOR_ID_COLUMN);
mWidgetId = cursor.getInt(NOTE_WIDGET_ID_COLUMN);
mWidgetType = cursor.getInt(NOTE_WIDGET_TYPE_COLUMN);
mAlertDate = cursor.getLong(NOTE_ALERTED_DATE_COLUMN);
mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
}
cursor.close();
} else {
Log.e(TAG, "无法找到便签ID: " + mNoteId);
throw new IllegalArgumentException("无效的便签ID: " + mNoteId);
}
loadNoteData(); // 继续加载数据表内容
}
/**
* 从数据库加载便签具体数据（Data表）
*/
private void loadNoteData() {
// 查询关联的数据表项
Cursor cursor = mContext.getContentResolver().query(
Notes.CONTENT_DATA_URI,
DATA_PROJECTION,
DataColumns.NOTE_ID + "=?",
new String[] { String.valueOf(mNoteId) },
null
);
if (cursor != null) {
if (cursor.moveToFirst()) {
do {
String type = cursor.getString(DATA_MIME_TYPE_COLUMN);
if (DataConstants.NOTE.equals(type)) {
// 加载文本数据
mContent = cursor.getString(DATA_CONTENT_COLUMN);
mMode = cursor.getInt(DATA_MODE_COLUMN);
mNote.setTextDataId(cursor.getLong(DATA_ID_COLUMN)); // 关联数据项ID
} else if (DataConstants.CALL_NOTE.equals(type)) {
// 加载通话记录数据
mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
} else {
Log.d(TAG, "未知数据类型: " + type);
}
} while (cursor.moveToNext());
}
cursor.close();
} else {
Log.e(TAG, "无法找到便签数据，ID: " + mNoteId);
throw new IllegalArgumentException("无效的便签数据ID: " + mNoteId);
}
}
/**
* 创建新的空便签（工厂方法）
* @param context 上下文
* @param folderId 文件夹ID
* @param widgetId 关联小部件ID
* @param widgetType 小部件类型
* @param defaultBgColorId 默认背景色ID
*/
public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
int widgetType, int defaultBgColorId) {
WorkingNote note = new WorkingNote(context, folderId);
note.setBgColorId(defaultBgColorId); // 设置默认背景
note.setWidgetId(widgetId); // 绑定小部件
note.setWidgetType(widgetType);
return note;
}
/**
* 加载现有便签（工厂方法）
* @param context 上下文
* @param id 便签ID
*/
public static WorkingNote load(Context context, long id) {
return new WorkingNote(context, id, 0); // 文件夹ID后续从数据库加载
}
/**
* 保存便签到数据库（核心方法）
* @return 是否保存成功
*/
public synchronized boolean saveNote() {
if (isWorthSaving()) { // 检查是否值得保存
// 若为新便签，生成数据库ID
if (!existInDatabase()) {
if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
Log.e(TAG, "创建新便签失败，ID: " + mNoteId);
return false;
}
}
// 同步数据到数据库
mNote.syncNote(mContext, mNoteId);
// 若关联小部件，通知UI更新
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID &&
mWidgetType != Notes.TYPE_WIDGET_INVALIDE &&
mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onWidgetChanged();
}
return true;
} else {
return false; // 无需保存
}
}
// 辅助方法 ----------------------------------------
/**
* 检查便签是否已持久化到数据库
*/
public boolean existInDatabase() {
return mNoteId > 0;
}
/**
* 判断便签是否值得保存（过滤无效操作）
* 规则：
* - 已标记删除
* - 新便签且内容为空
* - 已存在但无修改
*/
private boolean isWorthSaving() {
return !(mIsDeleted ||
(!existInDatabase() && TextUtils.isEmpty(mContent)) ||
(existInDatabase() && !mNote.isLocalModified()));
}
// 属性设置方法 ------------------------------------
/**
* 设置提醒时间
* @param date 时间戳
* @param set 是否启用提醒
*/
public void setAlertDate(long date, boolean set) {
if (date != mAlertDate) {
mAlertDate = date;
mNote.setNoteValue(NoteColumns.ALERTED_DATE, String.valueOf(mAlertDate));
}
if (mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onClockAlertChanged(date, set); // 通知监听器
}
}
/**
* 标记删除状态
* @param mark 是否标记为删除
*/
public void markDeleted(boolean mark) {
mIsDeleted = mark;
// 若关联小部件，通知更新
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID &&
mWidgetType != Notes.TYPE_WIDGET_INVALIDE &&
mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onWidgetChanged();
}
}
/**
* 设置背景色ID
* @param id 颜色资源ID
*/
public void setBgColorId(int id) {
if (id != mBgColorId) {
mBgColorId = id;
if (mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onBackgroundColorChanged();
}
mNote.setNoteValue(NoteColumns.BG_COLOR_ID, String.valueOf(id));
}
}
/**
* 切换待办清单模式
* @param mode 目标模式
*/
public void setCheckListMode(int mode) {
if (mMode != mode) {
// 触发模式切换回调
if (mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onCheckListModeChanged(mMode, mode);
}
mMode = mode;
mNote.setTextData(TextNote.MODE, String.valueOf(mMode)); // 更新数据模型
}
}
// 其他属性设置方法（略，逻辑类似）-------------------
// ... setWidgetType(), setWidgetId(), setWorkingText(), convertToCallNote() ...
// 数据获取方法 ------------------------------------
public String getContent() {
return mContent;
}
public long getAlertDate() {
return mAlertDate;
}
public int getBgColorResId() {
return NoteBgResources.getNoteBgResource(mBgColorId);
}
// ... 其他getter方法 ...
// 监听器接口 --------------------------------------
/**
* 便签属性变更监听器接口
* 用于通知UI层更新（如小部件、背景色变化）
*/
public interface NoteSettingChangedListener {
/** 背景色变更 */
void onBackgroundColorChanged();
/** 提醒时间设置/取消 */
void onClockAlertChanged(long date, boolean set);
/** 小部件内容需更新 */
void onWidgetChanged();
/** 待办清单模式切换 */
void onCheckListModeChanged(int oldMode, int newMode);
}
}

189
src/widget/NoteWidgetProvider.java
Unescape View File

@ -1,189 +0,0 @@
package net.micode.notes.widget;
import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ContentValues;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.util.Log;
import android.widget.RemoteViews;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.tool.ResourceParser;
import net.micode.notes.ui.NoteEditActivity;
import net.micode.notes.ui.NotesListActivity;
/**
* NoteWidgetProvider 是所有便签桌面小部件的抽象基类。
* 它提供了管理便签小部件的核心功能，包括数据查询、布局设置和点击事件处理。
* 子类需要实现特定尺寸小部件的布局、背景资源和类型标识。
*/
public abstract class NoteWidgetProvider extends AppWidgetProvider {
// 查询便签数据时使用的投影列，指定需要获取的数据库字段
public static final String[] PROJECTION = new String[] {
NoteColumns.ID, // 便签ID
NoteColumns.BG_COLOR_ID, // 便签背景颜色ID
NoteColumns.SNIPPET // 便签摘要内容
};
// 投影列索引常量，提高代码可读性
public static final int COLUMN_ID = 0;
public static final int COLUMN_BG_COLOR_ID = 1;
public static final int COLUMN_SNIPPET = 2;
private static final String TAG = "NoteWidgetProvider";
/**
* 当一个或多个小部件被删除时调用。
* 该方法会将被删除小部件对应的便签记录中的widget_id字段置为INVALID_APPWIDGET_ID。
*
* @param context 应用上下文
* @param appWidgetIds 被删除的小部件ID数组
*/
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
ContentValues values = new ContentValues();
values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
// 遍历所有被删除的小部件ID，更新对应便签记录
for (int i = 0; i < appWidgetIds.length; i++) {
context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
values,
NoteColumns.WIDGET_ID + "=?",
new String[] { String.valueOf(appWidgetIds[i])});
}
}
/**
* 查询指定小部件ID对应的便签信息。
* 仅返回未被删除（不在回收站）的便签记录。
*
* @param context 应用上下文
* @param widgetId 小部件ID
* @return 包含便签信息的Cursor，使用完后需要关闭
*/
private Cursor getNoteWidgetInfo(Context context, int widgetId) {
return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
PROJECTION,
NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) },
null);
}
/**
* 更新指定的小部件（非隐私模式）。
*
* @param context 应用上下文
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
update(context, appWidgetManager, appWidgetIds, false);
}
/**
* 更新指定的小部件，可以选择是否使用隐私模式。
* 隐私模式下不显示便签内容，而是提示用户进入应用查看。
*
* @param context 应用上下文
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
* @param privacyMode 是否启用隐私模式
*/
private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
boolean privacyMode) {
for (int i = 0; i < appWidgetIds.length; i++) {
if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
int bgId = ResourceParser.getDefaultBgId(context);
String snippet = "";
// 创建启动便签编辑界面的Intent
Intent intent = new Intent(context, NoteEditActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());
// 查询小部件对应的便签信息
Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);
if (c != null && c.moveToFirst()) {
// 检查是否存在多个相同widget_id的便签（异常情况）
if (c.getCount() > 1) {
Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
c.close();
return;
}
// 从Cursor中获取便签内容和背景ID
snippet = c.getString(COLUMN_SNIPPET);
bgId = c.getInt(COLUMN_BG_COLOR_ID);
intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));
intent.setAction(Intent.ACTION_VIEW);
} else {
// 若未找到对应便签，显示默认提示文本
snippet = context.getResources().getString(R.string.widget_havenot_content);
intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
}
// 确保Cursor被关闭
if (c != null) {
c.close();
}
// 创建RemoteViews并设置背景和文本
RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
// 根据隐私模式设置不同的点击行为和显示内容
PendingIntent pendingIntent = null;
if (privacyMode) {
rv.setTextViewText(R.id.widget_text,
context.getString(R.string.widget_under_visit_mode));
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i],
new Intent(context, NotesListActivity.class),
PendingIntent.FLAG_UPDATE_CURRENT);
} else {
rv.setTextViewText(R.id.widget_text, snippet);
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
PendingIntent.FLAG_UPDATE_CURRENT);
}
// 设置点击事件并更新小部件
rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);
appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
}
}
}
/**
* 获取指定背景ID对应的背景资源ID。
* 由子类根据不同尺寸实现具体映射逻辑。
*
* @param bgId 背景ID
* @return 对应的资源ID
*/
protected abstract int getBgResourceId(int bgId);
/**
* 获取小部件使用的布局资源ID。
* 由子类根据不同尺寸实现。
*
* @return 布局资源ID
*/
protected abstract int getLayoutId();
/**
* 获取小部件类型。
* 用于标识不同尺寸的小部件，如2x、4x等。
*
* @return 小部件类型常量
*/
protected abstract int getWidgetType();
}

81
src/widget/NoteWidgetProvider_2x.java
Unescape View File

@ -1,81 +0,0 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* 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
*
* http://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 net.micode.notes.widget;
import android.appwidget.AppWidgetManager;
import android.content.Context;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
/**
* NoteWidgetProvider_2x 是一个为 2x 尺寸桌面小部件设计的实现类。
* 它继承自 NoteWidgetProvider，负责管理特定尺寸便签小部件的外观和行为。
* 小部件尺寸通常指 2 列 x 2 行的网格大小，具体取决于设备的桌面网格系统。
*/
public class NoteWidgetProvider_2x extends NoteWidgetProvider {
/**
* 当小部件需要更新时由系统调用。
* 例如，当小部件首次添加到桌面或定期更新时触发。
*
* @param context 应用上下文
* @param appWidgetManager 应用小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// 调用父类的更新方法处理通用更新逻辑
super.update(context, appWidgetManager, appWidgetIds);
}
/**
* 获取此小部件使用的布局资源ID。
* 布局文件定义了小部件的视觉结构和组件排列。
*
* @return R.layout.widget_2x 对应的布局资源ID
*/
@Override
protected int getLayoutId() {
return R.layout.widget_2x;
}
/**
* 根据背景ID获取对应的背景资源ID。
* 背景ID映射到具体的背景图片或颜色资源，用于自定义小部件外观。
*
* @param bgId 背景ID，定义在 Notes 类中
* @return 对应背景资源的ID
*/
@Override
protected int getBgResourceId(int bgId) {
// 使用 ResourceParser 工具类获取2x小部件的背景资源
return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
}
/**
* 获取此小部件的类型。
* 类型用于数据库存储和区分不同尺寸的小部件。
*
* @return Notes.TYPE_WIDGET_2X，表示这是一个2x尺寸的小部件
*/
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_2X;
}
}

67
src/widget/NoteWidgetProvider_4x.java
Unescape View File

@ -1,67 +0,0 @@
package net.micode.notes.widget;
import android.appwidget.AppWidgetManager;
import android.content.Context;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
/**
* NoteWidgetProvider_4x 是用于 4x 尺寸桌面便签小部件的提供者类。
* 该类继承自 NoteWidgetProvider，负责管理 4x 便签小部件的更新、布局和样式。
* 4x 通常表示小部件在桌面网格中占据 4 列 x N 行的空间（具体行数取决于布局实现）。
*/
public class NoteWidgetProvider_4x extends NoteWidgetProvider {
/**
* 当小部件需要更新时由系统调用。
* 例如，首次添加小部件或达到定期更新时间时触发。
*
* @param context 应用上下文
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// 调用父类的更新方法处理通用更新逻辑
super.update(context, appWidgetManager, appWidgetIds);
}
/**
* 获取此小部件使用的布局资源ID。
* 该布局定义了 4x 小部件的UI结构，通常包含更多内容展示空间。
*
* @return R.layout.widget_4x 对应的布局资源ID
*/
@Override // 此处应添加@Override注解以确保方法重写正确性
protected int getLayoutId() {
return R.layout.widget_4x;
}
/**
* 根据背景ID获取对应的背景资源ID。
* 不同尺寸的小部件可能使用不同的背景资源以确保视觉比例协调。
*
* @param bgId 背景ID（定义在 Notes 类中）
* @return 对应背景资源的ID
*/
@Override
protected int getBgResourceId(int bgId) {
// 使用工具类获取4x小部件的背景资源
return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
}
/**
* 获取此小部件的类型标识。
* 类型标识用于数据库存储和区分不同尺寸的小部件。
*
* @return Notes.TYPE_WIDGET_4X，表示这是一个4x尺寸的便签小部件
*/
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_4X;
}
}
Write Preview
Loading…
Cancel
Save