Update NoteWidgetProvider_2x.java

NoteWidgetProvider_2x.java

@@ -7,60 +7,70 @@
  * 代码开始
  */
 
+// 定义包名，组织代码模块化管理
 package net.micode.notes.widget;
 
+// 导入Android小部件相关类和应用的资源类
 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;
+import net.micode.notes.R; // 导入资源文件R类，用于访问布局和其他资源
+import net.micode.notes.data.Notes; // 导入笔记相关的数据类
+import net.micode.notes.tool.ResourceParser; // 导入资源解析工具类
 
 /**
- * 2x版本的NoteWidgetProvider，负责处理2x大小的小部件更新和其他操作。
+ * 2x版本的小部件提供者类。
+ * 该类继承自 NoteWidgetProvider，专门处理 2x2 尺寸的笔记小部件。
  */
 public class NoteWidgetProvider_2x extends NoteWidgetProvider {
     /**
-     * 当小部件需要更新时调用此方法。
+     * 当系统需要更新小部件时，会调用此方法。
+     * 此方法通过调用父类的 `update` 方法来处理小部件更新的逻辑。
      *
-     * @param context          上下文环境，用于访问应用全局功能。
-     * @param appWidgetManager 管理当前应用中所有小部件的AppWidgetManager实例。
-     * @param appWidgetIds     当前需要更新的小部件ID数组。
+     * @param context          上下文环境，用于获取应用程序资源和操作。
+     * @param appWidgetManager 管理当前应用中所有小部件的 AppWidgetManager 实例。
+     * @param appWidgetIds     当前需要更新的小部件 ID 数组。
      */
     @Override
     public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        // 调用父类的 update 方法，完成小部件的更新逻辑
         super.update(context, appWidgetManager, appWidgetIds);
     }
 
     /**
-     * 获取小部件布局的ID。
+     * 获取小部件布局的资源 ID。
+     * 此方法返回当前小部件所使用的布局文件的资源 ID。
+     * 该布局文件定义了小部件在屏幕上的外观。
      *
-     * @return 布局资源ID。
+     * @return 布局资源的 ID，对应 `res/layout/widget_2x.xml` 文件。
      */
     @Override
     protected int getLayoutId() {
-        return R.layout.widget_2x;
+        return R.layout.widget_2x; // 返回 2x 小部件的布局资源 ID
     }
 
     /**
-     * 根据背景ID获取对应的背景资源ID。
+     * 根据背景 ID 获取对应的背景资源 ID。
+     * 小部件有不同的背景样式（如不同颜色或主题），通过背景 ID 选择对应的资源。
      *
-     * @param bgId 背景资源的索引ID。
-     * @return 背景资源的ID。
+     * @param bgId 背景资源的索引 ID，表示选择哪一种背景样式。
+     * @return 背景资源的 ID，用于设置小部件的背景。
      */
     @Override
     protected int getBgResourceId(int bgId) {
+        // 使用 ResourceParser 工具类，根据背景 ID 获取 2x 小部件的背景资源 ID
         return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
     }
 
     /**
-     * 获取小部件的类型。
+     * 获取当前小部件的类型。
+     * 该方法返回一个常量，用于标识当前小部件的类型。
+     * 不同尺寸的小部件有不同的类型常量，例如 2x 和 4x 小部件。
      *
-     * @return 小部件类型的常量。
+     * @return 小部件类型的常量值，表示当前为 2x 尺寸的小部件。
      */
     @Override
     protected int getWidgetType() {
-        return Notes.TYPE_WIDGET_2X;
+        return Notes.TYPE_WIDGET_2X; // 返回表示 2x 小部件类型的常量
     }
 }
-