代码注释

DropdownMenu.java

@@ -30,14 +30,18 @@ import net.micode.notes.R;
 public class DropdownMenu {
     private Button mButton;
     private PopupMenu mPopupMenu;
+    //声明一个下拉菜单
     private Menu mMenu;
 
     public DropdownMenu(Context context, Button button, int menuId) {
         mButton = button;
         mButton.setBackgroundResource(R.drawable.dropdown_icon);
+        //设置这个view的背景
         mPopupMenu = new PopupMenu(context, mButton);
         mMenu = mPopupMenu.getMenu();
         mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
+         //MenuInflater是用来实例化Menu目录下的Menu布局文件
+        //根据ID来确认menu的内容选项
         mButton.setOnClickListener(new OnClickListener() {
             public void onClick(View v) {
                 mPopupMenu.show();
@@ -48,14 +52,14 @@ public class DropdownMenu {
     public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
         if (mPopupMenu != null) {
             mPopupMenu.setOnMenuItemClickListener(listener);
-        }
+        }//设置菜单的监听
     }
 
     public MenuItem findItem(int id) {
         return mMenu.findItem(id);
-    }
+    }//对于菜单选项的初始化，根据索引搜索菜单需要的选项
 
     public void setTitle(CharSequence title) {
         mButton.setText(title);
-    }
+    }//布局文件，设置标题
 }

NotesListAdapter.java

@@ -30,56 +30,77 @@ import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Iterator;
 
-
+/*
+直译为便签表连接器，继承了CursorAdapter，它为cursor和ListView提供了连接的桥梁，
+所以NotesListAdapter实现的是鼠标和编辑便签链接的桥梁。
+*/
 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;
-
+    private int mNotesCount;//便签数
+    private boolean mChoiceMode;//选择模式标记
+/*
+桌面widget的属性，包括编号和类型
+*/
     public static class AppWidgetAttribute {
         public int widgetId;
         public int widgetType;
     };
-
+/*
+函数功能：初始化便签链接器（根据传进来的内容设置相关变量）
+*/
     public NotesListAdapter(Context context) {
-        super(context, null);
-        mSelectedIndex = new HashMap<Integer, Boolean>();
+        super(context, null);//父类对象置空
+        mSelectedIndex = new HashMap<Integer, Boolean>();//新建选项下标的hash表
         mContext = context;
         mNotesCount = 0;
     }
 
     @Override
+/*
+函数功能：新建一个视图来存储光标所指向的数据（使用兄弟类NotesListItem新建一个项目选项）
+*/
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
         return new NotesListItem(context);
     }
-
+/*
+函数功能：将已经存在的视图和鼠标指向的数据进行捆绑
+*/
     @Override
     public void bindView(View view, Context context, Cursor cursor) {
-        if (view instanceof NotesListItem) {
+        if (view instanceof NotesListItem) {//若view是NotesListItem的一个实例
             NoteItemData itemData = new NoteItemData(context, cursor);
             ((NotesListItem) view).bind(context, itemData, mChoiceMode,
                     isSelectedItem(cursor.getPosition()));
+//则新建一个项目选项并且用bind跟将view和鼠标、内容、便签数据捆绑在一起
         }
     }
-
+/*
+函数功能：设置勾选框
+*/
     public void setCheckedItem(final int position, final boolean checked) {
-        mSelectedIndex.put(position, checked);
-        notifyDataSetChanged();
+        mSelectedIndex.put(position, checked);//根据定位和是否勾选设置下标
+        notifyDataSetChanged();//在修改后刷新activity
     }
-
+/*
+函数功能：判断单选按钮是否勾选
+*/
     public boolean isInChoiceMode() {
         return mChoiceMode;
     }
-
+/*
+函数功能：设置单项选项框（重置下标并且根据参数mode设置选项）
+*/
     public void setChoiceMode(boolean mode) {
         mSelectedIndex.clear();
         mChoiceMode = mode;
     }
-
+/*
+函数功能：选择全部选项
+*/
     public void selectAll(boolean checked) {
-        Cursor cursor = getCursor();
+        Cursor cursor = getCursor();//获取光标位置
         for (int i = 0; i < getCount(); i++) {
             if (cursor.moveToPosition(i)) {
                 if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
@@ -87,30 +108,37 @@ public class NotesListAdapter extends CursorAdapter {
                 }
             }
         }
+//遍历所有光标可用的位置在判断为便签类型之后勾选单项框
     }
-
+/*
+建立选择项的下标列表
+*/
     public HashSet<Long> getSelectedItemIds() {
-        HashSet<Long> itemSet = new HashSet<Long>();
-        for (Integer position : mSelectedIndex.keySet()) {
-            if (mSelectedIndex.get(position) == true) {
+        HashSet<Long> itemSet = new HashSet<Long>();//建立hash表
+        for (Integer position : mSelectedIndex.keySet()) {//遍历所有的关键
+            if (mSelectedIndex.get(position) == true) {//若光标位置可用
                 Long id = getItemId(position);
                 if (id == Notes.ID_ROOT_FOLDER) {
-                    Log.d(TAG, "Wrong item id, should not happen");
+                    Log.d(TAG, "Wrong item id, should not happen");//原文件不需要添加
                 } else {
                     itemSet.add(id);
                 }
+//则将id下标加入选项集合中
             }
         }
 
         return itemSet;
     }
-
+/*
+函数功能：建立桌面widget的选项表
+*/
     public HashSet<AppWidgetAttribute> getSelectedWidget() {
         HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
         for (Integer position : mSelectedIndex.keySet()) {
             if (mSelectedIndex.get(position) == true) {
                 Cursor c = (Cursor) getItem(position);
-                if (c != null) {
+//以上4句和getSelectedItemIds一样
+                if (c != null) {//若光标位置可用就建立新的widget属性并编辑下表和类型，最后添加到选项集中
                     AppWidgetAttribute widget = new AppWidgetAttribute();
                     NoteItemData item = new NoteItemData(mContext, c);
                     widget.widgetId = item.getWidgetId();
@@ -127,27 +155,35 @@ public class NotesListAdapter extends CursorAdapter {
         }
         return itemSet;
     }
-
+/*
+函数功能：获取选项个数
+*/
     public int getSelectedCount() {
-        Collection<Boolean> values = mSelectedIndex.values();
+        Collection<Boolean> values = mSelectedIndex.values();//首先获取选项下标的值
         if (null == values) {
             return 0;
         }
-        Iterator<Boolean> iter = values.iterator();
+        Iterator<Boolean> iter = values.iterator();//初始化叠加器
         int count = 0;
         while (iter.hasNext()) {
             if (true == iter.next()) {
+//若value值为真，计数+1
                 count++;
             }
         }
         return count;
     }
-
+/*
+函数功能：判断是否全部选中
+*/
     public boolean isAllSelected() {
         int checkedCount = getSelectedCount();
         return (checkedCount != 0 && checkedCount == mNotesCount);
+//获取选项数看是否等于便签的个数
     }
-
+/*
+函数功能：判断是否为选项表（通过传递的下标来确定）
+*/
     public boolean isSelectedItem(final int position) {
         if (null == mSelectedIndex.get(position)) {
             return false;
@@ -156,29 +192,41 @@ public class NotesListAdapter extends CursorAdapter {
     }
 
     @Override
+/*
+函数功能：在activity内容发生局部变动的时候回调该函数计算便签的数量
+*/
     protected void onContentChanged() {
         super.onContentChanged();
+//执行基类函数
         calcNotesCount();
     }
 
     @Override
+/*
+函数功能：在activity光标发生局部变动的时候回调该函数计算便签的数量
+*/
     public void changeCursor(Cursor cursor) {
         super.changeCursor(cursor);
+//执行基类函数
         calcNotesCount();
     }
-
+/*
+函数功能：计算便签数量
+*/
     private void calcNotesCount() {
         mNotesCount = 0;
-        for (int i = 0; i < getCount(); i++) {
+        for (int i = 0; i < getCount(); i++) {//获取总数同时遍历
             Cursor c = (Cursor) getItem(i);
             if (c != null) {
                 if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
                     mNotesCount++;
+//若该位置不为空并且文本类型为便签就+1
                 }
             } else {
                 Log.e(TAG, "Invalid cursor");
                 return;
             }
+//否则报错
         }
     }
 }

NotesListItem.java

@@ -29,38 +29,45 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.tool.DataUtils;
 import net.micode.notes.tool.ResourceParser.NoteItemBgResources;
 
-
+//创建便签列表项目选项
 public class NotesListItem extends LinearLayout {
-    private ImageView mAlert;
-    private TextView mTitle;
-    private TextView mTime;
-    private TextView mCallName;
-    private NoteItemData mItemData;
-    private CheckBox mCheckBox;
+    private ImageView mAlert;//闹钟图片
+    private TextView mTitle;//标题
+    private TextView mTime;//时间
+    private TextView mCallName;//名称
+    private NoteItemData mItemData;//标签数据
+    private CheckBox mCheckBox;打勾框
 
+/*
+初始化基本信息
+*/
     public NotesListItem(Context context) {
-        super(context);
-        inflate(context, R.layout.note_item, this);
+        super(context);//调整调用父类构造函数的顺序
+        inflate(context, R.layout.note_item, this);//将一个xml中定义的布局控件找出来，这里的xml是R.layout
+//findViewById用于从contentView中查找指定ID的View，转换出来的形式根据需要而定
         mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
         mTitle = (TextView) findViewById(R.id.tv_title);
         mTime = (TextView) findViewById(R.id.tv_time);
         mCallName = (TextView) findViewById(R.id.tv_name);
         mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
     }
-
+//根据data的属性对各个控件的属性的控制，主要是可见性Visibility，内容setText，格式setTextAppearance
     public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
         if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
-            mCheckBox.setVisibility(View.VISIBLE);
-            mCheckBox.setChecked(checked);
+            mCheckBox.setVisibility(View.VISIBLE);//设置可见行为可见
+            mCheckBox.setChecked(checked);//格子打勾
         } else {
             mCheckBox.setVisibility(View.GONE);
         }
 
         mItemData = data;
+//设置控件属性，共三种情况，由data的id和父id是否与保存到文件夹的id一致来决定
         if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
             mCallName.setVisibility(View.GONE);
             mAlert.setVisibility(View.VISIBLE);
+//设置该textview的style
             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+//settext为设置内容
             mTitle.setText(context.getString(R.string.call_record_folder_name)
                     + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
             mAlert.setImageResource(R.drawable.call_record);
@@ -69,8 +76,9 @@ public class NotesListItem extends LinearLayout {
             mCallName.setText(data.getCallName());
             mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
             mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+//关于闹钟的设置
             if (data.hasAlert()) {
-                mAlert.setImageResource(R.drawable.clock);
+                mAlert.setImageResource(R.drawable.clock);//图片来源的设置
                 mAlert.setVisibility(View.VISIBLE);
             } else {
                 mAlert.setVisibility(View.GONE);
@@ -78,7 +86,7 @@ public class NotesListItem extends LinearLayout {
         } else {
             mCallName.setVisibility(View.GONE);
             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
-
+//设置title格式
             if (data.getType() == Notes.TYPE_FOLDER) {
                 mTitle.setText(data.getSnippet()
                         + context.getString(R.string.format_folder_files_count,
@@ -87,31 +95,35 @@ public class NotesListItem extends LinearLayout {
             } else {
                 mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
                 if (data.hasAlert()) {
-                    mAlert.setImageResource(R.drawable.clock);
+                    mAlert.setImageResource(R.drawable.clock);//设置图片来源
                     mAlert.setVisibility(View.VISIBLE);
                 } else {
                     mAlert.setVisibility(View.GONE);
                 }
             }
         }
+//设置内容，获取相关时间，从data里编辑的日期中获取
         mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
 
         setBackground(data);
     }
-
+//根据data的文件属性来设置背景
     private void setBackground(NoteItemData data) {
         int id = data.getBgColorId();
+//若是note型文件，则有4种情况，对于这4中不同情况的背景来源
         if (data.getType() == Notes.TYPE_NOTE) {
+//单个数据并且只有一个子文件夹
             if (data.isSingle() || data.isOneFollowingFolder()) {
                 setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
-            } else if (data.isLast()) {
+            } else if (data.isLast()) {//是最后一个数据
                 setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
-            } else if (data.isFirst() || data.isMultiFollowingFolder()) {
+            } else if (data.isFirst() || data.isMultiFollowingFolder()) {//是一个数据并由多个子文件夹
                 setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
             } else {
                 setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
             }
         } else {
+//若不是note直接调用文件夹的背景来源
             setBackgroundResource(NoteItemBgResources.getFolderBgRes());
         }
     }

NotesPreferenceActivity.java

@@ -15,7 +15,6 @@
  */
 
 package net.micode.notes.ui;
-
 import android.accounts.Account;
 import android.accounts.AccountManager;
 import android.app.ActionBar;
@@ -47,102 +46,124 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.gtask.remote.GTaskSyncService;
 
-
+/*
+此类功能为，在小米便签中实现对背景颜色和字体大小的数据储存，继承了
+PreferenceActivity主要功能为对系统信息和配置进行自动保存的Activity。
+*/
 public class NotesPreferenceActivity extends PreferenceActivity {
-    public static final String PREFERENCE_NAME = "notes_preferences";
+    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_SYNC_ACCOUNT_NAME = "pref_key_account_name";//同步账号
 
-    public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
+    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 PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";//同步密码
 
-    private static final String AUTHORITIES_FILTER_KEY = "authorities";
+    private static final String AUTHORITIES_FILTER_KEY = "authorities";//本地密码
 
-    private PreferenceCategory mAccountCategory;
+    private PreferenceCategory mAccountCategory;//账户分组
 
-    private GTaskReceiver mReceiver;
+    private GTaskReceiver mReceiver;//同步任务接收器
 
-    private Account[] mOriAccounts;
+    private Account[] mOriAccounts;//账户
 
-    private boolean mHasAddedAccount;
+    private boolean mHasAddedAccount;账户的hash标记
 
     @Override
+/*
+函数功能：创建一个activity，在函数里要完成所有的正常静态设置。
+参数：Bundle icicle存放了activity当前的状态。
+*/
     protected void onCreate(Bundle icicle) {
-        super.onCreate(icicle);
+        super.onCreate(icicle);//先执行父类的创建函数
 
         /* using the app icon for navigation */
-        getActionBar().setDisplayHomeAsUpEnabled(true);
+        getActionBar().setDisplayHomeAsUpEnabled(true);//给左上角图标的左边加上一个返回的图标
 
-        addPreferencesFromResource(R.xml.preferences);
-        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
+        addPreferencesFromResource(R.xml.preferences);//添加xml来源并显示xml
+        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);//根据同步账户关键码来初始化分组
         mReceiver = new GTaskReceiver();
         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);
+        mOriAccounts = null;//mOriAccounts赋值为null
+        View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);//获取listview，ListView用于列出所有选择
+        getListView().addHeaderView(header, null, true);//在listview组件上方添加其他组件
     }
 
     @Override
+
+/*
+函数功能：activity交互功能的实现，用于接受用户的输入
+*/
     protected void onResume() {
-        super.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) {
+        if (mHasAddedAccount) {//若用户新加了账户则自动设置同步账户
+            Account[] accounts = getGoogleAccounts();//获取google同步账户
+            if (mOriAccounts != null && accounts.length > mOriAccounts.length) {//若原账户不为空且当前账户有增加
                 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);
+                        setSyncAccount(accountNew.name);//若是没有找到旧的账户，那么同步账号中就只添加新账户
                         break;
                     }
                 }
             }
         }
 
-        refreshUI();
+        refreshUI();//刷新标签页面
     }
 
     @Override
+
+/*
+函数功能：销毁一个activity
+*/
     protected void onDestroy() {
-        if (mReceiver != null) {
-            unregisterReceiver(mReceiver);
+        if (mReceiver != null) {//如果mReceiver不为空
+            unregisterReceiver(mReceiver);//注销接收器
         }
-        super.onDestroy();
+        super.onDestroy();//执行父类的销毁动作
     }
-
+/*
+函数功能：重新设置账户信息
+*/
     private void loadAccountPreference() {
-        mAccountCategory.removeAll();
+        mAccountCategory.removeAll();//销毁所有的分组
 
-        Preference accountPref = new Preference(this);
+        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) {
+            public boolean onPreferenceClick(Preference preference) {//建立监听器
                 if (!GTaskSyncService.isSyncing()) {
-                    if (TextUtils.isEmpty(defaultAccount)) {
+                    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中显示不能修改
                     Toast.makeText(NotesPreferenceActivity.this,
                             R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
                             .show();
@@ -150,23 +171,27 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 return true;
             }
         });
-
+	//根据新建首选项编辑新的账户分组
         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()) {
+//设置按钮的状态
+        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 {
+//设置按钮显示的文本为“取消同步”以及监听器
+        } else {//若是不同步则设置按钮显示的文本为“立即同步”以及对应监听器
             syncButton.setText(getString(R.string.preferences_button_sync_immediately));
             syncButton.setOnClickListener(new View.OnClickListener() {
                 public void onClick(View v) {
@@ -174,49 +199,57 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 }
             });
         }
-        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
+        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));//设置按键可用还是不可用
 
         // set last sync time
-        if (GTaskSyncService.isSyncing()) {
+//设置最终同步时间
+        if (GTaskSyncService.isSyncing()) {//若是再同步情况下
             lastSyncTimeView.setText(GTaskSyncService.getProgressString());
             lastSyncTimeView.setVisibility(View.VISIBLE);
-        } else {
+//根据当前同步服务器设置时间显示框的文本以及可见性
+        } 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 {
+//则根据最后同步数据的信息来编辑时间显示框的文本内容和可见性
+            } else {//若时间为空直接设置为不可见状态
                 lastSyncTimeView.setVisibility(View.GONE);
             }
         }
     }
 
+/*
+函数功能：刷新标签界面（调用上文设置账号和设置按键两个函数来实现）
+*/
     private void refreshUI() {
         loadAccountPreference();
         loadSyncButton();
     }
-
+/*
+函数功能：显示账户选择的对话框并进行账户的设置
+*/
     private void showSelectAccountAlertDialog() {
-        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+        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);
-
+//设置对话框的自定义标题，建立一个YES的按钮
         Account[] accounts = getGoogleAccounts();
         String defAccount = getSyncAccountName(this);
-
+//获取同步账户信息
         mOriAccounts = accounts;
         mHasAddedAccount = false;
 
-        if (accounts.length > 0) {
+        if (accounts.length > 0) {//若账户不为空
             CharSequence[] items = new CharSequence[accounts.length];
             final CharSequence[] itemMapping = items;
             int checkedItem = -1;
@@ -224,38 +257,45 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             for (Account account : accounts) {
                 if (TextUtils.equals(account.name, defAccount)) {
                     checkedItem = index;
+//在账户列表中查询到所需账户
                 }
                 items[index++] = account.name;
             }
-            dialogBuilder.setSingleChoiceItems(items, checkedItem,
+            dialogBuilder.setSingleChoiceItems(items, checkedItem,//在对话框建立一个单选的复选框
                     new DialogInterface.OnClickListener() {
                         public void onClick(DialogInterface dialog, int which) {
                             setSyncAccount(itemMapping[which].toString());
-                            dialog.dismiss();
+                            dialog.dismiss();//取消对话框
                             refreshUI();
                         }
+//设置点击后执行的事件，包括检录新同步账户和刷新标签界面
                     });
+//建立对话框网络版的监听器
         }
 
         View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
         dialogBuilder.setView(addAccountView);
-
-        final AlertDialog dialog = dialogBuilder.show();
+//给新加账户对话框设置自定义样式
+        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");
+                mHasAddedAccount = true;//将新加账户的hash置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.Builder dialogBuilder = new AlertDialog.Builder(this);
+        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);
@@ -263,44 +303,53 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 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);
+//根据同步修改的账户信息设置标题以及子标题的内容
+        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) {
+        };//定义一些标记字符串
+        dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {//设置对话框要显示的一个list,用于显示几个命令时，即change，remove，cancel
+            public void onClick(DialogInterface dialog, int which) {//按键功能由which来决定
                 if (which == 0) {
+//进入账户选择对话框
                     showSelectAccountAlertDialog();
                 } else if (which == 1) {
+//删除账户且更新便签界面
                     removeSyncAccount();
                     refreshUI();
                 }
             }
         });
-        dialogBuilder.show();
+        dialogBuilder.show();//显示对话框
     }
-
+/*
+函数功能：获取谷歌账户（通过账户管理器直接获取）
+*/
     private Account[] getGoogleAccounts() {
         AccountManager accountManager = AccountManager.get(this);
         return accountManager.getAccountsByType("com.google");
     }
-
+/*
+函数功能：设置同步账户
+*/
     private void setSyncAccount(String account) {
-        if (!getSyncAccountName(this).equals(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();
+//将该帐号加入到首选项中
+            editor.commit();//提交修改的数据
 
             // clean up last sync time
-            setLastSyncTime(this, 0);
+            setLastSyncTime(this, 0);//将最后同步时间请零
 
             // clean up local gtask related info
             new Thread(new Runnable() {
@@ -311,23 +360,27 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                     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();
+//将toast的文本信息置为“设置账户成功”并显示出来
         }
     }
-
+/*
+函数功能：删除同步账户
+*/
     private void removeSyncAccount() {
         SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
         SharedPreferences.Editor editor = settings.edit();
-        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
+//设置共享首选项
+        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.remove(PREFERENCE_LAST_SYNC_TIME);//删除当前首选项中有账户时间
         }
-        editor.commit();
+        editor.commit();//提交更新后的数据
 
         // clean up local gtask related info
         new Thread(new Runnable() {
@@ -338,49 +391,66 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
             }
         }).start();
+//重置当地同步任务的信息
     }
-
+/*
+函数功能：获取同步账户名称（通过共享的首选项里的信息直接获取）
+*/
     public static String getSyncAccountName(Context context) {
         SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
                 Context.MODE_PRIVATE);
         return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
     }
-
+/*
+函数功能：设置最终同步时间
+*/
     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();
+//编辑最终同步时间并提交更新
     }
-
+/*
+函数功能：获取最终同步时间（通过共享的首选项里的信息直接获取）
+*/
     public static long getLastSyncTime(Context context) {
         SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
                 Context.MODE_PRIVATE);
         return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
     }
-
+/*
+函数功能：接受同步信息（继承BroadcastReceiver）
+*/
     private class GTaskReceiver extends BroadcastReceiver {
 
         @Override
         public void onReceive(Context context, Intent intent) {
             refreshUI();
             if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
+//获取随广播而来的Internet中的同步服务的数据
                 TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
                 syncStatus.setText(intent
                         .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
+//通过获取的数据设置系统的状态
             }
 
         }
     }
-
+/*
+函数功能：处理菜单的选项
+参数：MenuItem菜单选项
+*/
     public boolean onOptionsItemSelected(MenuItem item) {
-        switch (item.getItemId()) {
+        switch (item.getItemId()) {//根据选项的id选择，这里只有一个主页
             case android.R.id.home:
                 Intent intent = new Intent(this, NotesListActivity.class);
                 intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
                 startActivity(intent);
                 return true;
+//在主页情况下创建连接组件intent，发出清空的信号并开始一个相应的activity
             default:
                 return false;
         }