添加 NoteWidgetProvider及其子类的注释

src/Notes/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java

@@ -32,6 +32,7 @@ import net.micode.notes.tool.ResourceParser;
 import net.micode.notes.ui.NoteEditActivity;
 import net.micode.notes.ui.NotesListActivity;
 
+// 该类实现了桌面中的窗口小部件
 public abstract class NoteWidgetProvider extends AppWidgetProvider { // 小米便签窗口小部件
     public static final String [] PROJECTION = new String [] {
         NoteColumns.ID,
@@ -46,7 +47,7 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { // 小米
     private static final String TAG = "NoteWidgetProvider";
 
     @Override
-    public void onDeleted(Context context, int[] appWidgetIds) {
+    public void onDeleted(Context context, int[] appWidgetIds) { // 重写删除窗口小部件函数
         ContentValues values = new ContentValues();
         values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
         for (int i = 0; i < appWidgetIds.length; i++) {
@@ -57,7 +58,7 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { // 小米
         }
     }
 
-    private Cursor getNoteWidgetInfo(Context context, int widgetId) {
+    private Cursor getNoteWidgetInfo(Context context, int widgetId) { // 获取窗口小部件宽度信息
         return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
                 PROJECTION,
                 NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
@@ -70,7 +71,7 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { // 小米
     }
 
     private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
-            boolean privacyMode) {
+            boolean privacyMode) { // 更新窗口小部件中的内容
         for (int i = 0; i < appWidgetIds.length; i++) {
             if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
                 int bgId = ResourceParser.getDefaultBgId(context);
@@ -124,9 +125,9 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { // 小米
         }
     }
 
-    protected abstract int getBgResourceId(int bgId);
+    protected abstract int getBgResourceId(int bgId); // 从背景资源中获取当前应用ID
 
-    protected abstract int getLayoutId();
+    protected abstract int getLayoutId(); // 获取布局ID
 
-    protected abstract int getWidgetType();
+    protected abstract int getWidgetType(); // 获取窗口小部件的类型，即2x2型或者4x4型
 }

src/Notes/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_2x.java

@@ -24,23 +24,23 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.tool.ResourceParser;
 
 
-public class NoteWidgetProvider_2x extends NoteWidgetProvider {
-    @Override
+public class NoteWidgetProvider_2x extends NoteWidgetProvider { // 2x2大小的窗口小部件
+    @Override // 重写窗口小部件中的更新函数
     public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
         super.update(context, appWidgetManager, appWidgetIds);
     }
 
-    @Override
+    @Override // 重写窗口小部件中的获取布局ID函数
     protected int getLayoutId() {
         return R.layout.widget_2x;
     }
 
-    @Override
+    @Override // 重写窗口小部件中的获取资源ID函数
     protected int getBgResourceId(int bgId) {
         return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
     }
 
-    @Override
+    @Override // 重写窗口小部件中的获取宽度类型函数
     protected int getWidgetType() {
         return Notes.TYPE_WIDGET_2X;
     }

src/Notes/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_4x.java

@@ -24,22 +24,23 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.tool.ResourceParser;
 
 
-public class NoteWidgetProvider_4x extends NoteWidgetProvider {
-    @Override
+public class NoteWidgetProvider_4x extends NoteWidgetProvider { // 4x4大小的窗口小部件
+    @Override // 重写窗口小部件中的更新函数
     public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
         super.update(context, appWidgetManager, appWidgetIds);
     }
 
+    @Override // 重写窗口小部件中的获取布局ID函数
     protected int getLayoutId() {
         return R.layout.widget_4x;
     }
 
-    @Override
+    @Override // 重写窗口小部件中的获取资源ID函数
     protected int getBgResourceId(int bgId) {
         return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
     }
 
-    @Override
+    @Override // 重写窗口小部件中的获取宽度类型函数
     protected int getWidgetType() {
         return Notes.TYPE_WIDGET_4X;
     }