对ui代码进行了注释，结构优化，对部分ui进行了美化效果

Notes-master/.idea/.name

@@ -0,0 +1 @@
+AlarmAlertActivity.java

Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java

@@ -16,143 +16,456 @@
 
 package net.micode.notes.ui;
 
-import android.app.Activity;
+import android.accounts.Account;
+import android.accounts.AccountManager;
+import android.app.ActionBar;
 import android.app.AlertDialog;
+import android.content.BroadcastReceiver;
+import android.content.ContentValues;
 import android.content.Context;
 import android.content.DialogInterface;
-import android.content.DialogInterface.OnClickListener;
-import android.content.DialogInterface.OnDismissListener;
 import android.content.Intent;
-import android.media.AudioManager;
+import android.content.IntentFilter;
-import android.media.MediaPlayer;
+import android.content.SharedPreferences;
-import android.media.RingtoneManager;
-import android.net.Uri;
 import android.os.Bundle;
-import android.os.PowerManager;
+import android.preference.Preference;
-import android.provider.Settings;
+import android.preference.Preference.OnPreferenceClickListener;
-import android.view.Window;
+import android.preference.PreferenceActivity;
-import android.view.WindowManager;
+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 net.micode.notes.R;
 import net.micode.notes.data.Notes;
-import net.micode.notes.tool.DataUtils;
+import net.micode.notes.data.Notes.NoteColumns;
-
+import net.micode.notes.gtask.remote.GTaskSyncService;
-import java.io.IOException;
 
+/**
+ * NotesPreferenceActivity 类用于管理便签应用的设置界面。
+ * 它允许用户选择同步账户、启动或取消同步，并显示上次同步时间。
+ */
+public class NotesPreferenceActivity extends PreferenceActivity {
+    // 偏好设置的名称
+    public static final String PREFERENCE_NAME = "notes_preferences";
+    // 同步账户名称的偏好设置键
+    public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";
+    // 上次同步时间的偏好设置键
+    public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
+    // 设置背景颜色随机显示的偏好设置键
+    public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";
+    // 同步账户的偏好设置类别键
+    private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
+    // 权限过滤器键
+    private static final String AUTHORITIES_FILTER_KEY = "authorities";
 
-public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
+    // 同步账户的偏好设置类别
-    private long mNoteId;
+    private PreferenceCategory mAccountCategory;
-    private String mSnippet;
+    // 用于接收 GTask 同步服务广播的接收器
-    private static final int SNIPPET_PREW_MAX_LEN = 60;
+    private GTaskReceiver mReceiver;
-    MediaPlayer mPlayer;
+    // 原始的 Google 账户数组
+    private Account[] mOriAccounts;
+    // 标记是否添加了新账户
+    private boolean mHasAddedAccount;
 
     @Override
-    protected void onCreate(Bundle savedInstanceState) {
+    protected void onCreate(Bundle icicle) {
-        super.onCreate(savedInstanceState);
+        super.onCreate(icicle);
-        requestWindowFeature(Window.FEATURE_NO_TITLE);
+
+        // 设置 ActionBar 可返回
+        getActionBar().setDisplayHomeAsUpEnabled(true);
+
+        // 加载偏好设置资源
+        addPreferencesFromResource(R.xml.preferences);
+        // 找到同步账户的偏好设置类别
+        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
+        // 创建 GTask 广播接收器
+        mReceiver = new GTaskReceiver();
+        // 创建意图过滤器，用于接收 GTask 同步服务的广播
+        IntentFilter filter = new IntentFilter();
+        filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
+        // 注册广播接收器
+        registerReceiver(mReceiver, filter);
+
+        // 初始化原始账户数组
+        mOriAccounts = null;
+        // 加载设置界面的头部视图
+        View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
+        // 将头部视图添加到列表视图中
+        getListView().addHeaderView(header, null, true);
+    }
 
-        final Window win = getWindow();
+    @Override
-        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
+    protected void onResume() {
+        super.onResume();
 
-        if (!isScreenOn()) {
+        // 如果添加了新账户，自动设置同步账户
-            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
+        if (mHasAddedAccount) {
-                    | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
+            Account[] accounts = getGoogleAccounts();
-                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
+            if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
-                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
+                for (Account accountNew : accounts) {
+                    boolean found = false;
+                    for (Account accountOld : mOriAccounts) {
+                        if (TextUtils.equals(accountOld.name, accountNew.name)) {
+                            found = true;
+                            break;
+                        }
+                    }
+                    if (!found) {
+                        setSyncAccount(accountNew.name);
+                        break;
+                    }
+                }
+            }
         }
 
-        Intent intent = getIntent();
+        // 刷新界面
+        refreshUI();
+    }
 
-        try {
+    @Override
-            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+    protected void onDestroy() {
-            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+        // 注销广播接收器
-            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
+        if (mReceiver != null) {
-                    SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
+            unregisterReceiver(mReceiver);
-                    : mSnippet;
+        }
-        } catch (IllegalArgumentException e) {
+        super.onDestroy();
-            e.printStackTrace();
-            return;
     }
 
-        mPlayer = new MediaPlayer();
+    /**
-        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+     * 加载同步账户的偏好设置项
-            showActionDialog();
+     */
-            playAlarmSound();
+    private void loadAccountPreference() {
+        // 清空账户偏好设置类别中的所有项
+        mAccountCategory.removeAll();
+
+        // 创建一个新的偏好设置项
+        Preference accountPref = new Preference(this);
+        // 获取默认的同步账户名称
+        final String defaultAccount = getSyncAccountName(this);
+        // 设置偏好设置项的标题
+        accountPref.setTitle(getString(R.string.preferences_account_title));
+        // 设置偏好设置项的摘要
+        accountPref.setSummary(getString(R.string.preferences_account_summary));
+        // 设置偏好设置项的点击监听器
+        accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
+            public boolean onPreferenceClick(Preference preference) {
+                // 如果当前没有正在同步
+                if (!GTaskSyncService.isSyncing()) {
+                    // 如果默认账户为空，显示选择账户的对话框
+                    if (TextUtils.isEmpty(defaultAccount)) {
+                        showSelectAccountAlertDialog();
                     } else {
-            finish();
+                        // 如果已经设置了账户，显示更改账户的确认对话框
+                        showChangeAccountConfirmAlertDialog();
                     }
+                } else {
+                    // 如果正在同步，显示提示信息
+                    Toast.makeText(NotesPreferenceActivity.this,
+                            R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
+                            .show();
                 }
+                return true;
+            }
+        });
 
-    private boolean isScreenOn() {
+        // 将账户偏好设置项添加到账户偏好设置类别中
-        PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
+        mAccountCategory.addPreference(accountPref);
-        return pm.isScreenOn();
     }
 
-    private void playAlarmSound() {
+    /**
-        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
+     * 加载同步按钮和上次同步时间的显示
+     */
+    private void loadSyncButton() {
+        // 找到同步按钮和上次同步时间的文本视图
+        Button syncButton = (Button) findViewById(R.id.preference_sync_button);
+        TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
 
-        int silentModeStreams = Settings.System.getInt(getContentResolver(),
+        // 根据同步状态设置按钮的文本和点击监听器
-                Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
+        if (GTaskSyncService.isSyncing()) {
+            syncButton.setText(getString(R.string.preferences_button_sync_cancel));
+            syncButton.setOnClickListener(new View.OnClickListener() {
+                public void onClick(View v) {
+                    // 取消同步
+                    GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
+                }
+            });
+        } else {
+            syncButton.setText(getString(R.string.preferences_button_sync_immediately));
+            syncButton.setOnClickListener(new View.OnClickListener() {
+                public void onClick(View v) {
+                    // 立即开始同步
+                    GTaskSyncService.startSync(NotesPreferenceActivity.this);
+                }
+            });
+        }
+        // 如果同步账户不为空，启用同步按钮
+        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
 
-        if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
+        // 根据同步状态设置上次同步时间的显示
-            mPlayer.setAudioStreamType(silentModeStreams);
+        if (GTaskSyncService.isSyncing()) {
+            lastSyncTimeView.setText(GTaskSyncService.getProgressString());
+            lastSyncTimeView.setVisibility(View.VISIBLE);
+        } else {
+            long lastSyncTime = getLastSyncTime(this);
+            if (lastSyncTime != 0) {
+                lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
+                        DateFormat.format(getString(R.string.preferences_last_sync_time_format),
+                                lastSyncTime)));
+                lastSyncTimeView.setVisibility(View.VISIBLE);
             } else {
-            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
+                lastSyncTimeView.setVisibility(View.GONE);
-        }
+            }
-        try {
+        }
-            mPlayer.setDataSource(this, url);
-            mPlayer.prepare();
-            mPlayer.setLooping(true);
-            mPlayer.start();
-        } catch (IllegalArgumentException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        } catch (SecurityException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        } catch (IllegalStateException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        } catch (IOException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        }
-    }
-
-    private void showActionDialog() {
-        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
-        dialog.setTitle(R.string.app_name);
-        dialog.setMessage(mSnippet);
-        dialog.setPositiveButton(R.string.notealert_ok, this);
-        if (isScreenOn()) {
-            dialog.setNegativeButton(R.string.notealert_enter, this);
-        }
-        dialog.show().setOnDismissListener(this);
     }
 
+    /**
+     * 刷新界面，重新加载账户偏好设置和同步按钮
+     */
+    private void refreshUI() {
+        loadAccountPreference();
+        loadSyncButton();
+    }
+
+    /**
+     * 显示选择账户的对话框
+     */
+    private void showSelectAccountAlertDialog() {
+        // 创建一个 AlertDialog 构建器
+        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+
+        // 加载账户选择对话框的标题视图
+        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+        titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
+        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+        subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
+
+        // 设置对话框的自定义标题
+        dialogBuilder.setCustomTitle(titleView);
+        dialogBuilder.setPositiveButton(null, null);
+
+        // 获取所有的 Google 账户
+        Account[] accounts = getGoogleAccounts();
+        // 获取默认的同步账户名称
+        String defAccount = getSyncAccountName(this);
+
+        // 记录原始账户数组
+        mOriAccounts = accounts;
+        // 标记未添加新账户
+        mHasAddedAccount = false;
+
+        if (accounts.length > 0) {
+            // 创建一个字符序列数组，用于显示账户名称
+            CharSequence[] items = new CharSequence[accounts.length];
+            final CharSequence[] itemMapping = items;
+            int checkedItem = -1;
+            int index = 0;
+            for (Account account : accounts) {
+                if (TextUtils.equals(account.name, defAccount)) {
+                    checkedItem = index;
+                }
+                items[index++] = account.name;
+            }
+            // 设置单选列表项
+            dialogBuilder.setSingleChoiceItems(items, checkedItem,
+                    new DialogInterface.OnClickListener() {
                         public void onClick(DialogInterface dialog, int which) {
-        switch (which) {
+                            // 设置选择的账户为同步账户
-            case DialogInterface.BUTTON_NEGATIVE:
+                            setSyncAccount(itemMapping[which].toString());
-                Intent intent = new Intent(this, NoteEditActivity.class);
+                            // 关闭对话框
-                intent.setAction(Intent.ACTION_VIEW);
+                            dialog.dismiss();
-                intent.putExtra(Intent.EXTRA_UID, mNoteId);
+                            // 刷新界面
-                startActivity(intent);
+                            refreshUI();
-                break;
+                        }
-            default:
+                    });
-                break;
+        }
+
+        // 加载添加账户的视图
+        View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
+        dialogBuilder.setView(addAccountView);
+
+        // 显示对话框
+        final AlertDialog dialog = dialogBuilder.show();
+        addAccountView.setOnClickListener(new View.OnClickListener() {
+            public void onClick(View v) {
+                // 标记添加了新账户
+                mHasAddedAccount = true;
+                // 创建一个添加账户的意图
+                Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
+                intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
+                    "gmail-ls"
+                });
+                // 启动添加账户的活动
+                startActivityForResult(intent, -1);
+                // 关闭对话框
+                dialog.dismiss();
+            }
+        });
+    }
+
+    /**
+     * 显示更改账户的确认对话框
+     */
+    private void showChangeAccountConfirmAlertDialog() {
+        // 创建一个 AlertDialog 构建器
+        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+
+        // 加载账户更改对话框的标题视图
+        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+        titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
+                getSyncAccountName(this)));
+        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+        subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
+        // 设置对话框的自定义标题
+        dialogBuilder.setCustomTitle(titleView);
+
+        // 创建一个菜单项数组
+        CharSequence[] menuItemArray = new CharSequence[] {
+                getString(R.string.preferences_menu_change_account),
+                getString(R.string.preferences_menu_remove_account),
+                getString(R.string.preferences_menu_cancel)
+        };
+        // 设置菜单项的点击监听器
+        dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
+            public void onClick(DialogInterface dialog, int which) {
+                if (which == 0) {
+                    // 显示选择账户的对话框
+                    showSelectAccountAlertDialog();
+                } else if (which == 1) {
+                    // 移除同步账户
+                    removeSyncAccount();
+                    // 刷新界面
+                    refreshUI();
+                }
+            }
+        });
+        // 显示对话框
+        dialogBuilder.show();
+    }
+
+    /**
+     * 获取所有的 Google 账户
+     * @return 包含所有 Google 账户的数组
+     */
+    private Account[] getGoogleAccounts() {
+        // 获取账户管理器
+        AccountManager accountManager = AccountManager.get(this);
+        // 获取所有的 Google 账户
+        return accountManager.getAccountsByType("com.google");
     }
+
+    /**
+     * 设置同步账户
+     * @param account 要设置的账户名称
+     */
+    private void setSyncAccount(String account) {
+        // 如果当前同步账户与要设置的账户不同
+        if (!getSyncAccountName(this).equals(account)) {
+            // 获取共享偏好设置
+            SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+            SharedPreferences.Editor editor = settings.edit();
+            if (account != null) {
+                // 保存同步账户名称
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
+            } else {
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+            }
+            // 提交更改
+            editor.commit();
+
+            // 清空上次同步时间
+            setLastSyncTime(this, 0);
+
+            // 清空本地的 GTask 相关信息
+            new Thread(new Runnable() {
+                public void run() {
+                    ContentValues values = new ContentValues();
+                    values.put(NoteColumns.GTASK_ID, "");
+                    values.put(NoteColumns.SYNC_ID, 0);
+                    // 更新所有便签的 GTask 相关信息
+                    getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
                 }
+            }).start();
 
-    public void onDismiss(DialogInterface dialog) {
+            // 显示设置成功的提示信息
-        stopAlarmSound();
+            Toast.makeText(NotesPreferenceActivity.this,
-        finish();
+                    getString(R.string.preferences_toast_success_set_accout, account),
+                    Toast.LENGTH_SHORT).show();
+        }
     }
 
-    private void stopAlarmSound() {
+    /**
-        if (mPlayer != null) {
+     * 移除同步账户
-            mPlayer.stop();
+     */
-            mPlayer.release();
+    private void removeSyncAccount() {
-            mPlayer = null;
+        // 获取共享偏好设置
+        SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = settings.edit();
+        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
+            // 移除同步账户名称
+            editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);
         }
+        if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {
+            // 移除上次同步时间
+            editor.remove(PREFERENCE_LAST_SYNC_TIME);
+        }
+        // 提交更改
+        editor.commit();
+
+        // 清空本地的 GTask 相关信息
+        new Thread(new Runnable() {
+            public void run() {
+                ContentValues values = new ContentValues();
+                values.put(NoteColumns.GTASK_ID, "");
+                values.put(NoteColumns.SYNC_ID, 0);
+                // 更新所有便签的 GTask 相关信息
+                getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
             }
-}
+        }).start();
+    }
+
+    /**
+     * 获取当前的同步账户名称
+     * @param context 上下文对象
+     * @return 当前的同步账户名称，如果没有设置则返回空字符串
+     */
+    public static String getSyncAccountName(Context context) {
+        // 获取共享偏好设置
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        // 获取同步账户名称
+        return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+    }
+
+    /**
+     * 设置上次同步时间
+     * @param context 上下文对象
+     * @param time 上次同步的时间
+     */
+    public static void setLastSyncTime(Context context, long time) {
+        // 获取共享偏好设置
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = settings.edit();
+        // 保存上次同步时间
+        editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);
+        // 提交更改
+        editor.commit();
+    }
+
+    /**
+     * 获取上次同步时间
+     * @param context 上下文对象
+     * @return 上次同步的时间，如果没有同步过则返回 0
+     */
+    public static long getLastSyncTime(Context context) {
+        // 获取共享偏好设置
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,

Notes-master/src/net/micode/notes/ui/AlarmInitReceiver.java

@@ -27,38 +27,65 @@ import android.database.Cursor;
 import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
 
-
+/**
+ * AlarmInitReceiver 类是一个广播接收器，用于在接收到特定广播时，
+ * 初始化所有已设置且未触发的提醒闹钟。
+ */
 public class AlarmInitReceiver extends BroadcastReceiver {
 
+    // 定义查询笔记时需要的列，包括笔记的 ID 和提醒日期
     private static final String [] PROJECTION = new String [] {
         NoteColumns.ID,
         NoteColumns.ALERTED_DATE
     };
 
+    // 定义查询结果中笔记 ID 所在的列索引
     private static final int COLUMN_ID                = 0;
+    // 定义查询结果中提醒日期所在的列索引
     private static final int COLUMN_ALERTED_DATE      = 1;
 
+    /**
+     * 当接收到广播时，此方法会被调用。
+     * 它会查询所有设置了提醒且提醒日期在当前时间之后的笔记，
+     * 并为每个笔记设置一个闹钟。
+     *
+     * @param context 上下文对象，用于访问系统服务和内容提供者
+     * @param intent 接收到的广播意图
+     */
     @Override
     public void onReceive(Context context, Intent intent) {
+        // 获取当前时间的毫秒数
         long currentDate = System.currentTimeMillis();
+        // 查询所有设置了提醒且提醒日期在当前时间之后的笔记
         Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
                 PROJECTION,
+                // 查询条件：提醒日期大于当前时间，并且笔记类型为普通笔记
                 NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
                 new String[] { String.valueOf(currentDate) },
                 null);
 
+        // 如果查询结果不为空
         if (c != null) {
+            // 将游标移动到第一行
             if (c.moveToFirst()) {
+                // 循环遍历查询结果的每一行
                 do {
+                    // 获取当前笔记的提醒日期
                     long alertDate = c.getLong(COLUMN_ALERTED_DATE);
+                    // 创建一个新的意图，用于触发 AlarmReceiver 广播接收器
                     Intent sender = new Intent(context, AlarmReceiver.class);
+                    // 设置意图的数据，包含笔记的 URI 和 ID
                     sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
+                    // 创建一个 PendingIntent，用于在闹钟触发时发送广播
                     PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
+                    // 获取系统的闹钟服务
                     AlarmManager alermManager = (AlarmManager) context
                             .getSystemService(Context.ALARM_SERVICE);
+                    // 设置一个 RTC_WAKEUP 类型的闹钟，在提醒日期触发时唤醒设备
                     alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
                 } while (c.moveToNext());
             }
+            // 关闭游标，释放资源
             c.close();
         }
     }

Notes-master/src/net/micode/notes/ui/DateTimePicker.java

@@ -21,64 +21,100 @@ 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;
 
+/**
+ * DateTimePicker 类用于创建一个日期和时间选择器，它允许用户选择日期和时间。
+ * 该选择器包含日期、小时、分钟和上午/下午（AM/PM）的选择功能。
+ */
 public class DateTimePicker extends FrameLayout {
 
+    // 默认的启用状态
     private static final boolean DEFAULT_ENABLE_STATE = true;
 
+    // 半天的小时数
     private static final int HOURS_IN_HALF_DAY = 12;
+    // 一整天的小时数
     private static final int HOURS_IN_ALL_DAY = 24;
+    // 一周的天数
     private static final int DAYS_IN_ALL_WEEK = 7;
+    // 日期选择器的最小值
     private static final int DATE_SPINNER_MIN_VAL = 0;
+    // 日期选择器的最大值
     private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;
+    // 24小时制小时选择器的最小值
     private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
+    // 24小时制小时选择器的最大值
     private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
+    // 12小时制小时选择器的最小值
     private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
+    // 12小时制小时选择器的最大值
     private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;
+    // 分钟选择器的最小值
     private static final int MINUT_SPINNER_MIN_VAL = 0;
+    // 分钟选择器的最大值
     private static final int MINUT_SPINNER_MAX_VAL = 59;
+    // 上午/下午（AM/PM）选择器的最小值
     private static final int AMPM_SPINNER_MIN_VAL = 0;
+    // 上午/下午（AM/PM）选择器的最大值
     private static final int AMPM_SPINNER_MAX_VAL = 1;
 
+    // 日期选择器
     private final NumberPicker mDateSpinner;
+    // 小时选择器
     private final NumberPicker mHourSpinner;
+    // 分钟选择器
     private final NumberPicker mMinuteSpinner;
+    // 上午/下午（AM/PM）选择器
     private final NumberPicker mAmPmSpinner;
+    // 用于存储当前日期和时间的 Calendar 对象
     private Calendar mDate;
 
+    // 用于显示日期的字符串数组
     private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
 
+    // 是否为上午的标志
     private boolean mIsAm;
 
+    // 是否为24小时制的标志
     private boolean mIs24HourView;
 
+    // 选择器的启用状态
     private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
 
+    // 初始化标志，用于避免在初始化过程中触发不必要的事件
     private boolean mInitialising;
 
+    // 日期和时间改变监听器
     private OnDateTimeChangedListener mOnDateTimeChangedListener;
 
+    // 日期选择器值改变监听器
     private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 根据新值和旧值的差值，更新日期
             mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
+            // 更新日期选择器的显示
             updateDateControl();
+            // 触发日期和时间改变事件
             onDateTimeChanged();
         }
     };
 
+    // 小时选择器值改变监听器
     private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 日期是否改变的标志
             boolean isDateChanged = false;
+            // 创建一个新的 Calendar 对象
             Calendar cal = Calendar.getInstance();
             if (!mIs24HourView) {
+                // 在12小时制下，处理跨天的情况
                 if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, 1);
@@ -88,12 +124,15 @@ public class DateTimePicker extends FrameLayout {
                     cal.add(Calendar.DAY_OF_YEAR, -1);
                     isDateChanged = true;
                 }
+                // 处理上午/下午（AM/PM）的切换
                 if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY ||
                         oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
                     mIsAm = !mIsAm;
+                    // 更新上午/下午（AM/PM）选择器的显示
                     updateAmPmControl();
                 }
             } else {
+                // 在24小时制下，处理跨天的情况
                 if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, 1);
@@ -104,10 +143,14 @@ public class DateTimePicker extends FrameLayout {
                     isDateChanged = true;
                 }
             }
+            // 计算新的小时数
             int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY);
+            // 设置新的小时数
             mDate.set(Calendar.HOUR_OF_DAY, newHour);
+            // 触发日期和时间改变事件
             onDateTimeChanged();
             if (isDateChanged) {
+                // 如果日期改变，更新年、月、日
                 setCurrentYear(cal.get(Calendar.YEAR));
                 setCurrentMonth(cal.get(Calendar.MONTH));
                 setCurrentDay(cal.get(Calendar.DAY_OF_MONTH));
@@ -115,182 +158,269 @@ public class DateTimePicker extends FrameLayout {
         }
     };
 
+    // 分钟选择器值改变监听器
     private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 分钟选择器的最小值
             int minValue = mMinuteSpinner.getMinValue();
+            // 分钟选择器的最大值
             int maxValue = mMinuteSpinner.getMaxValue();
+            // 小时偏移量
             int offset = 0;
+            // 处理分钟跨小时的情况
             if (oldVal == maxValue && newVal == minValue) {
                 offset += 1;
             } else if (oldVal == minValue && newVal == maxValue) {
                 offset -= 1;
             }
             if (offset != 0) {
+                // 根据偏移量更新小时数
                 mDate.add(Calendar.HOUR_OF_DAY, offset);
+                // 更新小时选择器的显示
                 mHourSpinner.setValue(getCurrentHour());
+                // 更新日期选择器的显示
                 updateDateControl();
+                // 获取当前小时数
                 int newHour = getCurrentHourOfDay();
                 if (newHour >= HOURS_IN_HALF_DAY) {
                     mIsAm = false;
+                    // 更新上午/下午（AM/PM）选择器的显示
                     updateAmPmControl();
                 } else {
                     mIsAm = true;
+                    // 更新上午/下午（AM/PM）选择器的显示
                     updateAmPmControl();
                 }
             }
+            // 设置新的分钟数
             mDate.set(Calendar.MINUTE, newVal);
+            // 触发日期和时间改变事件
             onDateTimeChanged();
         }
     };
 
+    // 上午/下午（AM/PM）选择器值改变监听器
     private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 切换上午/下午（AM/PM）状态
             mIsAm = !mIsAm;
             if (mIsAm) {
+                // 如果切换到上午，减去12小时
                 mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
             } else {
+                // 如果切换到下午，加上12小时
                 mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
             }
+            // 更新上午/下午（AM/PM）选择器的显示
             updateAmPmControl();
+            // 触发日期和时间改变事件
             onDateTimeChanged();
         }
     };
 
+    /**
+     * 日期和时间改变监听器接口，用于在日期和时间改变时通知外部
+     */
     public interface OnDateTimeChangedListener {
+        /**
+         * 当日期和时间改变时调用
+         *
+         * @param view      DateTimePicker 视图
+         * @param year      年份
+         * @param month     月份
+         * @param dayOfMonth 日
+         * @param hourOfDay 小时（24小时制）
+         * @param minute    分钟
+         */
         void onDateTimeChanged(DateTimePicker view, int year, int month,
                                int dayOfMonth, int hourOfDay, int minute);
     }
 
+    /**
+     * 构造函数，使用当前时间初始化
+     *
+     * @param context 上下文
+     */
     public DateTimePicker(Context context) {
         this(context, System.currentTimeMillis());
     }
 
+    /**
+     * 构造函数，使用指定的时间初始化
+     *
+     * @param context 上下文
+     * @param date    时间（毫秒）
+     */
     public DateTimePicker(Context context, long date) {
         this(context, date, DateFormat.is24HourFormat(context));
     }
 
+    /**
+     * 构造函数，使用指定的时间和是否为24小时制初始化
+     *
+     * @param context     上下文
+     * @param date        时间（毫秒）
+     * @param is24HourView 是否为24小时制
+     */
     public DateTimePicker(Context context, long date, boolean is24HourView) {
         super(context);
+        // 初始化 Calendar 对象
         mDate = Calendar.getInstance();
+        // 设置初始化标志
         mInitialising = true;
+        // 判断当前是否为上午
         mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY;
+        // 加载布局文件
         inflate(context, R.layout.datetime_picker, this);
 
+        // 初始化日期选择器
         mDateSpinner = (NumberPicker) findViewById(R.id.date);
         mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL);
         mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL);
         mDateSpinner.setOnValueChangedListener(mOnDateChangedListener);
 
+        // 初始化小时选择器
         mHourSpinner = (NumberPicker) findViewById(R.id.hour);
         mHourSpinner.setOnValueChangedListener(mOnHourChangedListener);
+        // 初始化分钟选择器
         mMinuteSpinner =  (NumberPicker) findViewById(R.id.minute);
         mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL);
         mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL);
         mMinuteSpinner.setOnLongPressUpdateInterval(100);
         mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
 
+        // 获取上午/下午（AM/PM）的字符串数组
         String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
+        // 初始化上午/下午（AM/PM）选择器
         mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
         mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
         mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL);
         mAmPmSpinner.setDisplayedValues(stringsForAmPm);
         mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener);
 
-        // update controls to initial state
+        // 更新日期选择器的显示
         updateDateControl();
+        // 更新小时选择器的显示
         updateHourControl();
+        // 更新上午/下午（AM/PM）选择器的显示
         updateAmPmControl();
 
+        // 设置是否为24小时制
         set24HourView(is24HourView);
 
-        // set to current time
+        // 设置当前日期和时间
         setCurrentDate(date);
 
+        // 设置选择器的启用状态
         setEnabled(isEnabled());
 
-        // set the content descriptions
+        // 设置内容描述
         mInitialising = false;
     }
 
+    /**
+     * 设置选择器的启用状态
+     *
+     * @param enabled 是否启用
+     */
     @Override
     public void setEnabled(boolean enabled) {
         if (mIsEnabled == enabled) {
             return;
         }
         super.setEnabled(enabled);
+        // 设置日期选择器的启用状态
         mDateSpinner.setEnabled(enabled);
+        // 设置分钟选择器的启用状态
         mMinuteSpinner.setEnabled(enabled);
+        // 设置小时选择器的启用状态
         mHourSpinner.setEnabled(enabled);
+        // 设置上午/下午（AM/PM）选择器的启用状态
         mAmPmSpinner.setEnabled(enabled);
+        // 更新启用状态标志
         mIsEnabled = enabled;
     }
 
+    /**
+     * 获取选择器的启用状态
+     *
+     * @return 是否启用
+     */
     @Override
     public boolean isEnabled() {
         return mIsEnabled;
     }
 
     /**
-     * Get the current date in millis
+     * 获取当前日期和时间（毫秒）
      *
-     * @return the current date in millis
+     * @return 当前日期和时间（毫秒）
      */
     public long getCurrentDateInTimeMillis() {
         return mDate.getTimeInMillis();
     }
 
     /**
-     * Set the current date
+     * 设置当前日期和时间
      *
-     * @param date The current date in millis
+     * @param date 当前日期和时间（毫秒）
      */
     public void setCurrentDate(long date) {
         Calendar cal = Calendar.getInstance();
         cal.setTimeInMillis(date);
+        // 设置年、月、日、小时、分钟
         setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH),
                 cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE));
     }
 
     /**
-     * Set the current date
+     * 设置当前日期和时间
      *
-     * @param year The current year
+     * @param year      年份
-     * @param month The current month
+     * @param month     月份
-     * @param dayOfMonth The current dayOfMonth
+     * @param dayOfMonth 日
-     * @param hourOfDay The current hourOfDay
+     * @param hourOfDay 小时（24小时制）
-     * @param minute The current minute
+     * @param minute    分钟
      */
     public void setCurrentDate(int year, int month,
                                int dayOfMonth, int hourOfDay, int minute) {
+        // 设置年份
         setCurrentYear(year);
+        // 设置月份
         setCurrentMonth(month);
+        // 设置日期
         setCurrentDay(dayOfMonth);
+        // 设置小时
         setCurrentHour(hourOfDay);
+        // 设置分钟
         setCurrentMinute(minute);
     }
 
     /**
-     * Get current year
+     * 获取当前年份
      *
-     * @return The current year
+     * @return 当前年份
      */
     public int getCurrentYear() {
         return mDate.get(Calendar.YEAR);
     }
 
     /**
-     * Set current year
+     * 设置当前年份
      *
-     * @param year The current year
+     * @param year 当前年份
      */
     public void setCurrentYear(int year) {
         if (!mInitialising && year == getCurrentYear()) {
             return;
         }
+        // 设置年份
         mDate.set(Calendar.YEAR, year);
+        // 更新日期选择器的显示
         updateDateControl();
+        // 触发日期和时间改变事件
         onDateTimeChanged();
     }
 

Notes-master/src/net/micode/notes/ui/DateTimePickerDialog.java

@@ -29,59 +29,126 @@ import android.content.DialogInterface.OnClickListener;
 import android.text.format.DateFormat;
 import android.text.format.DateUtils;
 
+/**
+ * DateTimePickerDialog 类继承自 AlertDialog，用于显示一个日期和时间选择对话框。
+ * 用户可以通过这个对话框选择特定的日期和时间。
+ */
 public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
 
+    // 用于存储用户选择的日期和时间的 Calendar 对象
     private Calendar mDate = Calendar.getInstance();
+    // 标记是否使用 24 小时制显示时间
     private boolean mIs24HourView;
+    // 用于处理日期和时间设置完成后的回调接口
     private OnDateTimeSetListener mOnDateTimeSetListener;
+    // 自定义的日期和时间选择器
     private DateTimePicker mDateTimePicker;
 
+    /**
+     * 定义一个接口，用于在用户设置日期和时间后进行回调。
+     */
     public interface OnDateTimeSetListener {
+        /**
+         * 当用户设置日期和时间后调用此方法。
+         * @param dialog 日期和时间选择对话框实例
+         * @param date 用户选择的日期和时间的毫秒数
+         */
         void OnDateTimeSet(AlertDialog dialog, long date);
     }
 
+    /**
+     * 构造函数，用于创建一个 DateTimePickerDialog 实例。
+     * @param context 上下文对象
+     * @param date 初始显示的日期和时间的毫秒数
+     */
     public DateTimePickerDialog(Context context, long date) {
         super(context);
+        // 创建一个 DateTimePicker 实例
         mDateTimePicker = new DateTimePicker(context);
+        // 将 DateTimePicker 设置为对话框的视图
         setView(mDateTimePicker);
+
+        // 为 DateTimePicker 设置日期和时间改变监听器
         mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
+            /**
+             * 当日期或时间发生改变时调用此方法。
+             * @param view 日期和时间选择器视图
+             * @param year 选择的年份
+             * @param month 选择的月份
+             * @param dayOfMonth 选择的日期
+             * @param hourOfDay 选择的小时
+             * @param minute 选择的分钟
+             */
             public void onDateTimeChanged(DateTimePicker view, int year, int month,
                     int dayOfMonth, int hourOfDay, int minute) {
+                // 更新 Calendar 对象中的日期和时间
                 mDate.set(Calendar.YEAR, year);
                 mDate.set(Calendar.MONTH, month);
                 mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
                 mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
                 mDate.set(Calendar.MINUTE, minute);
+                // 更新对话框的标题，显示当前选择的日期和时间
                 updateTitle(mDate.getTimeInMillis());
             }
         });
+
+        // 设置 Calendar 对象的时间为传入的初始时间
         mDate.setTimeInMillis(date);
+        // 将秒数设置为 0
         mDate.set(Calendar.SECOND, 0);
+        // 设置 DateTimePicker 的当前日期和时间
         mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
+
+        // 设置对话框的“确定”按钮，并设置点击监听器为当前类
         setButton(context.getString(R.string.datetime_dialog_ok), this);
+        // 设置对话框的“取消”按钮，不设置点击监听器
         setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
+
+        // 根据系统设置判断是否使用 24 小时制，并设置相应的显示模式
         set24HourView(DateFormat.is24HourFormat(this.getContext()));
+        // 更新对话框的标题，显示初始日期和时间
         updateTitle(mDate.getTimeInMillis());
     }
 
+    /**
+     * 设置是否使用 24 小时制显示时间。
+     * @param is24HourView 是否使用 24 小时制
+     */
     public void set24HourView(boolean is24HourView) {
         mIs24HourView = is24HourView;
     }
 
+    /**
+     * 设置日期和时间设置完成后的回调监听器。
+     * @param callBack 实现了 OnDateTimeSetListener 接口的回调对象
+     */
     public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
         mOnDateTimeSetListener = callBack;
     }
 
+    /**
+     * 更新对话框的标题，显示当前选择的日期和时间。
+     * @param date 当前选择的日期和时间的毫秒数
+     */
     private void updateTitle(long date) {
+        // 设置日期和时间格式化的标志
         int flag =
             DateUtils.FORMAT_SHOW_YEAR |
             DateUtils.FORMAT_SHOW_DATE |
             DateUtils.FORMAT_SHOW_TIME;
+        // 根据是否使用 24 小时制添加相应的标志
         flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
+        // 使用 DateUtils 格式化日期和时间，并设置为对话框的标题
         setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
     }
 
+    /**
+     * 处理对话框按钮的点击事件。
+     * @param arg0 对话框接口对象
+     * @param arg1 按钮的索引
+     */
     public void onClick(DialogInterface arg0, int arg1) {
+        // 如果设置了回调监听器，则调用其 OnDateTimeSet 方法
         if (mOnDateTimeSetListener != null) {
             mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
         }

Notes-master/src/net/micode/notes/ui/NoteEditActivity.java

@@ -71,103 +71,148 @@ import java.util.Map;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
-//笔记编辑功能
+/**
+ * NoteEditActivity 类用于编辑笔记，处理笔记的创建、加载、保存以及相关设置，如背景颜色、字体大小等。
+ */
 public class NoteEditActivity extends Activity implements OnClickListener,
         NoteSettingChangedListener, OnTextViewChangeListener {
+
+    /**
+     * 头部视图的ViewHolder，用于存储头部视图的相关控件。
+     */
     private class HeadViewHolder {
+        // 显示笔记修改日期的TextView
         public TextView tvModified;
-
+        // 提醒图标ImageView
         public ImageView ivAlertIcon;
-
+        // 显示提醒日期的TextView
         public TextView tvAlertDate;
-
+        // 设置背景颜色的按钮ImageView
         public ImageView ibSetBgColor;
     }
-    //便签背景选择按钮
+
+    // 背景选择按钮和对应背景资源ID的映射
     private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
     static {
+        // 黄色背景按钮和对应资源ID
         sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW);
+        // 红色背景按钮和对应资源ID
         sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED);
+        // 蓝色背景按钮和对应资源ID
         sBgSelectorBtnsMap.put(R.id.iv_bg_blue, ResourceParser.BLUE);
+        // 绿色背景按钮和对应资源ID
         sBgSelectorBtnsMap.put(R.id.iv_bg_green, ResourceParser.GREEN);
+        // 白色背景按钮和对应资源ID
         sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE);
     }
 
+    // 背景选择和对应选中状态视图ID的映射
     private static final Map<Integer, Integer> sBgSelectorSelectionMap = new HashMap<Integer, Integer>();
     static {
+        // 黄色背景选中状态视图ID
         sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select);
+        // 红色背景选中状态视图ID
         sBgSelectorSelectionMap.put(ResourceParser.RED, R.id.iv_bg_red_select);
+        // 蓝色背景选中状态视图ID
         sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select);
+        // 绿色背景选中状态视图ID
         sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select);
+        // 白色背景选中状态视图ID
         sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select);
     }
 
+    // 字体大小按钮和对应字体大小资源ID的映射
     private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<Integer, Integer>();
     static {
+        // 大字体按钮和对应资源ID
         sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE);
+        // 小字体按钮和对应资源ID
         sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL);
+        // 正常字体按钮和对应资源ID
         sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM);
+        // 超大字体按钮和对应资源ID
         sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER);
     }
 
+    // 字体选择和对应选中状态视图ID的映射
     private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<Integer, Integer>();
     static {
+        // 大字体选中状态视图ID
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select);
+        // 小字体选中状态视图ID
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select);
+        // 正常字体选中状态视图ID
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select);
+        // 超大字体选中状态视图ID
         sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);
     }
 
+    // 日志标签
     private static final String TAG = "NoteEditActivity";
 
+    // 头部视图的ViewHolder实例
     private HeadViewHolder mNoteHeaderHolder;
-
+    // 头部视图面板
     private View mHeadViewPanel;
-
+    // 背景颜色选择器视图
     private View mNoteBgColorSelector;
-
+    // 字体大小选择器视图
     private View mFontSizeSelector;
-
+    // 笔记编辑器EditText
     private EditText mNoteEditor;
-
+    // 笔记编辑器面板
     private View mNoteEditorPanel;
-
+    // 工作笔记实例
     private WorkingNote mWorkingNote;
-
+    // 共享偏好设置
     private SharedPreferences mSharedPrefs;
+    // 字体大小ID
     private int mFontSizeId;
 
+    // 共享偏好设置中字体大小的键
     private static final String PREFERENCE_FONT_SIZE = "pref_font_size";
-
+    // 快捷图标标题的最大长度
     private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;
-
+    // 已选中标记
     public static final String TAG_CHECKED = String.valueOf('\u221A');
+    // 未选中标记
     public static final String TAG_UNCHECKED = String.valueOf('\u25A1');
-
+    // 编辑文本列表
     private LinearLayout mEditTextList;
-
+    // 用户查询关键词
     private String mUserQuery;
+    // 正则表达式模式
     private Pattern mPattern;
 
+    /**
+     * 活动创建时调用，初始化布局和状态。
+     *
+     * @param savedInstanceState 保存的实例状态
+     */
     @Override
-    //创建时进行初始化操作
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        //将布局样式进行添加
+        // 设置布局
         this.setContentView(R.layout.note_edit);
+
+        // 如果是首次创建且初始化活动状态失败，则关闭活动
         if (savedInstanceState == null && !initActivityState(getIntent())) {
             finish();
             return;
         }
+        // 初始化资源
         initResources();
     }
 
     /**
-     * 当前Activity可能因内存不足被杀死，再次加载时应恢复之前的状态
+     * 恢复活动状态时调用，用于恢复之前保存的状态。
+     *
+     * @param savedInstanceState 保存的实例状态
      */
     @Override
     protected void onRestoreInstanceState(Bundle savedInstanceState) {
         super.onRestoreInstanceState(savedInstanceState);
+        // 如果保存的实例状态不为空且包含笔记ID，则恢复活动状态
         if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) {
             Intent intent = new Intent(Intent.ACTION_VIEW);
             intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID));
@@ -178,31 +223,39 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             Log.d(TAG, "Restoring from killed activity");
         }
     }
-    //初始化活动状态函数
+
-    private boolean initActivityState(Intent intent) {
     /**
-         * 如果用户指定查看笔记但未提供ID，跳转到笔记列表页
+     * 初始化活动状态，根据意图加载或创建笔记。
+     *
+     * @param intent 传入的意图
+     * @return 如果初始化成功返回true，否则返回false
      */
+    private boolean initActivityState(Intent intent) {
+        // 清空工作笔记
         mWorkingNote = null;
+        // 如果是查看笔记的意图
         if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {
+            // 获取笔记ID
             long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);
+            // 初始化用户查询为空
             mUserQuery = "";
 
-            /**
+            // 如果是从搜索结果启动的
-             * 如果是从搜索结果启动
-             */
             if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {
                 noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));
                 mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);
             }
 
+            // 检查笔记是否在数据库中可见
             if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) {
+                // 不可见则跳转到笔记列表活动并提示错误
                 Intent jump = new Intent(this, NotesListActivity.class);
                 startActivity(jump);
                 showToast(R.string.error_note_not_exist);
                 finish();
                 return false;
             } else {
+                // 加载笔记
                 mWorkingNote = WorkingNote.load(this, noteId);
                 if (mWorkingNote == null) {
                     Log.e(TAG, "load note failed with note id" + noteId);
@@ -210,17 +263,21 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                     return false;
                 }
             }
-            //设置软键盘
+            // 设置软键盘模式
             getWindow().setSoftInputMode(
                     WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN
                             | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);
         } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {
-            // 新建笔记
+            // 插入或编辑笔记的意图
+            // 获取文件夹ID
             long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);
+            // 获取小部件ID
             int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID,
                     AppWidgetManager.INVALID_APPWIDGET_ID);
+            // 获取小部件类型
             int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE,
                     Notes.TYPE_WIDGET_INVALIDE);
+            // 获取背景资源ID
             int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID,
                     ResourceParser.getDefaultBgId(this));
 
@@ -232,6 +289,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                     Log.w(TAG, "The call record number is null");
                 }
                 long noteId = 0;
+                // 检查是否已有该通话记录的笔记
                 if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(),
                         phoneNumber, callDate)) > 0) {
                     mWorkingNote = WorkingNote.load(this, noteId);
@@ -241,15 +299,18 @@ public class NoteEditActivity extends Activity implements OnClickListener,
                         return false;
                     }
                 } else {
+                    // 创建新的通话记录笔记
                     mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId,
                             widgetType, bgResId);
                     mWorkingNote.convertToCallNote(phoneNumber, callDate);
                 }
             } else {
+                // 创建新的普通笔记
                 mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType,
                         bgResId);
             }
 
+            // 设置软键盘模式
             getWindow().setSoftInputMode(
                     WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE
                             | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE);
@@ -258,72 +319,110 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             finish();
             return false;
         }
+        // 设置笔记设置状态改变监听器
         mWorkingNote.setOnSettingStatusChangedListener(this);
         return true;
     }
 
+    /**
+     * 活动恢复时调用，初始化笔记界面。
+     */
     @Override
-    //Activity恢复时调用，初始化笔记界面
     protected void onResume() {
         super.onResume();
         initNoteScreen();
     }
-    //设置文本样式、背景等
+
+    /**
+     * 初始化笔记界面，设置文本样式、显示内容、背景颜色和提醒信息等。
+     */
     private void initNoteScreen() {
+        // 设置笔记编辑器的文本样式
         mNoteEditor.setTextAppearance(this, TextAppearanceResources
                 .getTexAppearanceResource(mFontSizeId));
+        // 如果是复选列表模式
         if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
+            // 切换到列表模式
             switchToListMode(mWorkingNote.getContent());
         } else {
+            // 设置笔记编辑器的文本并高亮显示查询结果
             mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
+            // 将光标移动到文本末尾
             mNoteEditor.setSelection(mNoteEditor.getText().length());
         }
+        // 隐藏所有背景选择的选中状态视图
         for (Integer id : sBgSelectorSelectionMap.keySet()) {
             findViewById(sBgSelectorSelectionMap.get(id)).setVisibility(View.GONE);
         }
+        // 设置头部视图面板的背景资源
         mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
+        // 设置笔记编辑器面板的背景资源
         mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());
 
+        // 设置笔记修改日期的显示
         mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this,
                 mWorkingNote.getModifiedDate(), DateUtils.FORMAT_SHOW_DATE
                         | DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME
                         | DateUtils.FORMAT_SHOW_YEAR));
 
         /**
-         * TODO: 添加设置提醒的菜单，目前因日期选择器未准备好而禁用
+         * TODO: Add the menu for setting alert. Currently disable it because the DateTimePicker
+         * is not ready
          */
+        // 显示提醒头部信息
         showAlertHeader();
     }
-    //显示提醒头部信息，根据是否有提醒的设置显示相应内容
+
+    /**
+     * 显示提醒头部信息，根据笔记的提醒状态显示提醒图标和日期。
+     */
     private void showAlertHeader() {
+        // 如果笔记有提醒设置
         if (mWorkingNote.hasClockAlert()) {
             long time = System.currentTimeMillis();
+            // 如果提醒时间已过
             if (time > mWorkingNote.getAlertDate()) {
                 mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);
             } else {
+                // 显示相对提醒时间
                 mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString(
                         mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS));
             }
+            // 显示提醒日期和图标
             mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE);
             mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);
         } else {
+            // 隐藏提醒日期和图标
             mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE);
             mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE);
         };
     }
 
+    /**
+     * 当活动接收到新的意图时调用，重新初始化活动状态。
+     *
+     * @param intent 新的意图
+     */
     @Override
-    //重新初始化活动状态
     protected void onNewIntent(Intent intent) {
         super.onNewIntent(intent);
         initActivityState(intent);
     }
 
+    /**
+     * 保存活动状态时调用，保存笔记ID到实例状态中。
+     *
+     * @param outState 要保存的实例状态
+     */
     @Override
-    //用于保存笔记id
     protected void onSaveInstanceState(Bundle outState) {
         super.onSaveInstanceState(outState);
-        //若未保存笔记，则先保存笔记id
+        // 如果笔记还未保存到数据库中，则先
+        /**
+         * For new note without note id, we should firstly save it to
+         * generate a id. If the editing note is not worth saving, there
+         * is no id which is equivalent to create new note
+         */
         if (!mWorkingNote.existInDatabase()) {
             saveNote();
         }
@@ -332,7 +431,6 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     @Override
-    //添加触摸事件，处理背景颜色和字体大小选项的显示和隐藏
     public boolean dispatchTouchEvent(MotionEvent ev) {
         if (mNoteBgColorSelector.getVisibility() == View.VISIBLE
                 && !inRangeOfView(mNoteBgColorSelector, ev)) {
@@ -373,7 +471,6 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         mNoteEditor = (EditText) findViewById(R.id.note_edit_view);
         mNoteEditorPanel = findViewById(R.id.sv_note_edit);
         mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector);
-        //为控件添加事件监听器，点击时触发当前类的onClick方法
         for (int id : sBgSelectorBtnsMap.keySet()) {
             ImageView iv = (ImageView) findViewById(id);
             iv.setOnClickListener(this);
@@ -387,9 +484,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this);
         mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE);
         /**
-         * HACKME: 修复在 SharedPreferences 中存储资源 id 可能出现的问题。
+         * HACKME: Fix bug of store the resource id in shared preference.
-         * * 存储的 id 可能会大于资源数组的长度，在这种情况下，
+         * The id may larger than the length of resources, in this case,
-         * * 返回 {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
+         * return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
          */
         if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) {
             mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE;
@@ -398,28 +495,21 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     }
 
     @Override
-    //当Activity暂停时调用此方法
     protected void onPause() {
-        //调用父类的onPause方法
         super.onPause();
-        //保存笔记
         if(saveNote()) {
-            //记录日志信息
             Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length());
         }
-        //清除设置状态
         clearSettingState();
     }
-    //更新部件的方法
+
     private void updateWidget() {
         Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
-        //判断部件的类型，并为intent的目标类设置一定的效果
         if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) {
             intent.setClass(this, NoteWidgetProvider_2x.class);
         } else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) {
             intent.setClass(this, NoteWidgetProvider_4x.class);
         } else {
-            //记录错误日志信息
             Log.e(TAG, "Unspported widget type");
             return;
         }

Notes-master/src/net/micode/notes/ui/NoteEditText.java

@@ -37,83 +37,134 @@ import net.micode.notes.R;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * NoteEditText 类继承自 EditText，用于自定义笔记编辑文本框的行为。
+ * 该类处理了按键事件、触摸事件、焦点变化事件和上下文菜单事件，
+ * 同时提供了与外部活动通信的接口，以便在特定事件发生时通知外部。
+ */
 public class NoteEditText extends EditText {
+    // 日志标签，用于调试输出
     private static final String TAG = "NoteEditText";
+    // 当前编辑文本框的索引，用于标识其在一组编辑文本框中的位置
     private int mIndex;
+    // 删除操作前的选择起始位置
     private int mSelectionStartBeforeDelete;
 
+    // 定义支持的 URL 协议
     private static final String SCHEME_TEL = "tel:" ;
     private static final String SCHEME_HTTP = "http:" ;
     private static final String SCHEME_EMAIL = "mailto:" ;
 
+    // 存储协议与对应菜单项资源 ID 的映射
     private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
     static {
+        // 初始化映射，将不同协议与对应的菜单项资源 ID 关联
         sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);
         sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web);
         sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email);
     }
 
     /**
-     * Call by the {@link NoteEditActivity} to delete or add edit text
+     * OnTextViewChangeListener 接口定义了在编辑文本框发生特定事件时的回调方法。
+     * 这些方法用于通知外部活动进行相应的处理，如删除、添加编辑文本框或隐藏/显示选项。
      */
     public interface OnTextViewChangeListener {
         /**
-         * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
+         * 当按下删除键（{@link KeyEvent#KEYCODE_DEL}）且文本为空时，删除当前编辑文本框。
-         * and the text is null
+         * @param index 当前编辑文本框的索引
+         * @param text 当前编辑文本框中的文本
          */
         void onEditTextDelete(int index, String text);
 
         /**
-         * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
+         * 当按下回车键（{@link KeyEvent#KEYCODE_ENTER}）时，在当前编辑文本框之后添加一个新的编辑文本框。
-         * happen
+         * @param index 新编辑文本框的索引
+         * @param text 从当前光标位置到文本末尾的文本
          */
         void onEditTextEnter(int index, String text);
 
         /**
-         * Hide or show item option when text change
+         * 当文本发生变化时，隐藏或显示选项。
+         * @param index 当前编辑文本框的索引
+         * @param hasText 文本是否为空
          */
         void onTextChange(int index, boolean hasText);
     }
 
+    // 外部活动实现的 OnTextViewChangeListener 接口实例
     private OnTextViewChangeListener mOnTextViewChangeListener;
 
+    /**
+     * 构造函数，使用默认属性创建 NoteEditText 实例。
+     * @param context 上下文对象
+     */
     public NoteEditText(Context context) {
         super(context, null);
+        // 初始化索引为 0
         mIndex = 0;
     }
 
+    /**
+     * 设置当前编辑文本框的索引。
+     * @param index 要设置的索引值
+     */
     public void setIndex(int index) {
         mIndex = index;
     }
 
+    /**
+     * 设置 OnTextViewChangeListener 接口实例，用于与外部活动通信。
+     * @param listener 实现了 OnTextViewChangeListener 接口的实例
+     */
     public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
         mOnTextViewChangeListener = listener;
     }
 
+    /**
+     * 构造函数，使用指定的属性集创建 NoteEditText 实例。
+     * @param context 上下文对象
+     * @param attrs 属性集
+     */
     public NoteEditText(Context context, AttributeSet attrs) {
         super(context, attrs, android.R.attr.editTextStyle);
     }
 
+    /**
+     * 构造函数，使用指定的属性集和默认样式创建 NoteEditText 实例。
+     * @param context 上下文对象
+     * @param attrs 属性集
+     * @param defStyle 默认样式
+     */
     public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
         super(context, attrs, defStyle);
         // TODO Auto-generated constructor stub
     }
 
+    /**
+     * 处理触摸事件，当触摸按下时，更新文本选择位置。
+     * @param event 触摸事件对象
+     * @return 处理结果，返回父类的处理结果
+     */
     @Override
     public boolean onTouchEvent(MotionEvent event) {
         switch (event.getAction()) {
             case MotionEvent.ACTION_DOWN:
-
+                // 获取触摸点的坐标
                 int x = (int) event.getX();
                 int y = (int) event.getY();
+                // 调整坐标，去除内边距并考虑滚动
                 x -= getTotalPaddingLeft();
                 y -= getTotalPaddingTop();
                 x += getScrollX();
                 y += getScrollY();
 
+                // 获取文本布局
                 Layout layout = getLayout();
+                // 根据垂直坐标获取所在行
                 int line = layout.getLineForVertical(y);
+                // 根据行和水平坐标获取字符偏移量
                 int off = layout.getOffsetForHorizontal(line, x);
+                // 设置文本选择位置
                 Selection.setSelection(getText(), off);
                 break;
         }
@@ -121,15 +172,23 @@ public class NoteEditText extends EditText {
         return super.onTouchEvent(event);
     }
 
+    /**
+     * 处理按键按下事件，记录删除操作前的选择起始位置。
+     * @param keyCode 按键代码
+     * @param event 按键事件对象
+     * @return 处理结果，返回父类的处理结果
+     */
     @Override
     public boolean onKeyDown(int keyCode, KeyEvent event) {
         switch (keyCode) {
             case KeyEvent.KEYCODE_ENTER:
+                // 如果设置了 OnTextViewChangeListener 接口实例，返回 false
                 if (mOnTextViewChangeListener != null) {
                     return false;
                 }
                 break;
             case KeyEvent.KEYCODE_DEL:
+                // 记录删除操作前的选择起始位置
                 mSelectionStartBeforeDelete = getSelectionStart();
                 break;
             default:
@@ -138,26 +197,41 @@ public class NoteEditText extends EditText {
         return super.onKeyDown(keyCode, event);
     }
 
+    /**
+     * 处理按键释放事件，根据按键代码调用相应的回调方法。
+     * @param keyCode 按键代码
+     * @param event 按键事件对象
+     * @return 处理结果，返回父类的处理结果
+     */
     @Override
     public boolean onKeyUp(int keyCode, KeyEvent event) {
         switch(keyCode) {
             case KeyEvent.KEYCODE_DEL:
+                // 如果设置了 OnTextViewChangeListener 接口实例
                 if (mOnTextViewChangeListener != null) {
+                    // 当选择起始位置为 0 且索引不为 0 时，调用删除回调方法
                     if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
                         mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
                         return true;
                     }
                 } else {
+                    // 未设置 OnTextViewChangeListener 接口实例，输出日志
                     Log.d(TAG, "OnTextViewChangeListener was not seted");
                 }
                 break;
             case KeyEvent.KEYCODE_ENTER:
+                // 如果设置了 OnTextViewChangeListener 接口实例
                 if (mOnTextViewChangeListener != null) {
+                    // 获取当前选择起始位置
                     int selectionStart = getSelectionStart();
+                    // 获取从当前光标位置到文本末尾的文本
                     String text = getText().subSequence(selectionStart, length()).toString();
+                    // 更新文本，保留当前光标之前的部分
                     setText(getText().subSequence(0, selectionStart));
+                    // 调用添加编辑文本框的回调方法
                     mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);
                 } else {
+                    // 未设置 OnTextViewChangeListener 接口实例，输出日志
                     Log.d(TAG, "OnTextViewChangeListener was not seted");
                 }
                 break;
@@ -167,45 +241,68 @@ public class NoteEditText extends EditText {
         return super.onKeyUp(keyCode, event);
     }
 
+    /**
+     * 处理焦点变化事件，根据焦点状态和文本内容调用文本变化回调方法。
+     * @param focused 是否获得焦点
+     * @param direction 焦点变化方向
+     * @param previouslyFocusedRect 之前聚焦的矩形区域
+     */
     @Override
     protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
+        // 如果设置了 OnTextViewChangeListener 接口实例
         if (mOnTextViewChangeListener != null) {
+            // 当失去焦点且文本为空时，调用文本变化回调方法，传递 false
             if (!focused && TextUtils.isEmpty(getText())) {
                 mOnTextViewChangeListener.onTextChange(mIndex, false);
             } else {
+                // 否则，调用文本变化回调方法，传递 true
                 mOnTextViewChangeListener.onTextChange(mIndex, true);
             }
         }
         super.onFocusChanged(focused, direction, previouslyFocusedRect);
     }
 
+    /**
+     * 创建上下文菜单，当选择的文本包含 URL 时，添加相应的菜单项。
+     * @param menu 上下文菜单对象
+     */
     @Override
     protected void onCreateContextMenu(ContextMenu menu) {
+        // 检查文本是否为 Spanned 类型
         if (getText() instanceof Spanned) {
+            // 获取选择的起始和结束位置
             int selStart = getSelectionStart();
             int selEnd = getSelectionEnd();
 
+            // 确定选择的最小和最大位置
             int min = Math.min(selStart, selEnd);
             int max = Math.max(selStart, selEnd);
 
+            // 获取选择范围内的 URLSpan 数组
             final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
+            // 如果只选择了一个 URL
             if (urls.length == 1) {
                 int defaultResId = 0;
+                // 遍历支持的协议
                 for(String schema: sSchemaActionResMap.keySet()) {
+                    // 检查 URL 是否包含当前协议
                     if(urls[0].getURL().indexOf(schema) >= 0) {
+                        // 获取对应的菜单项资源 ID
                         defaultResId = sSchemaActionResMap.get(schema);
                         break;
                     }
                 }
 
+                // 如果未找到匹配的协议，使用默认的菜单项资源 ID
                 if (defaultResId == 0) {
                     defaultResId = R.string.note_link_other;
                 }
 
+                // 添加菜单项，并设置点击监听器
                 menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
                         new OnMenuItemClickListener() {
                             public boolean onMenuItemClick(MenuItem item) {
-                                // goto a new intent
+                                // 调用 URLSpan 的点击方法，打开链接
                                 urls[0].onClick(NoteEditText.this);
                                 return true;
                             }

Notes-master/src/net/micode/notes/ui/NoteItemData.java

@@ -25,23 +25,28 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.tool.DataUtils;
 
-
+/**
+ * NoteItemData 类用于封装从数据库中查询到的笔记项数据。
+ * 它提供了从 Cursor 中提取数据的方法，并提供了访问这些数据的 getter 方法。
+ */
 public class NoteItemData {
+    // 定义从数据库查询笔记项数据时使用的投影列
     static final String [] PROJECTION = new String [] {
-        NoteColumns.ID,
+        NoteColumns.ID,             // 笔记的 ID
-        NoteColumns.ALERTED_DATE,
+        NoteColumns.ALERTED_DATE,   // 提醒日期
-        NoteColumns.BG_COLOR_ID,
+        NoteColumns.BG_COLOR_ID,    // 背景颜色 ID
-        NoteColumns.CREATED_DATE,
+        NoteColumns.CREATED_DATE,   // 创建日期
-        NoteColumns.HAS_ATTACHMENT,
+        NoteColumns.HAS_ATTACHMENT, // 是否有附件
-        NoteColumns.MODIFIED_DATE,
+        NoteColumns.MODIFIED_DATE,  // 修改日期
-        NoteColumns.NOTES_COUNT,
+        NoteColumns.NOTES_COUNT,    // 笔记数量
-        NoteColumns.PARENT_ID,
+        NoteColumns.PARENT_ID,      // 父文件夹 ID
-        NoteColumns.SNIPPET,
+        NoteColumns.SNIPPET,        // 笔记摘要
-        NoteColumns.TYPE,
+        NoteColumns.TYPE,           // 笔记类型
-        NoteColumns.WIDGET_ID,
+        NoteColumns.WIDGET_ID,      // 小部件 ID
-        NoteColumns.WIDGET_TYPE,
+        NoteColumns.WIDGET_TYPE,    // 小部件类型
     };
 
+    // 定义投影列在 Cursor 中的索引
     private static final int ID_COLUMN                    = 0;
     private static final int ALERTED_DATE_COLUMN          = 1;
     private static final int BG_COLOR_ID_COLUMN           = 2;
@@ -55,28 +60,37 @@ public class NoteItemData {
     private static final int WIDGET_ID_COLUMN             = 10;
     private static final int WIDGET_TYPE_COLUMN           = 11;
 
-    private long mId;
+    // 笔记项的各种属性
-    private long mAlertDate;
+    private long mId;               // 笔记的 ID
-    private int mBgColorId;
+    private long mAlertDate;        // 提醒日期
-    private long mCreatedDate;
+    private int mBgColorId;         // 背景颜色 ID
-    private boolean mHasAttachment;
+    private long mCreatedDate;      // 创建日期
-    private long mModifiedDate;
+    private boolean mHasAttachment; // 是否有附件
-    private int mNotesCount;
+    private long mModifiedDate;     // 修改日期
-    private long mParentId;
+    private int mNotesCount;        // 笔记数量
-    private String mSnippet;
+    private long mParentId;         // 父文件夹 ID
-    private int mType;
+    private String mSnippet;        // 笔记摘要
-    private int mWidgetId;
+    private int mType;              // 笔记类型
-    private int mWidgetType;
+    private int mWidgetId;          // 小部件 ID
-    private String mName;
+    private int mWidgetType;        // 小部件类型
-    private String mPhoneNumber;
+    private String mName;           // 联系人姓名
-
+    private String mPhoneNumber;    // 联系人电话号码
-    private boolean mIsLastItem;
+
-    private boolean mIsFirstItem;
+    // 笔记项在列表中的位置状态
-    private boolean mIsOnlyOneItem;
+    private boolean mIsLastItem;            // 是否是列表中的最后一项
-    private boolean mIsOneNoteFollowingFolder;
+    private boolean mIsFirstItem;           // 是否是列表中的第一项
-    private boolean mIsMultiNotesFollowingFolder;
+    private boolean mIsOnlyOneItem;         // 是否是列表中唯一的一项
-
+    private boolean mIsOneNoteFollowingFolder; // 是否是文件夹后面的唯一一条笔记
+    private boolean mIsMultiNotesFollowingFolder; // 是否是文件夹后面有多条笔记
+
+    /**
+     * 构造函数，从 Cursor 中提取笔记项数据。
+     *
+     * @param context 上下文对象
+     * @param cursor 包含笔记项数据的 Cursor
+     */
     public NoteItemData(Context context, Cursor cursor) {
+        // 从 Cursor 中提取数据并赋值给相应的成员变量
         mId = cursor.getLong(ID_COLUMN);
         mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
         mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
@@ -86,6 +100,7 @@ public class NoteItemData {
         mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
         mParentId = cursor.getLong(PARENT_ID_COLUMN);
         mSnippet = cursor.getString(SNIPPET_COLUMN);
+        // 移除笔记摘要中的特定标签
         mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
                 NoteEditActivity.TAG_UNCHECKED, "");
         mType = cursor.getInt(TYPE_COLUMN);
@@ -93,11 +108,15 @@ public class NoteItemData {
         mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
 
         mPhoneNumber = "";
+        // 如果父文件夹 ID 是通话记录文件夹的 ID
         if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
+            // 获取通话记录的电话号码
             mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
             if (!TextUtils.isEmpty(mPhoneNumber)) {
+                // 根据电话号码获取联系人姓名
                 mName = Contact.getContact(context, mPhoneNumber);
                 if (mName == null) {
+                    // 如果没有联系人姓名，则使用电话号码作为姓名
                     mName = mPhoneNumber;
                 }
             }
@@ -106,24 +125,37 @@ public class NoteItemData {
         if (mName == null) {
             mName = "";
         }
+        // 检查笔记项在列表中的位置状态
         checkPostion(cursor);
     }
 
+    /**
+     * 检查笔记项在列表中的位置状态。
+     *
+     * @param cursor 包含笔记项数据的 Cursor
+     */
     private void checkPostion(Cursor cursor) {
+        // 判断是否是列表中的最后一项
         mIsLastItem = cursor.isLast() ? true : false;
+        // 判断是否是列表中的第一项
         mIsFirstItem = cursor.isFirst() ? true : false;
+        // 判断是否是列表中唯一的一项
         mIsOnlyOneItem = (cursor.getCount() == 1);
         mIsMultiNotesFollowingFolder = false;
         mIsOneNoteFollowingFolder = false;
 
+        // 如果是笔记类型且不是第一项
         if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {
             int position = cursor.getPosition();
             if (cursor.moveToPrevious()) {
+                // 如果前一项是文件夹或系统类型
                 if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER
                         || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
                     if (cursor.getCount() > (position + 1)) {
+                        // 如果后面还有多项笔记，则标记为文件夹后面有多条笔记
                         mIsMultiNotesFollowingFolder = true;
                     } else {
+                        // 如果后面只有一项笔记，则标记为文件夹后面的唯一一条笔记
                         mIsOneNoteFollowingFolder = true;
                     }
                 }
@@ -134,90 +166,201 @@ public class NoteItemData {
         }
     }
 
+    /**
+     * 判断是否是文件夹后面的唯一一条笔记。
+     *
+     * @return 如果是则返回 true，否则返回 false
+     */
     public boolean isOneFollowingFolder() {
         return mIsOneNoteFollowingFolder;
     }
 
+    /**
+     * 判断是否是文件夹后面有多条笔记。
+     *
+     * @return 如果是则返回 true，否则返回 false
+     */
     public boolean isMultiFollowingFolder() {
         return mIsMultiNotesFollowingFolder;
     }
 
+    /**
+     * 判断是否是列表中的最后一项。
+     *
+     * @return 如果是则返回 true，否则返回 false
+     */
     public boolean isLast() {
         return mIsLastItem;
     }
 
+    /**
+     * 获取通话记录的联系人姓名。
+     *
+     * @return 联系人姓名
+     */
     public String getCallName() {
         return mName;
     }
 
+    /**
+     * 判断是否是列表中的第一项。
+     *
+     * @return 如果是则返回 true，否则返回 false
+     */
     public boolean isFirst() {
         return mIsFirstItem;
     }
 
+    /**
+     * 判断是否是列表中唯一的一项。
+     *
+     * @return 如果是则返回 true，否则返回 false
+     */
     public boolean isSingle() {
         return mIsOnlyOneItem;
     }
 
+    /**
+     * 获取笔记的 ID。
+     *
+     * @return 笔记的 ID
+     */
     public long getId() {
         return mId;
     }
 
+    /**
+     * 获取笔记的提醒日期。
+     *
+     * @return 提醒日期
+     */
     public long getAlertDate() {
         return mAlertDate;
     }
 
+    /**
+     * 获取笔记的创建日期。
+     *
+     * @return 创建日期
+     */
     public long getCreatedDate() {
         return mCreatedDate;
     }
 
+    /**
+     * 判断笔记是否有附件。
+     *
+     * @return 如果有附件则返回 true，否则返回 false
+     */
     public boolean hasAttachment() {
         return mHasAttachment;
     }
 
+    /**
+     * 获取笔记的修改日期。
+     *
+     * @return 修改日期
+     */
     public long getModifiedDate() {
         return mModifiedDate;
     }
 
+    /**
+     * 获取笔记的背景颜色 ID。
+     *
+     * @return 背景颜色 ID
+     */
     public int getBgColorId() {
         return mBgColorId;
     }
 
+    /**
+     * 获取笔记的父文件夹 ID。
+     *
+     * @return 父文件夹 ID
+     */
     public long getParentId() {
         return mParentId;
     }
 
+    /**
+     * 获取笔记的数量。
+     *
+     * @return 笔记数量
+     */
     public int getNotesCount() {
         return mNotesCount;
     }
 
+    /**
+     * 获取笔记所在的文件夹 ID。
+     *
+     * @return 文件夹 ID
+     */
     public long getFolderId () {
         return mParentId;
     }
 
+    /**
+     * 获取笔记的类型。
+     *
+     * @return 笔记类型
+     */
     public int getType() {
         return mType;
     }
 
+    /**
+     * 获取笔记关联的小部件类型。
+     *
+     * @return 小部件类型
+     */
     public int getWidgetType() {
         return mWidgetType;
     }
 
+    /**
+     * 获取笔记关联的小部件 ID。
+     *
+     * @return 小部件 ID
+     */
     public int getWidgetId() {
         return mWidgetId;
     }
 
+    /**
+     * 获取笔记的摘要。
+     *
+     * @return 笔记摘要
+     */
     public String getSnippet() {
         return mSnippet;
     }
 
+    /**
+     * 判断笔记是否有提醒。
+     *
+     * @return 如果有提醒则返回 true，否则返回 false
+     */
     public boolean hasAlert() {
         return (mAlertDate > 0);
     }
 
+    /**
+     * 判断笔记是否是通话记录。
+     *
+     * @return 如果是通话记录则返回 true，否则返回 false
+     */
     public boolean isCallRecord() {
         return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
     }
 
+    /**
+     * 从 Cursor 中获取笔记的类型。
+     *
+     * @param cursor 包含笔记项数据的 Cursor
+     * @return 笔记类型
+     */
     public static int getNoteType(Cursor cursor) {
         return cursor.getInt(TYPE_COLUMN);
     }

Notes-master/src/net/micode/notes/ui/NotesListActivity.java

@@ -79,7 +79,6 @@ import java.io.InputStreamReader;
 import java.util.HashSet;
 
 public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
-    private  int mode=-1;
     private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;
 
     private static final int FOLDER_LIST_QUERY_TOKEN      = 1;
@@ -140,10 +139,6 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.note_list);
-
-        getWindow().setBackgroundDrawableResource(R.drawable.bg1);
-        getWindow().setBackgroundDrawableResource(R.drawable.bg2);
-
         initResources();
 
         /**
@@ -780,27 +775,12 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         } else {
             Log.e(TAG, "Wrong state:" + mState);
         }
-        if (mode==-1){
-            menu.findItem(R.id.menu_bg1).setVisible(false);
-        }else if (mode==0){
-            menu.findItem(R.id.menu_bg2).setVisible(false);
-        }
         return true;
     }
 
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
         switch (item.getItemId()) {
-            case R.id.menu_bg1:{
-                mode=-1;
-                getWindow().setBackgroundDrawableResource(R.drawable.bg1);
-                break;
-            }
-            case R.id.menu_bg2:{
-                mode=0;
-                getWindow().setBackgroundDrawableResource(R.drawable.bg2);
-                break;
-            }
             case R.id.menu_new_folder: {
                 showCreateOrModifyFolderDialog(true);
                 break;

Notes-master/src/net/micode/notes/ui/NotesListAdapter.java

@@ -30,19 +30,35 @@ import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Iterator;
 
-
+/**
+ * 用于在列表中显示便签的适配器。
+ * 继承自 CursorAdapter，负责管理便签数据的显示和选择状态。
+ */
 public class NotesListAdapter extends CursorAdapter {
     private static final String TAG = "NotesListAdapter";
+    // 上下文对象，用于获取资源和执行操作
     private Context mContext;
+    // 存储每个便签位置的选择状态
     private HashMap<Integer, Boolean> mSelectedIndex;
+    // 便签的总数
     private int mNotesCount;
+    // 是否处于选择模式
     private boolean mChoiceMode;
 
+    /**
+     * 表示便签小部件的属性。
+     */
     public static class AppWidgetAttribute {
+        // 小部件的 ID
         public int widgetId;
+        // 小部件的类型
         public int widgetType;
     };
 
+    /**
+     * 构造函数，初始化适配器。
+     * @param context 上下文对象
+     */
     public NotesListAdapter(Context context) {
         super(context, null);
         mSelectedIndex = new HashMap<Integer, Boolean>();
@@ -50,38 +66,73 @@ public class NotesListAdapter extends CursorAdapter {
         mNotesCount = 0;
     }
 
+    /**
+     * 创建新的便签列表项视图。
+     * @param context 上下文对象
+     * @param cursor 包含便签数据的游标
+     * @param parent 父视图组
+     * @return 新的便签列表项视图
+     */
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
         return new NotesListItem(context);
     }
 
+    /**
+     * 将便签数据绑定到视图上。
+     * @param view 便签列表项视图
+     * @param context 上下文对象
+     * @param cursor 包含便签数据的游标
+     */
     @Override
     public void bindView(View view, Context context, Cursor cursor) {
         if (view instanceof NotesListItem) {
+            // 创建便签项数据对象
             NoteItemData itemData = new NoteItemData(context, cursor);
+            // 绑定数据到视图
             ((NotesListItem) view).bind(context, itemData, mChoiceMode,
                     isSelectedItem(cursor.getPosition()));
         }
     }
 
+    /**
+     * 设置指定位置的便签选择状态。
+     * @param position 便签的位置
+     * @param checked 是否选择
+     */
     public void setCheckedItem(final int position, final boolean checked) {
         mSelectedIndex.put(position, checked);
+        // 通知适配器数据已更改，刷新视图
         notifyDataSetChanged();
     }
 
+    /**
+     * 判断是否处于选择模式。
+     * @return 如果处于选择模式返回 true，否则返回 false
+     */
     public boolean isInChoiceMode() {
         return mChoiceMode;
     }
 
+    /**
+     * 设置选择模式。
+     * @param mode 是否开启选择模式
+     */
     public void setChoiceMode(boolean mode) {
+        // 清除所有选择状态
         mSelectedIndex.clear();
         mChoiceMode = mode;
     }
 
+    /**
+     * 全选或全不选便签。
+     * @param checked 是否全选
+     */
     public void selectAll(boolean checked) {
         Cursor cursor = getCursor();
         for (int i = 0; i < getCount(); i++) {
             if (cursor.moveToPosition(i)) {
+                // 只处理便签类型的项
                 if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
                     setCheckedItem(i, checked);
                 }
@@ -89,6 +140,10 @@ public class NotesListAdapter extends CursorAdapter {
         }
     }
 
+    /**
+     * 获取所有选中便签的 ID。
+     * @return 包含选中便签 ID 的集合
+     */
     public HashSet<Long> getSelectedItemIds() {
         HashSet<Long> itemSet = new HashSet<Long>();
         for (Integer position : mSelectedIndex.keySet()) {
@@ -105,6 +160,10 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
+    /**
+     * 获取所有选中便签的小部件属性。
+     * @return 包含选中便签小部件属性的集合
+     */
     public HashSet<AppWidgetAttribute> getSelectedWidget() {
         HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
         for (Integer position : mSelectedIndex.keySet()) {
@@ -128,6 +187,10 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
+    /**
+     * 获取选中便签的数量。
+     * @return 选中便签的数量
+     */
     public int getSelectedCount() {
         Collection<Boolean> values = mSelectedIndex.values();
         if (null == values) {
@@ -143,11 +206,20 @@ public class NotesListAdapter extends CursorAdapter {
         return count;
     }
 
+    /**
+     * 判断是否所有便签都被选中。
+     * @return 如果所有便签都被选中返回 true，否则返回 false
+     */
     public boolean isAllSelected() {
         int checkedCount = getSelectedCount();
         return (checkedCount != 0 && checkedCount == mNotesCount);
     }
 
+    /**
+     * 判断指定位置的便签是否被选中。
+     * @param position 便签的位置
+     * @return 如果被选中返回 true，否则返回 false
+     */
     public boolean isSelectedItem(final int position) {
         if (null == mSelectedIndex.get(position)) {
             return false;
@@ -155,23 +227,36 @@ public class NotesListAdapter extends CursorAdapter {
         return mSelectedIndex.get(position);
     }
 
+    /**
+     * 当内容发生变化时调用。
+     * 重新计算便签的总数。
+     */
     @Override
     protected void onContentChanged() {
         super.onContentChanged();
         calcNotesCount();
     }
 
+    /**
+     * 更改游标时调用。
+     * 重新计算便签的总数。
+     * @param cursor 新的游标
+     */
     @Override
     public void changeCursor(Cursor cursor) {
         super.changeCursor(cursor);
         calcNotesCount();
     }
 
+    /**
+     * 计算便签的总数。
+     */
     private void calcNotesCount() {
         mNotesCount = 0;
         for (int i = 0; i < getCount(); i++) {
             Cursor c = (Cursor) getItem(i);
             if (c != null) {
+                // 只统计便签类型的项
                 if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
                     mNotesCount++;
                 }

Notes-master/src/net/micode/notes/ui/NotesPreferenceActivity.java

@@ -47,44 +47,57 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.gtask.remote.GTaskSyncService;
 
-
+/**
+ * NotesPreferenceActivity 类用于管理便签应用的设置界面。
+ * 它允许用户选择同步账户、启动或取消同步，并显示上次同步时间。
+ */
 public class NotesPreferenceActivity extends PreferenceActivity {
+    // 偏好设置的名称
     public static final String PREFERENCE_NAME = "notes_preferences";
-
+    // 同步账户名称的偏好设置键
     public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";
-
+    // 上次同步时间的偏好设置键
     public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
-
+    // 设置背景颜色随机显示的偏好设置键
     public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";
-
+    // 同步账户的偏好设置类别键
     private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
-
+    // 权限过滤器键
     private static final String AUTHORITIES_FILTER_KEY = "authorities";
 
+    // 同步账户的偏好设置类别
     private PreferenceCategory mAccountCategory;
-
+    // 用于接收 GTask 同步服务广播的接收器
     private GTaskReceiver mReceiver;
-
+    // 原始的 Google 账户数组
     private Account[] mOriAccounts;
-
+    // 标记是否添加了新账户
     private boolean mHasAddedAccount;
 
     @Override
     protected void onCreate(Bundle icicle) {
         super.onCreate(icicle);
 
-        /* using the app icon for navigation */
+        // 设置 ActionBar 可返回
         getActionBar().setDisplayHomeAsUpEnabled(true);
 
+        // 加载偏好设置资源
         addPreferencesFromResource(R.xml.preferences);
+        // 找到同步账户的偏好设置类别
         mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
+        // 创建 GTask 广播接收器
         mReceiver = new GTaskReceiver();
+        // 创建意图过滤器，用于接收 GTask 同步服务的广播
         IntentFilter filter = new IntentFilter();
         filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
+        // 注册广播接收器
         registerReceiver(mReceiver, filter);
 
+        // 初始化原始账户数组
         mOriAccounts = null;
+        // 加载设置界面的头部视图
         View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
+        // 将头部视图添加到列表视图中
         getListView().addHeaderView(header, null, true);
     }
 
@@ -92,8 +105,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
     protected void onResume() {
         super.onResume();
 
-        // need to set sync account automatically if user has added a new
+        // 如果添加了新账户，自动设置同步账户
-        // account
         if (mHasAddedAccount) {
             Account[] accounts = getGoogleAccounts();
             if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
@@ -113,36 +125,48 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             }
         }
 
+        // 刷新界面
         refreshUI();
     }
 
     @Override
     protected void onDestroy() {
+        // 注销广播接收器
         if (mReceiver != null) {
             unregisterReceiver(mReceiver);
         }
         super.onDestroy();
     }
 
+    /**
+     * 加载同步账户的偏好设置项
+     */
     private void loadAccountPreference() {
+        // 清空账户偏好设置类别中的所有项
         mAccountCategory.removeAll();
 
+        // 创建一个新的偏好设置项
         Preference accountPref = new Preference(this);
+        // 获取默认的同步账户名称
         final String defaultAccount = getSyncAccountName(this);
+        // 设置偏好设置项的标题
         accountPref.setTitle(getString(R.string.preferences_account_title));
+        // 设置偏好设置项的摘要
         accountPref.setSummary(getString(R.string.preferences_account_summary));
+        // 设置偏好设置项的点击监听器
         accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
             public boolean onPreferenceClick(Preference preference) {
+                // 如果当前没有正在同步
                 if (!GTaskSyncService.isSyncing()) {
+                    // 如果默认账户为空，显示选择账户的对话框
                     if (TextUtils.isEmpty(defaultAccount)) {
-                        // the first time to set account
                         showSelectAccountAlertDialog();
                     } else {
-                        // if the account has already been set, we need to promp
+                        // 如果已经设置了账户，显示更改账户的确认对话框
-                        // user about the risk
                         showChangeAccountConfirmAlertDialog();
                     }
                 } else {
+                    // 如果正在同步，显示提示信息
                     Toast.makeText(NotesPreferenceActivity.this,
                             R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
                             .show();
@@ -151,18 +175,24 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             }
         });
 
+        // 将账户偏好设置项添加到账户偏好设置类别中
         mAccountCategory.addPreference(accountPref);
     }
 
+    /**
+     * 加载同步按钮和上次同步时间的显示
+     */
     private void loadSyncButton() {
+        // 找到同步按钮和上次同步时间的文本视图
         Button syncButton = (Button) findViewById(R.id.preference_sync_button);
         TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
 
-        // set button state
+        // 根据同步状态设置按钮的文本和点击监听器
         if (GTaskSyncService.isSyncing()) {
             syncButton.setText(getString(R.string.preferences_button_sync_cancel));
             syncButton.setOnClickListener(new View.OnClickListener() {
                 public void onClick(View v) {
+                    // 取消同步
                     GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
                 }
             });
@@ -170,13 +200,15 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             syncButton.setText(getString(R.string.preferences_button_sync_immediately));
             syncButton.setOnClickListener(new View.OnClickListener() {
                 public void onClick(View v) {
+                    // 立即开始同步
                     GTaskSyncService.startSync(NotesPreferenceActivity.this);
                 }
             });
         }
+        // 如果同步账户不为空，启用同步按钮
         syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
 
-        // set last sync time
+        // 根据同步状态设置上次同步时间的显示
         if (GTaskSyncService.isSyncing()) {
             lastSyncTimeView.setText(GTaskSyncService.getProgressString());
             lastSyncTimeView.setVisibility(View.VISIBLE);
@@ -193,30 +225,44 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         }
     }
 
+    /**
+     * 刷新界面，重新加载账户偏好设置和同步按钮
+     */
     private void refreshUI() {
         loadAccountPreference();
         loadSyncButton();
     }
 
+    /**
+     * 显示选择账户的对话框
+     */
     private void showSelectAccountAlertDialog() {
+        // 创建一个 AlertDialog 构建器
         AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
 
+        // 加载账户选择对话框的标题视图
         View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
         TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
         titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
         TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
         subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
 
+        // 设置对话框的自定义标题
         dialogBuilder.setCustomTitle(titleView);
         dialogBuilder.setPositiveButton(null, null);
 
+        // 获取所有的 Google 账户
         Account[] accounts = getGoogleAccounts();
+        // 获取默认的同步账户名称
         String defAccount = getSyncAccountName(this);
 
+        // 记录原始账户数组
         mOriAccounts = accounts;
+        // 标记未添加新账户
         mHasAddedAccount = false;
 
         if (accounts.length > 0) {
+            // 创建一个字符序列数组，用于显示账户名称
             CharSequence[] items = new CharSequence[accounts.length];
             final CharSequence[] itemMapping = items;
             int checkedItem = -1;
@@ -227,134 +273,201 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 }
                 items[index++] = account.name;
             }
+            // 设置单选列表项
             dialogBuilder.setSingleChoiceItems(items, checkedItem,
                     new DialogInterface.OnClickListener() {
                         public void onClick(DialogInterface dialog, int which) {
+                            // 设置选择的账户为同步账户
                             setSyncAccount(itemMapping[which].toString());
+                            // 关闭对话框
                             dialog.dismiss();
+                            // 刷新界面
                             refreshUI();
                         }
                     });
         }
 
+        // 加载添加账户的视图
         View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
         dialogBuilder.setView(addAccountView);
 
+        // 显示对话框
         final AlertDialog dialog = dialogBuilder.show();
         addAccountView.setOnClickListener(new View.OnClickListener() {
             public void onClick(View v) {
+                // 标记添加了新账户
                 mHasAddedAccount = true;
+                // 创建一个添加账户的意图
                 Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
                 intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
                     "gmail-ls"
                 });
+                // 启动添加账户的活动
                 startActivityForResult(intent, -1);
+                // 关闭对话框
                 dialog.dismiss();
             }
         });
     }
 
+    /**
+     * 显示更改账户的确认对话框
+     */
     private void showChangeAccountConfirmAlertDialog() {
+        // 创建一个 AlertDialog 构建器
         AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
 
+        // 加载账户更改对话框的标题视图
         View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
         TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
         titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
                 getSyncAccountName(this)));
         TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
         subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
+        // 设置对话框的自定义标题
         dialogBuilder.setCustomTitle(titleView);
 
+        // 创建一个菜单项数组
         CharSequence[] menuItemArray = new CharSequence[] {
                 getString(R.string.preferences_menu_change_account),
                 getString(R.string.preferences_menu_remove_account),
                 getString(R.string.preferences_menu_cancel)
         };
+        // 设置菜单项的点击监听器
         dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
             public void onClick(DialogInterface dialog, int which) {
                 if (which == 0) {
+                    // 显示选择账户的对话框
                     showSelectAccountAlertDialog();
                 } else if (which == 1) {
+                    // 移除同步账户
                     removeSyncAccount();
+                    // 刷新界面
                     refreshUI();
                 }
             }
         });
+        // 显示对话框
         dialogBuilder.show();
     }
 
+    /**
+     * 获取所有的 Google 账户
+     * @return 包含所有 Google 账户的数组
+     */
     private Account[] getGoogleAccounts() {
+        // 获取账户管理器
         AccountManager accountManager = AccountManager.get(this);
+        // 获取所有的 Google 账户
         return accountManager.getAccountsByType("com.google");
     }
 
+    /**
+     * 设置同步账户
+     * @param account 要设置的账户名称
+     */
     private void setSyncAccount(String account) {
+        // 如果当前同步账户与要设置的账户不同
         if (!getSyncAccountName(this).equals(account)) {
+            // 获取共享偏好设置
             SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
             SharedPreferences.Editor editor = settings.edit();
             if (account != null) {
+                // 保存同步账户名称
                 editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
             } else {
                 editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
             }
+            // 提交更改
             editor.commit();
 
-            // clean up last sync time
+            // 清空上次同步时间
             setLastSyncTime(this, 0);
 
-            // clean up local gtask related info
+            // 清空本地的 GTask 相关信息
             new Thread(new Runnable() {
                 public void run() {
                     ContentValues values = new ContentValues();
                     values.put(NoteColumns.GTASK_ID, "");
                     values.put(NoteColumns.SYNC_ID, 0);
+                    // 更新所有便签的 GTask 相关信息
                     getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
                 }
             }).start();
 
+            // 显示设置成功的提示信息
             Toast.makeText(NotesPreferenceActivity.this,
                     getString(R.string.preferences_toast_success_set_accout, account),
                     Toast.LENGTH_SHORT).show();
         }
     }
 
+    /**
+     * 移除同步账户
+     */
     private void removeSyncAccount() {
+        // 获取共享偏好设置
         SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
         SharedPreferences.Editor editor = settings.edit();
         if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
+            // 移除同步账户名称
             editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);
         }
         if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {
+            // 移除上次同步时间
             editor.remove(PREFERENCE_LAST_SYNC_TIME);
         }
+        // 提交更改
         editor.commit();
 
-        // clean up local gtask related info
+        // 清空本地的 GTask 相关信息
         new Thread(new Runnable() {
             public void run() {
                 ContentValues values = new ContentValues();
                 values.put(NoteColumns.GTASK_ID, "");
                 values.put(NoteColumns.SYNC_ID, 0);
+                // 更新所有便签的 GTask 相关信息
                 getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
             }
         }).start();
     }
 
+    /**
+     * 获取当前的同步账户名称
+     * @param context 上下文对象
+     * @return 当前的同步账户名称，如果没有设置则返回空字符串
+     */
     public static String getSyncAccountName(Context context) {
+        // 获取共享偏好设置
         SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
                 Context.MODE_PRIVATE);
+        // 获取同步账户名称
         return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
     }
 
+    /**
+     * 设置上次同步时间
+     * @param context 上下文对象
+     * @param time 上次同步的时间
+     */
     public static void setLastSyncTime(Context context, long time) {
+        // 获取共享偏好设置
         SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
                 Context.MODE_PRIVATE);
         SharedPreferences.Editor editor = settings.edit();
+        // 保存上次同步时间
         editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);
+        // 提交更改
         editor.commit();
     }
 
+    /**
+     * 获取上次同步时间
+     * @param context 上下文对象
+     * @return 上次同步的时间，如果没有同步过则返回 0
+     */
     public static long getLastSyncTime(Context context) {
+        // 获取共享偏好设置
         SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
                 Context.MODE_PRIVATE);
         return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);