删除.idea

.gitignore

@@ -0,0 +1,10 @@
+*.iml
+.gradle
+/local.properties
+/.idea/*.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties

README.md

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

app/.gitignore

@@ -0,0 +1 @@
+/build

app/build.gradle.kts

@@ -0,0 +1,48 @@
+plugins {
+    alias(libs.plugins.androidApplication)
+}
+
+android {
+    namespace = "net.micode.notes"
+    compileSdk = 34
+    //org.apache.http
+    useLibrary( "org.apache.http.legacy");
+
+    defaultConfig {
+        applicationId = "net.micode.notes"
+        minSdk = 24
+        targetSdk = 34
+        versionCode = 1
+        versionName = "1.0"
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_1_8
+    }
+    packagingOptions { resources.excludes.add("META-INF/*") }
+}
+
+dependencies {
+
+    implementation(libs.appcompat)
+    implementation(libs.material)
+    implementation(fileTree(mapOf(
+        "dir" to "D:\\Project\\Java\\miNote\\httpcomponents-client-4.5.14-bin\\lib",
+        "include" to listOf("*.aar", "*.jar"),
+        "exclude" to listOf("*.aar", "*.jar")
+    )))
+    testImplementation(libs.junit)
+    androidTestImplementation(libs.ext.junit)
+    androidTestImplementation(libs.espresso.core)
+}

app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

app/src/androidTest/java/net/micode/notes/ExampleInstrumentedTest.java

@@ -0,0 +1,26 @@
+package net.micode.notes;
+
+import android.content.Context;
+
+import androidx.test.platform.app.InstrumentationRegistry;
+import androidx.test.ext.junit.runners.AndroidJUnit4;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+import static org.junit.Assert.*;
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+@RunWith(AndroidJUnit4.class)
+public class ExampleInstrumentedTest {
+    @Test
+    public void useAppContext() {
+        // Context of the app under test.
+        Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
+        assertEquals("net.micode.notes", appContext.getPackageName());
+    }
+}

app/src/main/AndroidManifest.xml

@@ -20,7 +20,7 @@
     android:versionCode="1"
     android:versionName="0.1" >
 
-    <uses-sdk android:minSdkVersion="14" />
+    <uses-sdk android:minSdkVersion="24" />
 
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
     <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" />
@@ -38,11 +38,11 @@
         <activity
             android:name=".ui.NotesListActivity"
             android:configChanges="keyboardHidden|orientation|screenSize"
-            android:label="@string/app_name"
             android:launchMode="singleTop"
             android:theme="@style/NoteTheme"
             android:uiOptions="splitActionBarWhenNarrow"
-            android:windowSoftInputMode="adjustPan" >
+            android:windowSoftInputMode="adjustPan"
+            android:exported="true">
 
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
@@ -54,20 +54,25 @@
             android:name=".ui.NoteEditActivity"
             android:configChanges="keyboardHidden|orientation|screenSize"
             android:launchMode="singleTop"
-            android:theme="@style/NoteTheme" >
+            android:theme="@style/NoteTheme"
+            android:exported="true"
+            >
+
 
             <intent-filter>
-                <action android:name="android.intent.action.VIEW" />
+                <action android:name="android.intent.action.INSERT_OR_EDIT" />
                 <category android:name="android.intent.category.DEFAULT" />
                 <data android:mimeType="vnd.android.cursor.item/text_note" />
                 <data android:mimeType="vnd.android.cursor.item/call_note" />
             </intent-filter>
 
             <intent-filter>
-                <action android:name="android.intent.action.INSERT_OR_EDIT" />
+                <action android:name="android.intent.action.VIEW" />
                 <category android:name="android.intent.category.DEFAULT" />
+                <!--
                 <data android:mimeType="vnd.android.cursor.item/text_note" />
                 <data android:mimeType="vnd.android.cursor.item/call_note" />
+                -->
             </intent-filter>
 
             <intent-filter>
@@ -83,11 +88,15 @@
         <provider
             android:name="net.micode.notes.data.NotesProvider"
             android:authorities="micode_notes"
-            android:multiprocess="true" />
+            android:multiprocess="true"
+            android:exported="false" />
 
         <receiver
             android:name=".widget.NoteWidgetProvider_2x"
-            android:label="@string/app_widget2x2" >
+            android:label="@string/app_widget2x2"
+            android:exported="true"
+            >
+
             <intent-filter>
                 <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
                 <action android:name="android.appwidget.action.APPWIDGET_DELETED" />
@@ -100,7 +109,8 @@
         </receiver>
         <receiver
             android:name=".widget.NoteWidgetProvider_4x"
-            android:label="@string/app_widget4x4" >
+            android:label="@string/app_widget4x4"
+            android:exported="true">
 
             <intent-filter>
                 <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
@@ -113,7 +123,9 @@
                 android:resource="@xml/widget_4x_info" />
         </receiver>
 
-        <receiver android:name=".ui.AlarmInitReceiver" >
+        <receiver android:name=".ui.AlarmInitReceiver"
+            android:exported="true"
+            >
             <intent-filter>
                 <action android:name="android.intent.action.BOOT_COMPLETED" />
             </intent-filter>

app/src/main/java/net/micode/notes/data/Contact.java

@@ -1,17 +1,16 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有（c）2010-2011年，The MiCode开源社区（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
+ * 根据Apache许可证2.0版（“许可证”）获得许可；
+ * 除非符合许可证的规定，否则您不得使用此文件。
+ * 您可以在以下网址获取许可证副本：
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *      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.data;
@@ -30,12 +29,19 @@ public class Contact {
     private static final String TAG = "Contact";
 
     private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
-    + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
-    + " AND " + Data.RAW_CONTACT_ID + " IN "
+            + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
+            + " AND " + Data.RAW_CONTACT_ID + " IN "
             + "(SELECT raw_contact_id "
             + " FROM phone_lookup"
             + " WHERE min_match = '+')";
 
+    /**
+     * 获取电话号码对应的联系人姓名
+     *
+     * @param context     上下文
+     * @param phoneNumber 电话号码
+     * @return 联系人姓名，如果未找到匹配的联系人，则返回null
+     */
     public static String getContact(Context context, String phoneNumber) {
         if(sContactCache == null) {
             sContactCache = new HashMap<String, String>();

app/src/main/java/net/micode/notes/data/Notes.java

@@ -0,0 +1,275 @@
+
+/*
+ * 版权所有（c）2010-2011年，The MiCode开源社区（www.micode.net）
+ *
+ * 根据Apache许可证2.0版（“许可证”）获得许可；
+ * 除非符合许可证的规定，否则您不得使用此文件。
+ * 您可以在以下网址获取许可证副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 除非适用法律要求或书面同意，软件
+ * 分发根据“原样”分发，
+ * 没有任何明示或暗示的保证或条件。
+ * 有关许可证下的特定语言的管理权限，请参见许可证。
+ */
+
+package net.micode.notes.data;
+
+import android.net.Uri;
+
+public class Notes {
+    public static final String AUTHORITY = "micode_notes";
+    public static final String TAG = "Notes";
+    public static final int TYPE_NOTE     = 0;
+    public static final int TYPE_FOLDER   = 1;
+    public static final int TYPE_SYSTEM   = 2;
+
+    /**
+     * 下面的ID是系统文件夹的标识符
+     * {@link Notes#ID_ROOT_FOLDER } 是默认文件夹
+     * {@link Notes#ID_TEMPARAY_FOLDER } 是不属于任何文件夹的便签
+     * {@link Notes#ID_CALL_RECORD_FOLDER} 用于存储通话记录
+     */
+    public static final int ID_ROOT_FOLDER = 0;
+    public static final int ID_TEMPARAY_FOLDER = -1;
+    public static final int ID_CALL_RECORD_FOLDER = -2;
+    public static final int ID_TRASH_FOLER = -3;
+
+    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
+    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
+    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
+    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
+    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
+    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
+
+    public static final int TYPE_WIDGET_INVALIDE      = -1;
+    public static final int TYPE_WIDGET_2X            = 0;
+    public static final int TYPE_WIDGET_4X            = 1;
+
+    public static class DataConstants {
+        public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
+        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
+    }
+
+    /**
+     * 用于查询所有便签和文件夹的Uri
+     */
+    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
+
+    /**
+     * 用于查询数据的Uri
+     */
+    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
+
+    public interface NoteColumns {
+        /**
+         * 行的唯一ID
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * 便签或文件夹的父ID
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String PARENT_ID = "parent_id";
+
+        /**
+         * 便签或文件夹的创建日期
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * 最新修改日期
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+
+        /**
+         * 提醒日期
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String ALERTED_DATE = "alert_date";
+
+        /**
+         * 文件夹的名称或便签的文本内容
+         * <P> 类型：TEXT </P>
+         */
+        public static final String SNIPPET = "snippet";
+
+        /**
+         * 便签的小部件ID
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String WIDGET_ID = "widget_id";
+
+        /**
+         * 便签的小部件类型
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String WIDGET_TYPE = "widget_type";
+
+        /**
+         * 便签的背景颜色ID
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String BG_COLOR_ID = "bg_color_id";
+
+        /**
+         * 对于文本便签，它没有附件，对于多媒体便签，它至少有一个附件
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String HAS_ATTACHMENT = "has_attachment";
+
+        /**
+         * 文件夹中便签的计数
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String NOTES_COUNT = "notes_count";
+
+        /**
+         * 文件类型：文件夹或便签
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String TYPE = "type";
+
+        /**
+         * 最后同步ID
+         * <P> 类型：INTEGER（long）</P>
+         */
+        public static final String SYNC_ID = "sync_id";
+
+        /**
+         * 表示是否本地修改的标志
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String LOCAL_MODIFIED = "local_modified";
+
+        /**
+         * 移动到临时文件夹之前的原始父ID
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String ORIGIN_PARENT_ID = "origin_parent_id";
+
+        /**
+         * GTask ID
+         * <P> 类型：TEXT </P>
+         */
+        public static final String GTASK_ID = "gtask_id";
+
+        /**
+         * 版本号
+         * <P>
+         * 类型：INTEGER（long）</P>
+        */
+public static final String VERSION = "version";
+        }
+
+public interface DataColumns {
+    /**
+     * 行的唯一ID
+     * <P> 类型：INTEGER（long）</P>
+     */
+    public static final String ID = "_id";
+
+    /**
+     * 此行表示的项的MIME类型。
+     * <P> 类型：Text </P>
+     */
+    public static final String MIME_TYPE = "mime_type";
+
+    /**
+     * 引用便签的ID，此数据属于该便签
+     * <P> 类型：INTEGER（long）</P>
+     */
+    public static final String NOTE_ID = "note_id";
+
+    /**
+     * 便签或文件夹的创建日期
+     * <P> 类型：INTEGER（long）</P>
+     */
+    public static final String CREATED_DATE = "created_date";
+
+    /**
+     * 最新修改日期
+     * <P> 类型：INTEGER（long）</P>
+     */
+    public static final String MODIFIED_DATE = "modified_date";
+
+    /**
+     * 数据的内容
+     * <P> 类型：TEXT </P>
+     */
+    public static final String CONTENT = "content";
+
+
+    /**
+     * 通用数据列，含义与{@link #MIMETYPE}特定，用于整数数据类型
+     * <P> 类型：INTEGER </P>
+     */
+    public static final String DATA1 = "data1";
+
+    /**
+     * 通用数据列，含义与{@link #MIMETYPE}特定，用于整数数据类型
+     * <P> 类型：INTEGER </P>
+     */
+    public static final String DATA2 = "data2";
+
+    /**
+     * 通用数据列，含义与{@link #MIMETYPE}特定，用于TEXT数据类型
+     * <P> 类型：TEXT </P>
+     */
+    public static final String DATA3 = "data3";
+
+    /**
+     * 通用数据列，含义与{@link #MIMETYPE}特定，用于TEXT数据类型
+     * <P> 类型：TEXT </P>
+     */
+    public static final String DATA4 = "data4";
+
+    /**
+     * 通用数据列，含义与{@link #MIMETYPE}特定，用于TEXT数据类型
+     * <P> 类型：TEXT </P>
+     */
+    public static final String DATA5 = "data5";
+}
+
+public static final class TextNote implements DataColumns {
+    /**
+     * 模式，指示文本是否处于检查列表模式
+     * <P> 类型：Integer 1：检查列表模式 0：普通模式 </P>
+     */
+    public static final String MODE = DATA1;
+
+    public static final int MODE_CHECK_LIST = 1;
+
+    public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
+
+    public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
+
+    public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
+}
+
+public static final class CallNote implements DataColumns {
+    /**
+     * 此记录的通话日期
+     * <P> 类型：INTEGER（long）</P>
+     */
+    public static final String CALL_DATE = DATA1;
+
+    /**
+     * 此记录的电话号码
+     * <P> 类型：TEXT </P>
+     */
+    public static final String PHONE_NUMBER = DATA3;
+
+    public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
+
+    public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
+
+    public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
+}
+}

app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java

@@ -83,7 +83,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
 
     /**
-     * Increase folder's note count when move note to the folder
+     * 将笔记移动到文件夹时，增加文件夹的笔记计数。
      */
     private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
         "CREATE TRIGGER increase_folder_count_on_update "+
@@ -95,7 +95,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Decrease folder's note count when move note from folder
+     * 减少文件夹中的笔记数量，当将笔记从文件夹中移出时。
      */
     private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
         "CREATE TRIGGER decrease_folder_count_on_update " +
@@ -108,7 +108,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Increase folder's note count when insert new note to the folder
+     *当插入新笔记到文件夹时，增加文件夹的笔记计数
      */
     private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
         "CREATE TRIGGER increase_folder_count_on_insert " +
@@ -120,7 +120,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Decrease folder's note count when delete note from the folder
+     *从文件夹中删除笔记时减少文件夹的笔记计数
      */
     private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
         "CREATE TRIGGER decrease_folder_count_on_delete " +
@@ -133,7 +133,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Update note's content when insert data with type {@link DataConstants#NOTE}
+     * 当插入类型为{@link DataConstants# note}的数据时，更新注释的内容
      */
     private static final String DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER =
         "CREATE TRIGGER update_note_content_on_insert " +
@@ -146,7 +146,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Update note's content when data with {@link DataConstants#NOTE} type has changed
+     * 当{@link DataConstants# note}类型的数据发生变化时，更新注释的内容
      */
     private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
         "CREATE TRIGGER update_note_content_on_update " +
@@ -159,7 +159,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Update note's content when data with {@link DataConstants#NOTE} type has deleted
+     * 当{@link DataConstants# note}类型的数据被删除时，更新注释的内容
      */
     private static final String DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER =
         "CREATE TRIGGER update_note_content_on_delete " +
@@ -172,7 +172,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Delete datas belong to note which has been deleted
+     * 删除的数据属于已删除的笔记
      */
     private static final String NOTE_DELETE_DATA_ON_DELETE_TRIGGER =
         "CREATE TRIGGER delete_data_on_delete " +
@@ -183,7 +183,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Delete notes belong to folder which has been deleted
+     * 删除笔记属于已删除的文件夹
      */
     private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
         "CREATE TRIGGER folder_delete_notes_on_delete " +
@@ -194,7 +194,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Move notes belong to folder which has been moved to trash folder
+     *移动笔记属于已移动到垃圾文件夹的文件夹
      */
     private static final String FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER =
         "CREATE TRIGGER folder_move_notes_on_trash " +
@@ -239,14 +239,14 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         ContentValues values = new ContentValues();
 
         /**
-         * call record foler for call notes
+         * 通话记录文件夹，用于记录通话记录
          */
         values.put(NoteColumns.ID, Notes.ID_CALL_RECORD_FOLDER);
         values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
         db.insert(TABLE.NOTE, null, values);
 
         /**
-         * root folder which is default folder
+         * 根文件夹，默认文件夹
          */
         values.clear();
         values.put(NoteColumns.ID, Notes.ID_ROOT_FOLDER);
@@ -254,7 +254,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         db.insert(TABLE.NOTE, null, values);
 
         /**
-         * temporary folder which is used for moving note
+         *用于移动笔记的临时文件夹
          */
         values.clear();
         values.put(NoteColumns.ID, Notes.ID_TEMPARAY_FOLDER);
@@ -262,7 +262,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         db.insert(TABLE.NOTE, null, values);
 
         /**
-         * create trash folder
+         * 创建垃圾文件夹
          */
         values.clear();
         values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);

app/src/main/java/net/micode/notes/data/NotesProvider.java

@@ -1,22 +1,9 @@
 /*
- * 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.
+ * 这个类为笔记应用提供了一个内容提供者，用于管理数据。
+ * 它通过 CRUD 操作与底层的 SQLite 数据库进行交互。
  */
-
 package net.micode.notes.data;
 
-
 import android.app.SearchManager;
 import android.content.ContentProvider;
 import android.content.ContentUris;
@@ -34,22 +21,25 @@ import net.micode.notes.data.Notes.DataColumns;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.NotesDatabaseHelper.TABLE;
 
-
 public class NotesProvider extends ContentProvider {
+    // 定义用于 URI 匹配的常量
     private static final UriMatcher mMatcher;
 
+    // 数据库帮助类实例
     private NotesDatabaseHelper mHelper;
 
+    // 日志标签
     private static final String TAG = "NotesProvider";
 
+    // URI 代码
     private static final int URI_NOTE            = 1;
     private static final int URI_NOTE_ITEM       = 2;
     private static final int URI_DATA            = 3;
     private static final int URI_DATA_ITEM       = 4;
-
     private static final int URI_SEARCH          = 5;
     private static final int URI_SEARCH_SUGGEST  = 6;
 
+    // 初始化 UriMatcher
     static {
         mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
         mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
@@ -61,62 +51,67 @@ public class NotesProvider extends ContentProvider {
         mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST);
     }
 
-    /**
-     * x'0A' represents the '\n' character in sqlite. For title and content in the search result,
-     * we will trim '\n' and white space in order to show more information.
-     */
+    // 用于搜索建议的投影
     private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
-        + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
-        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
-        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
-        + R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
-        + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
-        + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
+            + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
+            + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
+            + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
+            + R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
+            + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
+            + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
 
+    // 用于搜索笔记的 SQL 查询
     private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
-        + " FROM " + TABLE.NOTE
-        + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
-        + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
-        + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
+            + " FROM " + TABLE.NOTE
+            + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
+            + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
+            + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
 
+    // onCreate 方法
     @Override
     public boolean onCreate() {
         mHelper = NotesDatabaseHelper.getInstance(getContext());
         return true;
     }
 
+    // 查询方法
     @Override
     public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
-            String sortOrder) {
+                        String sortOrder) {
         Cursor c = null;
         SQLiteDatabase db = mHelper.getReadableDatabase();
         String id = null;
         switch (mMatcher.match(uri)) {
+            // 处理笔记的查询
             case URI_NOTE:
                 c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null,
                         sortOrder);
                 break;
+            // 处理特定笔记的查询
             case URI_NOTE_ITEM:
                 id = uri.getPathSegments().get(1);
                 c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id
                         + parseSelection(selection), selectionArgs, null, null, sortOrder);
                 break;
+            // 处理数据的查询
             case URI_DATA:
                 c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
                         sortOrder);
                 break;
+            // 处理特定数据项的查询
             case URI_DATA_ITEM:
                 id = uri.getPathSegments().get(1);
                 c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id
                         + parseSelection(selection), selectionArgs, null, null, sortOrder);
                 break;
+            // 处理搜索查询
             case URI_SEARCH:
             case URI_SEARCH_SUGGEST:
                 if (sortOrder != null || projection != null) {
                     throw new IllegalArgumentException(
                             "do not specify sortOrder, selection, selectionArgs, or projection" + "with this query");
                 }
-
+                // 提取搜索查询字符串
                 String searchString = null;
                 if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
                     if (uri.getPathSegments().size() > 1) {
@@ -125,11 +120,10 @@ public class NotesProvider extends ContentProvider {
                 } else {
                     searchString = uri.getQueryParameter("pattern");
                 }
-
                 if (TextUtils.isEmpty(searchString)) {
                     return null;
                 }
-
+                // 执行搜索查询
                 try {
                     searchString = String.format("%%%s%%", searchString);
                     c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
@@ -147,14 +141,17 @@ public class NotesProvider extends ContentProvider {
         return c;
     }
 
+    // 插入方法
     @Override
     public Uri insert(Uri uri, ContentValues values) {
         SQLiteDatabase db = mHelper.getWritableDatabase();
         long dataId = 0, noteId = 0, insertedId = 0;
         switch (mMatcher.match(uri)) {
+            // 处理笔记的插入
             case URI_NOTE:
                 insertedId = noteId = db.insert(TABLE.NOTE, null, values);
                 break;
+            // 处理数据的插入
             case URI_DATA:
                 if (values.containsKey(DataColumns.NOTE_ID)) {
                     noteId = values.getAsLong(DataColumns.NOTE_ID);
@@ -166,13 +163,14 @@ public class NotesProvider extends ContentProvider {
             default:
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
-        // Notify the note uri
+        //
+        // 通知内容解析器有变化
         if (noteId > 0) {
             getContext().getContentResolver().notifyChange(
                     ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
         }
 
-        // Notify the data uri
+        // 通知数据 URI 有变化
         if (dataId > 0) {
             getContext().getContentResolver().notifyChange(
                     ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null);
@@ -181,6 +179,7 @@ public class NotesProvider extends ContentProvider {
         return ContentUris.withAppendedId(uri, insertedId);
     }
 
+    // 删除方法
     @Override
     public int delete(Uri uri, String selection, String[] selectionArgs) {
         int count = 0;
@@ -188,10 +187,12 @@ public class NotesProvider extends ContentProvider {
         SQLiteDatabase db = mHelper.getWritableDatabase();
         boolean deleteData = false;
         switch (mMatcher.match(uri)) {
+            // 处理笔记的删除
             case URI_NOTE:
                 selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
                 count = db.delete(TABLE.NOTE, selection, selectionArgs);
                 break;
+            // 处理特定笔记的删除
             case URI_NOTE_ITEM:
                 id = uri.getPathSegments().get(1);
                 /**
@@ -205,10 +206,12 @@ public class NotesProvider extends ContentProvider {
                 count = db.delete(TABLE.NOTE,
                         NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
                 break;
+            // 处理数据的删除
             case URI_DATA:
                 count = db.delete(TABLE.DATA, selection, selectionArgs);
                 deleteData = true;
                 break;
+            // 处理特定数据项的删除
             case URI_DATA_ITEM:
                 id = uri.getPathSegments().get(1);
                 count = db.delete(TABLE.DATA,
@@ -227,6 +230,7 @@ public class NotesProvider extends ContentProvider {
         return count;
     }
 
+    // 更新方法
     @Override
     public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
         int count = 0;
@@ -234,20 +238,24 @@ public class NotesProvider extends ContentProvider {
         SQLiteDatabase db = mHelper.getWritableDatabase();
         boolean updateData = false;
         switch (mMatcher.match(uri)) {
+            // 处理笔记的更新
             case URI_NOTE:
                 increaseNoteVersion(-1, selection, selectionArgs);
                 count = db.update(TABLE.NOTE, values, selection, selectionArgs);
                 break;
+            // 处理特定笔记的更新
             case URI_NOTE_ITEM:
                 id = uri.getPathSegments().get(1);
                 increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);
                 count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id
                         + parseSelection(selection), selectionArgs);
                 break;
+            // 处理数据的更新
             case URI_DATA:
                 count = db.update(TABLE.DATA, values, selection, selectionArgs);
                 updateData = true;
                 break;
+            // 处理特定数据项的更新
             case URI_DATA_ITEM:
                 id = uri.getPathSegments().get(1);
                 count = db.update(TABLE.DATA, values, DataColumns.ID + "=" + id
@@ -267,10 +275,12 @@ public class NotesProvider extends ContentProvider {
         return count;
     }
 
+    // 解析选择方法
     private String parseSelection(String selection) {
         return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
     }
 
+    // 增加笔记版本方法
     private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
         StringBuilder sql = new StringBuilder(120);
         sql.append("UPDATE ");
@@ -296,9 +306,10 @@ public class NotesProvider extends ContentProvider {
         mHelper.getWritableDatabase().execSQL(sql.toString());
     }
 
+    // 获取类型方法
     @Override
     public String getType(Uri uri) {
-        // TODO Auto-generated method stub
+        // 暂不实现
         return null;
     }
 

app/src/main/java/net/micode/notes/gtask/data/MetaData.java

@@ -1,17 +1,16 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011，MiCode开源社区（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
+ * 根据Apache许可证2.0版（“许可证”）许可;
+ * 除非符合许可证，否则您不得使用此文件。
+ * 您可以在以下网址获取许可证副本：
  *
  *        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.gtask.data;
@@ -65,18 +64,18 @@ public class MetaData extends Task {
 
     @Override
     public void setContentByLocalJSON(JSONObject js) {
-        // this function should not be called
-        throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");
+        // 不应调用此函数
+        throw new IllegalAccessError("MetaData:setContentByLocalJSON不应该被调用");
     }
 
     @Override
     public JSONObject getLocalJSONFromContent() {
-        throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");
+        throw new IllegalAccessError("MetaData:getLocalJSONFromContent不应该被调用");
     }
 
     @Override
     public int getSyncAction(Cursor c) {
-        throw new IllegalAccessError("MetaData:getSyncAction should not be called");
+        throw new IllegalAccessError("MetaData:getSyncAction不应该被调用");
     }
 
 }

app/src/main/java/net/micode/notes/gtask/data/Node.java

@@ -1,17 +1,16 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011，MiCode开源社区（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
+ * 根据Apache许可证2.0版（“许可证”）许可;
+ * 除非符合许可证，否则您不得使用此文件。
+ * 您可以在以下网址获取许可证副本：
  *
  *        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.gtask.data;
@@ -20,33 +19,29 @@ import android.database.Cursor;
 
 import org.json.JSONObject;
 
+/**
+ * Node类是所有与GTask同步的数据模型类的基类。
+ */
 public abstract class Node {
+    // 同步操作的常量值
     public static final int SYNC_ACTION_NONE = 0;
-
     public static final int SYNC_ACTION_ADD_REMOTE = 1;
-
     public static final int SYNC_ACTION_ADD_LOCAL = 2;
-
     public static final int SYNC_ACTION_DEL_REMOTE = 3;
-
     public static final int SYNC_ACTION_DEL_LOCAL = 4;
-
     public static final int SYNC_ACTION_UPDATE_REMOTE = 5;
-
     public static final int SYNC_ACTION_UPDATE_LOCAL = 6;
-
     public static final int SYNC_ACTION_UPDATE_CONFLICT = 7;
-
     public static final int SYNC_ACTION_ERROR = 8;
 
-    private String mGid;
-
-    private String mName;
-
-    private long mLastModified;
-
-    private boolean mDeleted;
+    private String mGid; // Google任务的ID
+    private String mName; // 名称
+    private long mLastModified; // 最后修改时间
+    private boolean mDeleted; // 是否已删除
 
+    /**
+     * 构造函数，初始化属性
+     */
     public Node() {
         mGid = null;
         mName = "";
@@ -54,48 +49,51 @@ public abstract class Node {
         mDeleted = false;
     }
 
+    // 抽象方法，由子类实现具体逻辑
     public abstract JSONObject getCreateAction(int actionId);
-
     public abstract JSONObject getUpdateAction(int actionId);
-
     public abstract void setContentByRemoteJSON(JSONObject js);
-
     public abstract void setContentByLocalJSON(JSONObject js);
-
     public abstract JSONObject getLocalJSONFromContent();
-
     public abstract int getSyncAction(Cursor c);
 
+    // 设置Google任务ID
     public void setGid(String gid) {
         this.mGid = gid;
     }
 
+    // 设置名称
     public void setName(String name) {
         this.mName = name;
     }
 
+    // 设置最后修改时间
     public void setLastModified(long lastModified) {
         this.mLastModified = lastModified;
     }
 
+    // 设置删除状态
     public void setDeleted(boolean deleted) {
         this.mDeleted = deleted;
     }
 
+    // 获取Google任务ID
     public String getGid() {
         return this.mGid;
     }
 
+    // 获取名称
     public String getName() {
         return this.mName;
     }
 
+    // 获取最后修改时间
     public long getLastModified() {
         return this.mLastModified;
     }
 
+    // 获取删除状态
     public boolean getDeleted() {
         return this.mDeleted;
     }
-
 }

app/src/main/java/net/micode/notes/gtask/data/SqlData.java

@@ -1,17 +1,16 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011，MiCode开源社区（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
+ * 根据Apache许可证2.0版（“许可证”）许可;
+ * 除非符合许可证，否则您不得使用此文件。
+ * 您可以在以下网址获取许可证副本：
  *
  *        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.gtask.data;
@@ -34,7 +33,9 @@ import net.micode.notes.gtask.exception.ActionFailureException;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+/**
+ * SqlData类用于处理与数据库的交互操作，包括创建、更新和获取数据等操作。
+ */
 public class SqlData {
     private static final String TAG = SqlData.class.getSimpleName();
 
@@ -71,6 +72,9 @@ public class SqlData {
 
     private ContentValues mDiffDataValues;
 
+    /**
+     * 构造函数，初始化属性
+     */
     public SqlData(Context context) {
         mContentResolver = context.getContentResolver();
         mIsCreate = true;
@@ -82,6 +86,9 @@ public class SqlData {
         mDiffDataValues = new ContentValues();
     }
 
+    /**
+     * 通过数据库查询结果构造SqlData对象
+     */
     public SqlData(Context context, Cursor c) {
         mContentResolver = context.getContentResolver();
         mIsCreate = false;
@@ -89,6 +96,9 @@ public class SqlData {
         mDiffDataValues = new ContentValues();
     }
 
+    /**
+     * 从数据库查询结果中加载数据到对象属性
+     */
     private void loadFromCursor(Cursor c) {
         mDataId = c.getLong(DATA_ID_COLUMN);
         mDataMimeType = c.getString(DATA_MIME_TYPE_COLUMN);
@@ -97,6 +107,9 @@ public class SqlData {
         mDataContentData3 = c.getString(DATA_CONTENT_DATA_3_COLUMN);
     }
 
+    /**
+     * 设置数据内容
+     */
     public void setContent(JSONObject js) throws JSONException {
         long dataId = js.has(DataColumns.ID) ? js.getLong(DataColumns.ID) : INVALID_ID;
         if (mIsCreate || mDataId != dataId) {
@@ -130,9 +143,12 @@ public class SqlData {
         mDataContentData3 = dataContentData3;
     }
 
+    /**
+     * 获取数据内容
+     */
     public JSONObject getContent() throws JSONException {
         if (mIsCreate) {
-            Log.e(TAG, "it seems that we haven't created this in database yet");
+            Log.e(TAG, "似乎我们还没有在数据库中创建此数据");
             return null;
         }
         JSONObject js = new JSONObject();
@@ -144,20 +160,21 @@ public class SqlData {
         return js;
     }
 
+    /**
+     * 提交更改到数据库
+     */
     public void commit(long noteId, boolean validateVersion, long version) {
-
         if (mIsCreate) {
             if (mDataId == INVALID_ID && mDiffDataValues.containsKey(DataColumns.ID)) {
                 mDiffDataValues.remove(DataColumns.ID);
             }
-
             mDiffDataValues.put(DataColumns.NOTE_ID, noteId);
             Uri uri = mContentResolver.insert(Notes.CONTENT_DATA_URI, mDiffDataValues);
             try {
                 mDataId = Long.valueOf(uri.getPathSegments().get(1));
             } catch (NumberFormatException e) {
-                Log.e(TAG, "Get note id error :" + e.toString());
-                throw new ActionFailureException("create note failed");
+                Log.e(TAG, "获取笔记ID错误：" + e.toString());
+                throw new ActionFailureException("创建笔记失败");
             }
         } else {
             if (mDiffDataValues.size() > 0) {
@@ -167,23 +184,24 @@ public class SqlData {
                             Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues, null, null);
                 } else {
                     result = mContentResolver.update(ContentUris.withAppendedId(
-                            Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues,
-                            " ? in (SELECT " + NoteColumns.ID + " FROM " + TABLE.NOTE
-                                    + " WHERE " + NoteColumns.VERSION + "=?)", new String[] {
-                                    String.valueOf(noteId), String.valueOf(version)
-                            });
+                                    Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues,
+                            " ? in (SELECT " + NoteColumns.ID +" FROM " + TABLE.NOTE + " WHERE " + NoteColumns.VERSION + "=?)",
+                            new String[] { String.valueOf(noteId), String.valueOf(version) });
                 }
                 if (result == 0) {
-                    Log.w(TAG, "there is no update. maybe user updates note when syncing");
+                    Log.w(TAG, "没有更新。可能是用户在同步时更新了笔记");
                 }
             }
         }
-
         mDiffDataValues.clear();
         mIsCreate = false;
     }
 
+    /**
+     * 获取数据ID
+     */
     public long getId() {
         return mDataId;
     }
 }
+

app/src/main/java/net/micode/notes/gtask/data/SqlNote.java

@@ -37,7 +37,7 @@ import org.json.JSONObject;
 
 import java.util.ArrayList;
 
-
+// SqlData类用于处理与数据库的交互操作，包括创建、更新和获取数据等操作。
 public class SqlNote {
     private static final String TAG = SqlNote.class.getSimpleName();
 
@@ -121,7 +121,7 @@ public class SqlNote {
     private ContentValues mDiffNoteValues;
 
     private ArrayList<SqlData> mDataList;
-
+    //构造函数、初始化属性
     public SqlNote(Context context) {
         mContext = context;
         mContentResolver = context.getContentResolver();
@@ -142,7 +142,7 @@ public class SqlNote {
         mDiffNoteValues = new ContentValues();
         mDataList = new ArrayList<SqlData>();
     }
-
+    //通过数据库查询结果构造SqlData对象
     public SqlNote(Context context, Cursor c) {
         mContext = context;
         mContentResolver = context.getContentResolver();
@@ -165,6 +165,7 @@ public class SqlNote {
         mDiffNoteValues = new ContentValues();
 
     }
+    //从数据库查询结果中加载数据到对象属性
 
     private void loadFromCursor(long id) {
         Cursor c = null;
@@ -225,14 +226,15 @@ public class SqlNote {
                 c.close();
         }
     }
-
+    //  设置数据内容
     public boolean setContent(JSONObject js) {
         try {
             JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+            // 检查笔记类型，系统文件夹不能被设置
             if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
                 Log.w(TAG, "cannot set system folder");
             } else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
-                // for folder we can only update the snnipet and type
+                // 对于文件夹，只能更新摘要和类型
                 String snippet = note.has(NoteColumns.SNIPPET) ? note
                         .getString(NoteColumns.SNIPPET) : "";
                 if (mIsCreate || !mSnippet.equals(snippet)) {
@@ -247,6 +249,7 @@ public class SqlNote {
                 }
                 mType = type;
             } else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_NOTE) {
+                // 笔记类型为普通笔记
                 JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
                 long id = note.has(NoteColumns.ID) ? note.getLong(NoteColumns.ID) : INVALID_ID;
                 if (mIsCreate || mId != id) {
@@ -254,6 +257,7 @@ public class SqlNote {
                 }
                 mId = id;
 
+                // 提醒日期
                 long alertDate = note.has(NoteColumns.ALERTED_DATE) ? note
                         .getLong(NoteColumns.ALERTED_DATE) : 0;
                 if (mIsCreate || mAlertDate != alertDate) {
@@ -261,6 +265,7 @@ public class SqlNote {
                 }
                 mAlertDate = alertDate;
 
+                // 背景颜色 ID
                 int bgColorId = note.has(NoteColumns.BG_COLOR_ID) ? note
                         .getInt(NoteColumns.BG_COLOR_ID) : ResourceParser.getDefaultBgId(mContext);
                 if (mIsCreate || mBgColorId != bgColorId) {
@@ -268,6 +273,7 @@ public class SqlNote {
                 }
                 mBgColorId = bgColorId;
 
+                // 创建日期
                 long createDate = note.has(NoteColumns.CREATED_DATE) ? note
                         .getLong(NoteColumns.CREATED_DATE) : System.currentTimeMillis();
                 if (mIsCreate || mCreatedDate != createDate) {
@@ -275,6 +281,7 @@ public class SqlNote {
                 }
                 mCreatedDate = createDate;
 
+                // 是否有附件
                 int hasAttachment = note.has(NoteColumns.HAS_ATTACHMENT) ? note
                         .getInt(NoteColumns.HAS_ATTACHMENT) : 0;
                 if (mIsCreate || mHasAttachment != hasAttachment) {
@@ -282,6 +289,7 @@ public class SqlNote {
                 }
                 mHasAttachment = hasAttachment;
 
+                // 修改日期
                 long modifiedDate = note.has(NoteColumns.MODIFIED_DATE) ? note
                         .getLong(NoteColumns.MODIFIED_DATE) : System.currentTimeMillis();
                 if (mIsCreate || mModifiedDate != modifiedDate) {
@@ -289,6 +297,7 @@ public class SqlNote {
                 }
                 mModifiedDate = modifiedDate;
 
+                // 父笔记 ID
                 long parentId = note.has(NoteColumns.PARENT_ID) ? note
                         .getLong(NoteColumns.PARENT_ID) : 0;
                 if (mIsCreate || mParentId != parentId) {
@@ -296,6 +305,7 @@ public class SqlNote {
                 }
                 mParentId = parentId;
 
+                // 摘要
                 String snippet = note.has(NoteColumns.SNIPPET) ? note
                         .getString(NoteColumns.SNIPPET) : "";
                 if (mIsCreate || !mSnippet.equals(snippet)) {
@@ -303,6 +313,7 @@ public class SqlNote {
                 }
                 mSnippet = snippet;
 
+                // 笔记类型
                 int type = note.has(NoteColumns.TYPE) ? note.getInt(NoteColumns.TYPE)
                         : Notes.TYPE_NOTE;
                 if (mIsCreate || mType != type) {
@@ -310,6 +321,7 @@ public class SqlNote {
                 }
                 mType = type;
 
+                // 小部件 ID
                 int widgetId = note.has(NoteColumns.WIDGET_ID) ? note.getInt(NoteColumns.WIDGET_ID)
                         : AppWidgetManager.INVALID_APPWIDGET_ID;
                 if (mIsCreate || mWidgetId != widgetId) {
@@ -317,6 +329,7 @@ public class SqlNote {
                 }
                 mWidgetId = widgetId;
 
+                // 小部件类型
                 int widgetType = note.has(NoteColumns.WIDGET_TYPE) ? note
                         .getInt(NoteColumns.WIDGET_TYPE) : Notes.TYPE_WIDGET_INVALIDE;
                 if (mIsCreate || mWidgetType != widgetType) {
@@ -324,6 +337,7 @@ public class SqlNote {
                 }
                 mWidgetType = widgetType;
 
+                // 原始父笔记 ID
                 long originParent = note.has(NoteColumns.ORIGIN_PARENT_ID) ? note
                         .getLong(NoteColumns.ORIGIN_PARENT_ID) : 0;
                 if (mIsCreate || mOriginParent != originParent) {
@@ -331,6 +345,7 @@ public class SqlNote {
                 }
                 mOriginParent = originParent;
 
+                // 遍历数据内容数组，设置笔记数据
                 for (int i = 0; i < dataArray.length(); i++) {
                     JSONObject data = dataArray.getJSONObject(i);
                     SqlData sqlData = null;
@@ -349,6 +364,7 @@ public class SqlNote {
                     }
 
                     sqlData.setContent(data);
+
                 }
             }
         } catch (JSONException e) {
@@ -359,6 +375,7 @@ public class SqlNote {
         return true;
     }
 
+    // 获取笔记内容
     public JSONObject getContent() {
         try {
             JSONObject js = new JSONObject();
@@ -407,41 +424,51 @@ public class SqlNote {
         return null;
     }
 
+    // 设置父笔记 ID
     public void setParentId(long id) {
         mParentId = id;
         mDiffNoteValues.put(NoteColumns.PARENT_ID, id);
     }
 
+    // 设置 Google 任务 ID
     public void setGtaskId(String gid) {
         mDiffNoteValues.put(NoteColumns.GTASK_ID, gid);
     }
 
+    // 设置同步 ID
     public void setSyncId(long syncId) {
         mDiffNoteValues.put(NoteColumns.SYNC_ID, syncId);
     }
 
+    // 重置本地修改标志
     public void resetLocalModified() {
         mDiffNoteValues.put(NoteColumns.LOCAL_MODIFIED, 0);
     }
 
+    // 获取笔记 ID
     public long getId() {
         return mId;
     }
 
+    // 获取父笔记 ID
     public long getParentId() {
         return mParentId;
     }
 
+    // 获取摘要
     public String getSnippet() {
         return mSnippet;
     }
 
+    // 判断是否为普通笔记类型
     public boolean isNoteType() {
         return mType == Notes.TYPE_NOTE;
     }
 
+    // 提交笔记更改
     public void commit(boolean validateVersion) {
         if (mIsCreate) {
+            // 创建新笔记
             if (mId == INVALID_ID && mDiffNoteValues.containsKey(NoteColumns.ID)) {
                 mDiffNoteValues.remove(NoteColumns.ID);
             }
@@ -457,12 +484,14 @@ public class SqlNote {
                 throw new IllegalStateException("Create thread id failed");
             }
 
+            // 如果是普通笔记，则提交笔记数据
             if (mType == Notes.TYPE_NOTE) {
                 for (SqlData sqlData : mDataList) {
                     sqlData.commit(mId, false, -1);
                 }
             }
         } else {
+            // 更新已存在的笔记
             if (mId <= 0 && mId != Notes.ID_ROOT_FOLDER && mId != Notes.ID_CALL_RECORD_FOLDER) {
                 Log.e(TAG, "No such note");
                 throw new IllegalStateException("Try to update note with invalid id");
@@ -473,11 +502,11 @@ public class SqlNote {
                 if (!validateVersion) {
                     result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
                             + NoteColumns.ID + "=?)", new String[] {
-                        String.valueOf(mId)
+                            String.valueOf(mId)
                     });
                 } else {
                     result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
-                            + NoteColumns.ID + "=?) AND (" + NoteColumns.VERSION + "<=?)",
+                                    + NoteColumns.ID + "=?) AND (" + NoteColumns.VERSION + "<=?)",
                             new String[] {
                                     String.valueOf(mId), String.valueOf(mVersion)
                             });
@@ -487,6 +516,7 @@ public class SqlNote {
                 }
             }
 
+            // 如果是普通笔记，则提交笔记数据
             if (mType == Notes.TYPE_NOTE) {
                 for (SqlData sqlData : mDataList) {
                     sqlData.commit(mId, validateVersion, mVersion);
@@ -494,7 +524,7 @@ public class SqlNote {
             }
         }
 
-        // refresh local info
+        // 刷新本地信息
         loadFromCursor(mId);
         if (mType == Notes.TYPE_NOTE)
             loadDataContent();

app/src/main/java/net/micode/notes/gtask/data/Task.java

@@ -31,20 +31,30 @@ import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+/**
+ * 表示一个任务的类，继承自节点类
+ */
 public class Task extends Node {
     private static final String TAG = Task.class.getSimpleName();
 
+    // 标记任务是否已完成
     private boolean mCompleted;
 
+    // 任务的备注信息
     private String mNotes;
 
+    // 任务的元信息
     private JSONObject mMetaInfo;
 
+    // 任务的前一个同级任务
     private Task mPriorSibling;
 
+    // 任务的父任务列表
     private TaskList mParent;
 
+    /**
+     * Task 类的构造函数
+     */
     public Task() {
         super();
         mCompleted = false;
@@ -54,13 +64,15 @@ public class Task extends Node {
         mMetaInfo = null;
     }
 
+    /**
+     * 生成用于创建任务的 JSON 对象
+     */
     public JSONObject getCreateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
             // action_type
-            js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
-                    GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
 
             // action_id
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
@@ -72,8 +84,7 @@ public class Task extends Node {
             JSONObject entity = new JSONObject();
             entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
             entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
-            entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
-                    GTaskStringUtils.GTASK_JSON_TYPE_TASK);
+            entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE, GTaskStringUtils.GTASK_JSON_TYPE_TASK);
             if (getNotes() != null) {
                 entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
             }
@@ -83,8 +94,7 @@ public class Task extends Node {
             js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid());
 
             // dest_parent_type
-            js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE,
-                    GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
+            js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE, GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
 
             // list_id
             js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid());
@@ -103,13 +113,15 @@ public class Task extends Node {
         return js;
     }
 
+    /**
+     * 生成用于更新任务的 JSON 对象
+     */
     public JSONObject getUpdateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
             // action_type
-            js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
-                    GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
 
             // action_id
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
@@ -135,6 +147,9 @@ public class Task extends Node {
         return js;
     }
 
+    /**
+     * 根据远程 JSON 设置任务内容
+     */
     public void setContentByRemoteJSON(JSONObject js) {
         if (js != null) {
             try {
@@ -175,10 +190,12 @@ public class Task extends Node {
         }
     }
 
+    /**
+     * 根据本地 JSON 设置任务内容
+     */
     public void setContentByLocalJSON(JSONObject js) {
-        if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)
-                || !js.has(GTaskStringUtils.META_HEAD_DATA)) {
-            Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
+        if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE) || !js.has(GTaskStringUtils.META_HEAD_DATA)) {
+            Log.w(TAG, "setContentByLocalJSON: nothing is available");
         }
 
         try {
@@ -204,6 +221,9 @@ public class Task extends Node {
         }
     }
 
+    /**
+     * 从内容生成本地 JSON
+     */
     public JSONObject getLocalJSONFromContent() {
         String name = getName();
         try {
@@ -247,6 +267,9 @@ public class Task extends Node {
         }
     }
 
+    /**
+     * 设置元信息
+     */
     public void setMetaInfo(MetaData metaData) {
         if (metaData != null && metaData.getNotes() != null) {
             try {
@@ -258,6 +281,9 @@ public class Task extends Node {
         }
     }
 
+    /**
+     * 获取同步操作
+     */
     public int getSyncAction(Cursor c) {
         try {
             JSONObject noteInfo = null;
@@ -311,41 +337,51 @@ public class Task extends Node {
         return SYNC_ACTION_ERROR;
     }
 
+    /**
+     * 判断任务是否值得保存
+     */
     public boolean isWorthSaving() {
         return mMetaInfo != null || (getName() != null && getName().trim().length() > 0)
                 || (getNotes() != null && getNotes().trim().length() > 0);
     }
 
+    // 设置任务是否完成
     public void setCompleted(boolean completed) {
         this.mCompleted = completed;
     }
 
+    // 设置任务的备注信息
     public void setNotes(String notes) {
         this.mNotes = notes;
     }
 
+    // 设置任务的前一个同级任务
     public void setPriorSibling(Task priorSibling) {
         this.mPriorSibling = priorSibling;
     }
 
+    // 设置任务的父任务列表
     public void setParent(TaskList parent) {
         this.mParent = parent;
     }
 
+    // 获取任务是否完成
     public boolean getCompleted() {
         return this.mCompleted;
     }
 
+    // 获取任务的备注信息
     public String getNotes() {
         return this.mNotes;
     }
 
+    // 获取任务的前一个同级任务
     public Task getPriorSibling() {
         return this.mPriorSibling;
     }
 
+    // 获取任务的父任务列表
     public TaskList getParent() {
         return this.mParent;
     }
-
 }

app/src/main/java/net/micode/notes/gtask/data/TaskList.java

@@ -1,17 +1,17 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011，The MiCode开放源社区 (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
+ * 根据Apache许可证2.0版("许可证")获得许可;
+ * 除非符合许可证，否则您不得使用此文件。
+ * 您可以在以下网址获得许可证副本
  *
  *        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.gtask.data;
@@ -43,6 +43,12 @@ public class TaskList extends Node {
         mIndex = 1;
     }
 
+    /**
+     * 获取创建动作
+     *
+     * @param actionId 动作ID
+     * @return JSON对象
+     */
     public JSONObject getCreateAction(int actionId) {
         JSONObject js = new JSONObject();
 
@@ -74,6 +80,12 @@ public class TaskList extends Node {
         return js;
     }
 
+    /**
+     * 获取更新动作
+     *
+     * @param actionId 动作ID
+     * @return JSON对象
+     */
     public JSONObject getUpdateAction(int actionId) {
         JSONObject js = new JSONObject();
 
@@ -103,6 +115,11 @@ public class TaskList extends Node {
         return js;
     }
 
+    /**
+     * 通过远程JSON设置内容
+     *
+     * @param js 远程JSON对象
+     */
     public void setContentByRemoteJSON(JSONObject js) {
         if (js != null) {
             try {
@@ -129,6 +146,11 @@ public class TaskList extends Node {
         }
     }
 
+    /**
+     * 通过本地JSON设置内容
+     *
+     * @param js 本地JSON对象
+     */
     public void setContentByLocalJSON(JSONObject js) {
         if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)) {
             Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
@@ -157,6 +179,11 @@ public class TaskList extends Node {
         }
     }
 
+    /**
+     * 从内容获取本地JSON
+     *
+     * @return 本地JSON对象
+     */
     public JSONObject getLocalJSONFromContent() {
         try {
             JSONObject js = new JSONObject();
@@ -183,28 +210,34 @@ public class TaskList extends Node {
         }
     }
 
+    /**
+     * 获取同步动作
+     *
+     * @param c 光标
+     * @return 同步动作
+     */
     public int getSyncAction(Cursor c) {
         try {
             if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
-                // there is no local update
+                // 本地没有更新
                 if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
-                    // no update both side
+                    // 两侧都没有更新
                     return SYNC_ACTION_NONE;
                 } else {
-                    // apply remote to local
+                    // 将远程更新应用到本地
                     return SYNC_ACTION_UPDATE_LOCAL;
                 }
             } else {
-                // validate gtask id
+                // 验证gtask id
                 if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
-                    Log.e(TAG, "gtask id doesn't match");
+                    Log.e(TAG, "gtask id不匹配");
                     return SYNC_ACTION_ERROR;
                 }
                 if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
-                    // local modification only
+                    // 仅本地修改
                     return SYNC_ACTION_UPDATE_REMOTE;
                 } else {
-                    // for folder conflicts, just apply local modification
+                    // 对于文件夹冲突，仅应用本地修改
                     return SYNC_ACTION_UPDATE_REMOTE;
                 }
             }
@@ -216,16 +249,27 @@ public class TaskList extends Node {
         return SYNC_ACTION_ERROR;
     }
 
+    /**
+     * 获取子任务数量
+     *
+     * @return 子任务数量
+     */
     public int getChildTaskCount() {
         return mChildren.size();
     }
 
+    /**
+     * 添加子任务
+     *
+     * @param task 子任务
+     * @return 是否添加成功
+     */
     public boolean addChildTask(Task task) {
         boolean ret = false;
         if (task != null && !mChildren.contains(task)) {
             ret = mChildren.add(task);
             if (ret) {
-                // need to set prior sibling and parent
+                // 设置前一个兄弟和父对象
                 task.setPriorSibling(mChildren.isEmpty() ? null : mChildren
                         .get(mChildren.size() - 1));
                 task.setParent(this);
@@ -234,9 +278,16 @@ public class TaskList extends Node {
         return ret;
     }
 
+    /**
+     * 添加子任务到指定位置
+     *
+     * @param task  子任务
+     * @param index 位置索引
+     * @return 是否添加成功
+     */
     public boolean addChildTask(Task task, int index) {
         if (index < 0 || index > mChildren.size()) {
-            Log.e(TAG, "add child task: invalid index");
+            Log.e(TAG, "添加子任务：无效的索引");
             return false;
         }
 
@@ -244,7 +295,7 @@ public class TaskList extends Node {
         if (task != null && pos == -1) {
             mChildren.add(index, task);
 
-            // update the task list
+            // 更新任务列表
             Task preTask = null;
             Task afterTask = null;
             if (index != 0)
@@ -260,6 +311,12 @@ public class TaskList extends Node {
         return true;
     }
 
+    /**
+     * 移除子任务
+     *
+     * @param task 子任务
+     * @return 是否移除成功
+     */
     public boolean removeChildTask(Task task) {
         boolean ret = false;
         int index = mChildren.indexOf(task);
@@ -267,11 +324,11 @@ public class TaskList extends Node {
             ret = mChildren.remove(task);
 
             if (ret) {
-                // reset prior sibling and parent
+                // 重置前一个兄弟和父对象
                 task.setPriorSibling(null);
                 task.setParent(null);
 
-                // update the task list
+                // 更新任务列表
                 if (index != mChildren.size()) {
                     mChildren.get(index).setPriorSibling(
                             index == 0 ? null : mChildren.get(index - 1));
@@ -281,16 +338,23 @@ public class TaskList extends Node {
         return ret;
     }
 
+    /**
+     * 移动子任务到指定位置
+     *
+     * @param task  子任务
+     * @param index 位置索引
+     * @return 是否移动成功
+     */
     public boolean moveChildTask(Task task, int index) {
 
         if (index < 0 || index >= mChildren.size()) {
-            Log.e(TAG, "move child task: invalid index");
+            Log.e(TAG, "移动子任务：无效的索引");
             return false;
         }
 
         int pos = mChildren.indexOf(task);
         if (pos == -1) {
-            Log.e(TAG, "move child task: the task should in the list");
+            Log.e(TAG, "移动子任务：任务应在列表中");
             return false;
         }
 
@@ -299,6 +363,12 @@ public class TaskList extends Node {
         return (removeChildTask(task) && addChildTask(task, index));
     }
 
+    /**
+     * 通过GID查找子任务
+     *
+     * @param gid GID
+     * @return 子任务
+     */
     public Task findChildTaskByGid(String gid) {
         for (int i = 0; i < mChildren.size(); i++) {
             Task t = mChildren.get(i);
@@ -309,18 +379,36 @@ public class TaskList extends Node {
         return null;
     }
 
+    /**
+     * 获取子任务索引
+     *
+     * @param task 子任务
+     * @return 索引
+     */
     public int getChildTaskIndex(Task task) {
         return mChildren.indexOf(task);
     }
 
+    /**
+     * 通过索引获取子任务
+     *
+     * @param index 索引
+     * @return 子任务
+     */
     public Task getChildTaskByIndex(int index) {
         if (index < 0 || index >= mChildren.size()) {
-            Log.e(TAG, "getTaskByIndex: invalid index");
+            Log.e(TAG, "根据索引获取任务：无效的索引");
             return null;
         }
         return mChildren.get(index);
     }
 
+    /**
+     * 通过GID获取子任务
+     *
+     * @param gid GID
+     * @return 子任务
+     */
     public Task getChilTaskByGid(String gid) {
         for (Task task : mChildren) {
             if (task.getGid().equals(gid))
@@ -329,14 +417,29 @@ public class TaskList extends Node {
         return null;
     }
 
+    /**
+     * 获取子任务列表
+     *
+     * @return 子任务列表
+     */
     public ArrayList<Task> getChildTaskList() {
         return this.mChildren;
     }
 
+    /**
+     * 设置索引
+     *
+     * @param index 索引
+     */
     public void setIndex(int index) {
         this.mIndex = index;
     }
 
+    /**
+     * 获取索引
+     *
+     * @return 索引
+     */
     public int getIndex() {
         return this.mIndex;
     }

app/src/main/java/net/micode/notes/gtask/exception/ActionFailureException.java

@@ -0,0 +1,49 @@
+/*
+ * 版权所有 (c) 2010-2011年，The MiCode 开源社区 (www.micode.net)
+ *
+ * 根据 Apache 许可证 2.0 版本（“许可证”）许可；
+ * 除非符合许可证，否则您不得使用此文件。
+ * 您可以在以下网址获取许可证副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 除非适用法律要求或书面同意，否则软件
+ * 根据许可证分发的基础上是“按原样”提供的，
+ * 没有任何形式的明示或暗示的保证或条件。
+ * 有关特定语言的权限，请参见许可证。
+ */
+
+package net.micode.notes.gtask.exception;
+
+/**
+ * 表示操作失败的异常。
+ */
+public class ActionFailureException extends RuntimeException {
+    private static final long serialVersionUID = 4425249765923293627L;
+
+    /**
+     * 创建一个新的 ActionFailureException 实例。
+     */
+    public ActionFailureException() {
+        super();
+    }
+
+    /**
+     * 使用指定的详细信息创建一个新的 ActionFailureException 实例。
+     *
+     * @param paramString 异常的详细信息
+     */
+    public ActionFailureException(String paramString) {
+        super(paramString);
+    }
+
+    /**
+     * 使用指定的详细信息和原因创建一个新的 ActionFailureException 实例。
+     *
+     * @param paramString     异常的详细信息
+     * @param paramThrowable  异常的原因
+     */
+    public ActionFailureException(String paramString, Throwable paramThrowable) {
+        super(paramString, paramThrowable);
+    }
+}

app/src/main/java/net/micode/notes/gtask/exception/NetworkFailureException.java

@@ -0,0 +1,49 @@
+/*
+ * 版权所有 (c) 2010-2011年，The MiCode 开源社区 (www.micode.net)
+ *
+ * 根据 Apache 许可证 2.0 版本（“许可证”）许可；
+ * 除非符合许可证，否则您不得使用此文件。
+ * 您可以在以下网址获取许可证副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 除非适用法律要求或书面同意，否则软件
+ * 根据许可证分发的基础上是“按原样”提供的，
+ * 没有任何形式的明示或暗示的保证或条件。
+ * 有关特定语言的权限，请参见许可证。
+ */
+
+package net.micode.notes.gtask.exception;
+
+/**
+ * 表示网络故障的异常。
+ */
+public class NetworkFailureException extends Exception {
+    private static final long serialVersionUID = 2107610287180234136L;
+
+    /**
+     * 创建一个新的 NetworkFailureException 实例。
+     */
+    public NetworkFailureException() {
+        super();
+    }
+
+    /**
+     * 使用指定的详细信息创建一个新的 NetworkFailureException 实例。
+     *
+     * @param paramString 异常的详细信息
+     */
+    public NetworkFailureException(String paramString) {
+        super(paramString);
+    }
+
+    /**
+     * 使用指定的详细信息和原因创建一个新的 NetworkFailureException 实例。
+     *
+     * @param paramString     异常的详细信息
+     * @param paramThrowable  异常的原因
+     */
+    public NetworkFailureException(String paramString, Throwable paramThrowable) {
+        super(paramString, paramThrowable);
+    }
+}

app/src/main/java/net/micode/notes/gtask/remote/GTaskASyncTask.java

@@ -0,0 +1,131 @@
+/*
+ * 版权所有 (c) 2010-2011年，The MiCode 开源社区 (www.micode.net)
+ *
+ * 根据 Apache 许可证 2.0 版本（“许可证”）许可；
+ * 除非符合许可证，否则您不得使用此文件。
+ * 您可以在以下网址获取许可证副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 除非适用法律要求或书面同意，否则软件
+ * 根据许可证分发的基础上是“按原样”提供的，
+ * 没有任何形式的明示或暗示的保证或条件。
+ * 有关特定语言的权限，请参见许可证。
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.app.Notification;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.os.AsyncTask;
+
+import net.micode.notes.R;
+import net.micode.notes.ui.NotesListActivity;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+// 异步任务用于执行与 GTask 同步相关的操作
+public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
+
+    // GTask 同步通知的 ID
+    private static int GTASK_SYNC_NOTIFICATION_ID = 5234235;
+
+    // 定义接口，用于在任务完成时通知调用者
+    public interface OnCompleteListener {
+        void onComplete();
+    }
+
+    private Context mContext; // 上下文对象
+    private NotificationManager mNotifiManager; // 通知管理器对象
+    private GTaskManager mTaskManager; // GTask 管理器对象
+    private OnCompleteListener mOnCompleteListener; // 完成监听器对象
+
+    // 构造函数，接收上下文和完成监听器对象作为参数
+    public GTaskASyncTask(Context context, OnCompleteListener listener) {
+        mContext = context;
+        mOnCompleteListener = listener;
+        mNotifiManager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE);
+        mTaskManager = GTaskManager.getInstance();
+    }
+
+    // 取消同步任务
+    public void cancelSync() {
+        mTaskManager.cancelSync();
+    }
+
+    // 更新进度信息
+    public void publishProgess(String message) {
+        publishProgress(new String[] { message });
+    }
+
+    // 显示通知
+    private void showNotification(int tickerId, String content) {
+        PendingIntent pendingIntent;
+        if (tickerId != R.string.ticker_success) {
+            // 如果同步失败，则跳转到偏好设置界面
+            pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext, NotesPreferenceActivity.class), PendingIntent.FLAG_IMMUTABLE);
+        } else {
+            // 如果同步成功，则跳转到笔记列表界面
+            pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext, NotesListActivity.class), PendingIntent.FLAG_IMMUTABLE);
+        }
+        Notification.Builder builder = new Notification.Builder(mContext)
+                .setAutoCancel(true)
+                .setContentTitle(mContext.getString(R.string.app_name))
+                .setContentText(content)
+                .setContentIntent(pendingIntent)
+                .setWhen(System.currentTimeMillis())
+                .setOngoing(true);
+        Notification notification = builder.build();
+        mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
+    }
+
+    // 执行后台任务，进行 GTask 同步
+    @Override
+    protected Integer doInBackground(Void... unused) {
+        // 发布登录进度信息
+        publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity.getSyncAccountName(mContext)));
+        // 执行 GTask 同步操作，并返回结果状态码
+        return mTaskManager.sync(mContext, this);
+    }
+
+    // 更新任务进度
+    @Override
+    protected void onProgressUpdate(String... progress) {
+        // 显示同步通知
+        showNotification(R.string.ticker_syncing, progress[0]);
+        // 如果上下文是 GTaskSyncService 类型，则发送广播
+        if (mContext instanceof GTaskSyncService) {
+            ((GTaskSyncService) mContext).sendBroadcast(progress[0]);
+        }
+    }
+
+    // 后台任务执行完成后调用，根据结果状态码显示相应的通知，并通知完成监听器
+    @Override
+    protected void onPostExecute(Integer result) {
+        if (result == GTaskManager.STATE_SUCCESS) {
+            // 显示同步成功通知，并更新上次同步时间
+            showNotification(R.string.ticker_success, mContext.getString
+                    (R.string.success_sync_account, mTaskManager.getSyncAccount()));
+            NotesPreferenceActivity.setLastSyncTime(mContext, System.currentTimeMillis());
+        } else if (result == GTaskManager.STATE_NETWORK_ERROR) {
+// 显示网络错误通知
+            showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_network));
+        } else if (result == GTaskManager.STATE_INTERNAL_ERROR) {
+// 显示内部错误通知
+            showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_internal));
+        } else if (result == GTaskManager.STATE_SYNC_CANCELLED) {
+// 显示同步取消通知
+            showNotification(R.string.ticker_cancel, mContext.getString(R.string.error_sync_cancelled));
+        }
+// 如果完成监听器不为空，则通知其任务完成
+        if (mOnCompleteListener != null) {
+            new Thread(new Runnable() {
+                public void run() {
+                    mOnCompleteListener.onComplete();
+                }
+            }).start();
+        }
+    }
+}

app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java

@@ -38,44 +38,58 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.tool.DataUtils;
 
 import java.io.IOException;
+import java.util.Objects;
 
 
 public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
-    private long mNoteId;
-    private String mSnippet;
+    private long mNoteId;//便签的ID
+    private String mSnippet;//闹钟提示内容
     private static final int SNIPPET_PREW_MAX_LEN = 60;
     MediaPlayer mPlayer;
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
+        //界面显示无标题
         requestWindowFeature(Window.FEATURE_NO_TITLE);
 
+
         final Window win = getWindow();
         win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
 
+        //保持窗体点亮
         if (!isScreenOn()) {
             win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
+                    //点亮
                     | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
+                    //允许窗体点亮时候锁屏
                     | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
+                    //手机锁屏后到了闹钟提示时间，自动点亮屏幕
                     | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
         }
 
+
         Intent intent = getIntent();
 
+
         try {
-            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
-            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
-            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
-                    SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
+            //根据ID从数据库中获取标签的内容；
+            mNoteId = Long.parseLong(Objects.requireNonNull(intent.getData()).getPathSegments().get(1));
+            mSnippet = DataUtils.getSnippetById(this.getContentResolver(),
+                    mNoteId);
+            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet
+                    .substring(0, SNIPPET_PREW_MAX_LEN)
+                    + getResources().getString(R.string.notelist_string_info)
                     : mSnippet;
         } catch (IllegalArgumentException e) {
             e.printStackTrace();
             return;
         }
 
+
         mPlayer = new MediaPlayer();
-        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId,
+                Notes.TYPE_NOTE)) {
             showActionDialog();
             playAlarmSound();
         } else {
@@ -84,11 +98,13 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
     }
 
     private boolean isScreenOn() {
+        //判断屏幕是否锁屏
         PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
         return pm.isScreenOn();
     }
 
     private void playAlarmSound() {
+        //调用系统的铃声管理URI，得到闹钟提示音
         Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
 
         int silentModeStreams = Settings.System.getInt(getContentResolver(),
@@ -101,8 +117,11 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         }
         try {
             mPlayer.setDataSource(this, url);
+            //准备同步
             mPlayer.prepare();
+            //设置循环播放
             mPlayer.setLooping(true);
+            //开始播放
             mPlayer.start();
         } catch (IllegalArgumentException e) {
             // TODO Auto-generated catch block
@@ -131,15 +150,11 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
     }
 
     public void onClick(DialogInterface dialog, int which) {
-        switch (which) {
-            case DialogInterface.BUTTON_NEGATIVE:
-                Intent intent = new Intent(this, NoteEditActivity.class);
-                intent.setAction(Intent.ACTION_VIEW);
-                intent.putExtra(Intent.EXTRA_UID, mNoteId);
-                startActivity(intent);
-                break;
-            default:
-                break;
+        if(which == DialogInterface.BUTTON_NEGATIVE) {
+            Intent intent = new Intent(this, NoteEditActivity.class);
+            intent.setAction(Intent.ACTION_VIEW);
+            intent.putExtra(Intent.EXTRA_UID, mNoteId);
+            startActivity(intent);
         }
     }
 

app/src/main/java/net/micode/notes/ui/AlarmInitReceiver.java

@@ -16,6 +16,7 @@
 
 package net.micode.notes.ui;
 
+import android.annotation.SuppressLint;
 import android.app.AlarmManager;
 import android.app.PendingIntent;
 import android.content.BroadcastReceiver;
@@ -35,12 +36,14 @@ public class AlarmInitReceiver extends BroadcastReceiver {
         NoteColumns.ALERTED_DATE
     };
 
+    //对数据库的操作，调用标签ID和闹钟时间
     private static final int COLUMN_ID                = 0;
     private static final int COLUMN_ALERTED_DATE      = 1;
 
     @Override
     public void onReceive(Context context, Intent intent) {
         long currentDate = System.currentTimeMillis();
+        //Cursor在这里的作用是通过查找数据库中的标签内容，找到和当前系统时间相等的标签
         Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
                 PROJECTION,
                 NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,

app/src/main/java/net/micode/notes/ui/DateTimePicker.java

@@ -16,18 +16,17 @@
 
 package net.micode.notes.ui;
 
-import java.text.DateFormatSymbols;
-import java.util.Calendar;
-
-import net.micode.notes.R;
-
-
 import android.content.Context;
 import android.text.format.DateFormat;
 import android.view.View;
 import android.widget.FrameLayout;
 import android.widget.NumberPicker;
 
+import net.micode.notes.R;
+
+import java.text.DateFormatSymbols;
+import java.util.Calendar;
+
 public class DateTimePicker extends FrameLayout {
 
     private static final boolean DEFAULT_ENABLE_STATE = true;
@@ -83,6 +82,7 @@ public class DateTimePicker extends FrameLayout {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, 1);
                     isDateChanged = true;
+                    //12小时制时，晚上11点和12点交替时对日期的更改
                 } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, -1);
@@ -94,6 +94,7 @@ public class DateTimePicker extends FrameLayout {
                     updateAmPmControl();
                 }
             } else {
+                //24小时
                 if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, 1);
@@ -117,10 +118,13 @@ public class DateTimePicker extends FrameLayout {
 
     private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
+        //对Minute改变的监听
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
             int minValue = mMinuteSpinner.getMinValue();
             int maxValue = mMinuteSpinner.getMaxValue();
             int offset = 0;
+            //如果原值为59，新值为0，则offset加1
+            //如果原值为0，新值为59，则offset减1
             if (oldVal == maxValue && newVal == minValue) {
                 offset += 1;
             } else if (oldVal == minValue && newVal == maxValue) {
@@ -163,6 +167,7 @@ public class DateTimePicker extends FrameLayout {
                 int dayOfMonth, int hourOfDay, int minute);
     }
 
+    //通过对数据库的访问，获取当前的系统时间
     public DateTimePicker(Context context) {
         this(context, System.currentTimeMillis());
     }

app/src/main/java/net/micode/notes/ui/DateTimePickerDialog.java

@@ -16,12 +16,6 @@
 
 package net.micode.notes.ui;
 
-import java.util.Calendar;
-
-import net.micode.notes.R;
-import net.micode.notes.ui.DateTimePicker;
-import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener;
-
 import android.app.AlertDialog;
 import android.content.Context;
 import android.content.DialogInterface;
@@ -29,6 +23,11 @@ import android.content.DialogInterface.OnClickListener;
 import android.text.format.DateFormat;
 import android.text.format.DateUtils;
 
+import net.micode.notes.R;
+import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener;
+
+import java.util.Calendar;
+
 public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
 
     private Calendar mDate = Calendar.getInstance();
@@ -47,6 +46,8 @@ public class DateTimePickerDialog extends AlertDialog implements OnClickListener
         mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
             public void onDateTimeChanged(DateTimePicker view, int year, int month,
                     int dayOfMonth, int hourOfDay, int minute) {
+
+                //设置为系统时间
                 mDate.set(Calendar.YEAR, year);
                 mDate.set(Calendar.MONTH, month);
                 mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);

app/src/main/java/net/micode/notes/ui/NoteEditActivity.java

@@ -28,11 +28,14 @@ import android.content.DialogInterface;
 import android.content.Intent;
 import android.content.SharedPreferences;
 import android.graphics.Paint;
+import android.media.MediaRecorder;
 import android.os.Bundle;
 import android.preference.PreferenceManager;
+import android.text.Editable;
 import android.text.Spannable;
 import android.text.SpannableString;
 import android.text.TextUtils;
+import android.text.TextWatcher;
 import android.text.format.DateUtils;
 import android.text.style.BackgroundColorSpan;
 import android.util.Log;
@@ -43,6 +46,7 @@ import android.view.MotionEvent;
 import android.view.View;
 import android.view.View.OnClickListener;
 import android.view.WindowManager;
+import android.widget.Button;
 import android.widget.CheckBox;
 import android.widget.CompoundButton;
 import android.widget.CompoundButton.OnCheckedChangeListener;
@@ -68,12 +72,19 @@ import net.micode.notes.widget.NoteWidgetProvider_4x;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Map;
+import java.util.Objects;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
 
 public class NoteEditActivity extends Activity implements OnClickListener,
         NoteSettingChangedListener, OnTextViewChangeListener {
+
+
+    private NoteEditText editText;
+    private TextView textView;
+    private Button clearBtn;
+
     private class HeadViewHolder {
         public TextView tvModified;
 
@@ -118,20 +129,25 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);
     }
 
+    //对表头的操作
     private static final String TAG = "NoteEditActivity";
 
     private HeadViewHolder mNoteHeaderHolder;
 
     private View mHeadViewPanel;
 
+    //对标签字体的操作
     private View mNoteBgColorSelector;
 
+    //对文本操作
     private View mFontSizeSelector;
 
     private EditText mNoteEditor;
 
+    //文本编辑的控制板
     private View mNoteEditorPanel;
 
+    //模板WorkingNote
     private WorkingNote mWorkingNote;
 
     private SharedPreferences mSharedPrefs;
@@ -159,6 +175,39 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             return;
         }
         initResources();
+
+        editText = findViewById(R.id.note_edit_view);
+        textView = findViewById(R.id.text_num);
+
+        // 添加文本改变监听器
+        editText.addTextChangedListener(new TextWatcher() {
+            int currentLength = 0;
+
+            @Override
+            public void beforeTextChanged(CharSequence s, int start, int count, int after) {
+                textView.setText("字数：" + currentLength);
+            }
+
+            @Override
+            public void onTextChanged(CharSequence s, int start, int before, int count) {
+                currentLength = editText.length();
+            }
+
+            @Override
+            public void afterTextChanged(Editable s) {
+                textView.setText("字数：" + currentLength);
+            }
+        });
+
+
+        clearBtn = findViewById(R.id.clear_btn);
+
+        clearBtn.setOnClickListener(new View.OnClickListener(){
+            @Override
+            public void onClick(View v) {
+                editText.setText("");
+            }
+        });
     }
 
     /**
@@ -175,6 +224,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                 finish();
                 return;
             }
+            //程序终止时保存现场
             Log.d(TAG, "Restoring from killed activity");
         }
     }
@@ -193,7 +243,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
              * Starting from the searched result
              */
             if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {
-                noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));
+                noteId = Long.parseLong(Objects.requireNonNull(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)));
                 mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);
             }
 
@@ -253,6 +303,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             getWindow().setSoftInputMode(
                     WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE
                             | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE);
+
         } else {
             Log.e(TAG, "Intent not specified action, should not support");
             finish();
@@ -268,6 +319,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         initNoteScreen();
     }
 
+    //设置外观
     private void initNoteScreen() {
         mNoteEditor.setTextAppearance(this, TextAppearanceResources
                 .getTexAppearanceResource(mFontSizeId));
@@ -298,6 +350,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     private void showAlertHeader() {
         if (mWorkingNote.hasClockAlert()) {
             long time = System.currentTimeMillis();
+            //如果系统时间大于了闹钟设置的时间，那么闹钟失效
             if (time > mWorkingNote.getAlertDate()) {
                 mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);
             } else {
@@ -430,7 +483,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         if (id == R.id.btn_set_bg_color) {
             mNoteBgColorSelector.setVisibility(View.VISIBLE);
             findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
-                    -                    View.VISIBLE);
+                    View.VISIBLE);
         } else if (sBgSelectorBtnsMap.containsKey(id)) {
             findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
                     View.GONE);
@@ -507,48 +560,37 @@ public class NoteEditActivity extends Activity implements OnClickListener,
 
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
-        switch (item.getItemId()) {
-            case R.id.menu_new_note:
+        if(item.getItemId() == R.id.menu_new_note) {
                 createNewNote();
-                break;
-            case R.id.menu_delete:
-                AlertDialog.Builder builder = new AlertDialog.Builder(this);
-                builder.setTitle(getString(R.string.alert_title_delete));
-                builder.setIcon(android.R.drawable.ic_dialog_alert);
-                builder.setMessage(getString(R.string.alert_message_delete_note));
-                builder.setPositiveButton(android.R.string.ok,
-                        new DialogInterface.OnClickListener() {
-                            public void onClick(DialogInterface dialog, int which) {
-                                deleteCurrentNote();
-                                finish();
-                            }
-                        });
-                builder.setNegativeButton(android.R.string.cancel, null);
-                builder.show();
-                break;
-            case R.id.menu_font_size:
-                mFontSizeSelector.setVisibility(View.VISIBLE);
-                findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
-                break;
-            case R.id.menu_list_mode:
-                mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?
-                        TextNote.MODE_CHECK_LIST : 0);
-                break;
-            case R.id.menu_share:
-                getWorkingText();
-                sendTo(this, mWorkingNote.getContent());
-                break;
-            case R.id.menu_send_to_desktop:
-                sendToDesktop();
-                break;
-            case R.id.menu_alert:
-                setReminder();
-                break;
-            case R.id.menu_delete_remind:
-                mWorkingNote.setAlertDate(0, false);
-                break;
-            default:
-                break;
+        }else if(item.getItemId() == R.id.menu_delete) {
+            AlertDialog.Builder builder = new AlertDialog.Builder(this);
+            builder.setTitle(getString(R.string.alert_title_delete));
+            builder.setIcon(android.R.drawable.ic_dialog_alert);
+            builder.setMessage(getString(R.string.alert_message_delete_note));
+            builder.setPositiveButton(android.R.string.ok,
+                    new DialogInterface.OnClickListener() {
+                        public void onClick(DialogInterface dialog, int which) {
+                            deleteCurrentNote();
+                            finish();
+                        }
+                    });
+            builder.setNegativeButton(android.R.string.cancel, null);
+            builder.show();
+        }else if(item.getItemId() == R.id.menu_font_size) {
+            mFontSizeSelector.setVisibility(View.VISIBLE);
+            findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
+        }else if(item.getItemId() == R.id.menu_list_mode) {
+            mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?
+                    TextNote.MODE_CHECK_LIST : 0);
+        }else if(item.getItemId() == R.id.menu_share){
+            getWorkingText();
+            sendTo(this, mWorkingNote.getContent());
+        }else if(item.getItemId() == R.id.menu_send_to_desktop) {
+            sendToDesktop();
+        }else if(item.getItemId() == R.id.menu_alert) {
+            setReminder();
+        }else if(item.getItemId() == R.id.menu_delete_remind) {
+            mWorkingNote.setAlertDate(0, false);
         }
         return true;
     }
@@ -557,7 +599,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());
         d.setOnDateTimeSetListener(new OnDateTimeSetListener() {
             public void OnDateTimeSet(AlertDialog dialog, long date) {
-                mWorkingNote.setAlertDate(date	, true);
+                mWorkingNote.setAlertDate(date, true);
             }
         });
         d.show();
@@ -623,7 +665,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         if (mWorkingNote.getNoteId() > 0) {
             Intent intent = new Intent(this, AlarmReceiver.class);
             intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId()));
-            PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0);
+            PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, PendingIntent.FLAG_IMMUTABLE);
             AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));
             showAlertHeader();
             if(!set) {
@@ -870,4 +912,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     private void showToast(int resId, int duration) {
         Toast.makeText(this, resId, duration).show();
     }
+
+
 }
+
+

app/src/main/java/net/micode/notes/ui/NoteEditText.java

@@ -18,10 +18,12 @@ package net.micode.notes.ui;
 
 import android.content.Context;
 import android.graphics.Rect;
+import android.text.Editable;
 import android.text.Layout;
 import android.text.Selection;
 import android.text.Spanned;
 import android.text.TextUtils;
+import android.text.TextWatcher;
 import android.text.style.URLSpan;
 import android.util.AttributeSet;
 import android.util.Log;
@@ -31,13 +33,14 @@ import android.view.MenuItem;
 import android.view.MenuItem.OnMenuItemClickListener;
 import android.view.MotionEvent;
 import android.widget.EditText;
+import android.widget.TextView;
 
 import net.micode.notes.R;
 
 import java.util.HashMap;
 import java.util.Map;
 
-public class NoteEditText extends EditText {
+public class NoteEditText extends androidx.appcompat.widget.AppCompatEditText {
     private static final String TAG = "NoteEditText";
     private int mIndex;
     private int mSelectionStartBeforeDelete;
@@ -80,6 +83,8 @@ public class NoteEditText extends EditText {
     public NoteEditText(Context context) {
         super(context, null);
         mIndex = 0;
+        //显示字符
+        init();
     }
 
     public void setIndex(int index) {
@@ -92,10 +97,14 @@ public class NoteEditText extends EditText {
 
     public NoteEditText(Context context, AttributeSet attrs) {
         super(context, attrs, android.R.attr.editTextStyle);
+        //显示字符
+        init();
     }
 
     public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
         super(context, attrs, defStyle);
+        //显示字符
+        init();
         // TODO Auto-generated constructor stub
     }
 
@@ -214,4 +223,35 @@ public class NoteEditText extends EditText {
         }
         super.onCreateContextMenu(menu);
     }
+
+    //显示字符数
+    private TextView mCharacterCountView;
+    public void setCharacterCountView(TextView textView) {
+        mCharacterCountView = textView;
+    }
+    private void init() {
+        addTextChangedListener(new TextWatcher() {
+            @Override
+            public void beforeTextChanged(CharSequence s, int start, int count, int after) {
+
+            }
+
+            @Override
+            public void onTextChanged(CharSequence s, int start, int before, int count) {
+
+            }
+
+            @Override
+            public void afterTextChanged(Editable s) {
+                if (mCharacterCountView != null) {
+                    //仅匹配非空白字符
+                    String text = s.toString().replaceAll("\\s", "");
+                    int characterCount = text.length();
+                    mCharacterCountView.setText(String.valueOf(characterCount));
+                }
+            }
+        });
+    }
 }
+
+

app/src/main/java/net/micode/notes/ui/NotesListActivity.java

@@ -319,28 +319,25 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
                 return true;
             }
 
-            switch (item.getItemId()) {
-                case R.id.delete:
-                    AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
-                    builder.setTitle(getString(R.string.alert_title_delete));
-                    builder.setIcon(android.R.drawable.ic_dialog_alert);
-                    builder.setMessage(getString(R.string.alert_message_delete_notes,
-                                             mNotesListAdapter.getSelectedCount()));
-                    builder.setPositiveButton(android.R.string.ok,
-                                             new DialogInterface.OnClickListener() {
-                                                 public void onClick(DialogInterface dialog,
-                                                         int which) {
-                                                     batchDelete();
-                                                 }
-                                             });
-                    builder.setNegativeButton(android.R.string.cancel, null);
-                    builder.show();
-                    break;
-                case R.id.move:
-                    startQueryDestinationFolders();
-                    break;
-                default:
-                    return false;
+            if (item.getItemId() == R.id.delete) {
+                AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
+                builder.setTitle(getString(R.string.alert_title_delete));
+                builder.setIcon(android.R.drawable.ic_dialog_alert);
+                builder.setMessage(getString(R.string.alert_message_delete_notes,
+                        mNotesListAdapter.getSelectedCount()));
+                builder.setPositiveButton(android.R.string.ok,
+                        new DialogInterface.OnClickListener() {
+                            public void onClick(DialogInterface dialog,
+                                                int which) {
+                                batchDelete();
+                            }
+                        });
+                builder.setNegativeButton(android.R.string.cancel, null);
+                builder.show();
+            }else if(item.getItemId() == R.id.move) {
+                startQueryDestinationFolders();
+            }else{
+                return false;
             }
             return true;
         }
@@ -558,12 +555,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     }
 
     public void onClick(View v) {
-        switch (v.getId()) {
-            case R.id.btn_new_note:
+        if (v.getId() == R.id.btn_new_note) {
                 createNewNote();
-                break;
-            default:
-                break;
         }
     }
 
@@ -780,40 +773,26 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
 
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
-        switch (item.getItemId()) {
-            case R.id.menu_new_folder: {
-                showCreateOrModifyFolderDialog(true);
-                break;
-            }
-            case R.id.menu_export_text: {
-                exportNoteToText();
-                break;
-            }
-            case R.id.menu_sync: {
-                if (isSyncMode()) {
-                    if (TextUtils.equals(item.getTitle(), getString(R.string.menu_sync))) {
-                        GTaskSyncService.startSync(this);
-                    } else {
-                        GTaskSyncService.cancelSync(this);
-                    }
+        if(item.getItemId() == R.id.menu_new_folder) {
+            showCreateOrModifyFolderDialog(true);
+        }else if(item.getItemId() == R.id.menu_export_text){
+            exportNoteToText();
+        }else if(item.getItemId() == R.id.menu_sync) {
+            if (isSyncMode()) {
+                if (TextUtils.equals(item.getTitle(), getString(R.string.menu_sync))) {
+                    GTaskSyncService.startSync(this);
                 } else {
-                    startPreferenceActivity();
+                    GTaskSyncService.cancelSync(this);
                 }
-                break;
-            }
-            case R.id.menu_setting: {
+            } else {
                 startPreferenceActivity();
-                break;
-            }
-            case R.id.menu_new_note: {
-                createNewNote();
-                break;
             }
-            case R.id.menu_search:
+        }else if(item.getItemId() == R.id.menu_setting){
+            startPreferenceActivity();
+        }else if(item.getItemId() == R.id.menu_new_note){
+            createNewNote();
+        }else if(item.getItemId() == R.id.menu_search){
                 onSearchRequested();
-                break;
-            default:
-                break;
         }
         return true;
     }

app/src/main/java/net/micode/notes/ui/NotesListItem.java

@@ -16,6 +16,7 @@
 
 package net.micode.notes.ui;
 
+import android.annotation.SuppressLint;
 import android.content.Context;
 import android.text.format.DateUtils;
 import android.view.View;
@@ -48,6 +49,7 @@ public class NotesListItem extends LinearLayout {
         mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
     }
 
+    @SuppressLint("SetTextI18n")
     public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
         if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
             mCheckBox.setVisibility(View.VISIBLE);

app/src/main/java/net/micode/notes/ui/NotesPreferenceActivity.java

@@ -18,7 +18,6 @@ package net.micode.notes.ui;
 
 import android.accounts.Account;
 import android.accounts.AccountManager;
-import android.app.ActionBar;
 import android.app.AlertDialog;
 import android.content.BroadcastReceiver;
 import android.content.ContentValues;
@@ -27,6 +26,7 @@ import android.content.DialogInterface;
 import android.content.Intent;
 import android.content.IntentFilter;
 import android.content.SharedPreferences;
+import android.os.Build;
 import android.os.Bundle;
 import android.preference.Preference;
 import android.preference.Preference.OnPreferenceClickListener;
@@ -35,18 +35,21 @@ import android.preference.PreferenceCategory;
 import android.text.TextUtils;
 import android.text.format.DateFormat;
 import android.view.LayoutInflater;
-import android.view.Menu;
 import android.view.MenuItem;
 import android.view.View;
 import android.widget.Button;
 import android.widget.TextView;
 import android.widget.Toast;
 
+import androidx.annotation.RequiresApi;
+
 import net.micode.notes.R;
 import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.gtask.remote.GTaskSyncService;
 
+import java.util.Objects;
+
 
 public class NotesPreferenceActivity extends PreferenceActivity {
     public static final String PREFERENCE_NAME = "notes_preferences";
@@ -69,19 +72,20 @@ public class NotesPreferenceActivity extends PreferenceActivity {
 
     private boolean mHasAddedAccount;
 
+    @RequiresApi(api = Build.VERSION_CODES.TIRAMISU)
     @Override
     protected void onCreate(Bundle icicle) {
         super.onCreate(icicle);
 
         /* using the app icon for navigation */
-        getActionBar().setDisplayHomeAsUpEnabled(true);
+        Objects.requireNonNull(getActionBar()).setDisplayHomeAsUpEnabled(true);
 
         addPreferencesFromResource(R.xml.preferences);
         mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
         mReceiver = new GTaskReceiver();
         IntentFilter filter = new IntentFilter();
         filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
-        registerReceiver(mReceiver, filter);
+        registerReceiver(mReceiver, filter, Context.RECEIVER_NOT_EXPORTED);
 
         mOriAccounts = null;
         View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);