温雍敬<代码注释>

src/main/java/net/micode/notes/ui/NotesListAdapter.java

@@ -31,56 +31,56 @@ import java.util.HashSet;
 import java.util.Iterator;
 
 
-public class NotesListAdapter extends CursorAdapter {
+public class NotesListAdapter extends CursorAdapter {//继承了CursorAdapter
     private static final String TAG = "NotesListAdapter";
     private Context mContext;
-    private HashMap<Integer, Boolean> mSelectedIndex;
+    private HashMap<Integer, Boolean> mSelectedIndex;//HashMap是一个散列表，储存键值对的映射关系
     private int mNotesCount;
-    private boolean mChoiceMode;
+    private boolean mChoiceMode;//选择模式标志
 
-    public static class AppWidgetAttribute {
+    public static class AppWidgetAttribute {//桌面widget的属性，包括编号和类型
         public int widgetId;
         public int widgetType;
-    };
+    };//父类对象置空
 
-    public NotesListAdapter(Context context) {
+    public NotesListAdapter(Context context) {//初始化便签链接
         super(context, null);
         mSelectedIndex = new HashMap<Integer, Boolean>();
-        mContext = context;
+        mContext = context;//新建一个视图来存储光标所指向的数据
         mNotesCount = 0;
     }
 
     @Override
-    public View newView(Context context, Cursor cursor, ViewGroup parent) {
+    public View newView(Context context, Cursor cursor, ViewGroup parent) {//利用NotesListLtem类创建新布局
         return new NotesListItem(context);
     }
 
     @Override
-    public void bindView(View view, Context context, Cursor cursor) {
+    public void bindView(View view, Context context, Cursor cursor) {//将已经存在的视图和鼠标指向的数据进行捆绑
         if (view instanceof NotesListItem) {
-            NoteItemData itemData = new NoteItemData(context, cursor);
+            NoteItemData itemData = new NoteItemData(context, cursor);//新建一个项目选项并且用bind跟将view和鼠标，内容，便签数据捆绑在一起
             ((NotesListItem) view).bind(context, itemData, mChoiceMode,
                     isSelectedItem(cursor.getPosition()));
         }
     }
 
-    public void setCheckedItem(final int position, final boolean checked) {
-        mSelectedIndex.put(position, checked);
+    public void setCheckedItem(final int position, final boolean checked) {//设置勾选框
+        mSelectedIndex.put(position, checked);//根据定位和是否勾选设置下标
         notifyDataSetChanged();
     }
 
     public boolean isInChoiceMode() {
         return mChoiceMode;
-    }
+    }//判断单选按钮是否勾选
 
-    public void setChoiceMode(boolean mode) {
+    public void setChoiceMode(boolean mode) {//重置下标，并根据参数mode设置选项
         mSelectedIndex.clear();
         mChoiceMode = mode;
     }
 
-    public void selectAll(boolean checked) {
+    public void selectAll(boolean checked) {//选择全部选项，遍历所有光标可用的位置在判断为便签类型之后勾选单项框
         Cursor cursor = getCursor();
-        for (int i = 0; i < getCount(); i++) {
+        for (int i = 0; i < getCount(); i++) {//历可用光标位置，如果光标移动且光标当前指向的便签项目类型为TYPE_NOTE则设置为勾选状态
             if (cursor.moveToPosition(i)) {
                 if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
                     setCheckedItem(i, checked);
@@ -89,15 +89,15 @@ public class NotesListAdapter extends CursorAdapter {
         }
     }
 
-    public HashSet<Long> getSelectedItemIds() {
+    public HashSet<Long> getSelectedItemIds() {//建立选择项目的ID的HASH表
         HashSet<Long> itemSet = new HashSet<Long>();
-        for (Integer position : mSelectedIndex.keySet()) {
+        for (Integer position : mSelectedIndex.keySet()) {//遍历所有的关键
             if (mSelectedIndex.get(position) == true) {
                 Long id = getItemId(position);
-                if (id == Notes.ID_ROOT_FOLDER) {
+                if (id == Notes.ID_ROOT_FOLDER) {//原文件不需要添加，则将id该下标假如选项集合中
                     Log.d(TAG, "Wrong item id, should not happen");
                 } else {
-                    itemSet.add(id);
+                    itemSet.add(id);//将该id加入到选项集合当中
                 }
             }
         }
@@ -105,22 +105,22 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
-    public HashSet<AppWidgetAttribute> getSelectedWidget() {
+    public HashSet<AppWidgetAttribute> getSelectedWidget() {//建立桌面widget选项表
         HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
-        for (Integer position : mSelectedIndex.keySet()) {
+        for (Integer position : mSelectedIndex.keySet()) {//遍历被选中的列表
             if (mSelectedIndex.get(position) == true) {
-                Cursor c = (Cursor) getItem(position);
+                Cursor c = (Cursor) getItem(position);//获取条目
                 if (c != null) {
                     AppWidgetAttribute widget = new AppWidgetAttribute();
-                    NoteItemData item = new NoteItemData(mContext, c);
+                    NoteItemData item = new NoteItemData(mContext, c);//新建widget并更新ID和类型，最后添加到选项表中
                     widget.widgetId = item.getWidgetId();
                     widget.widgetType = item.getWidgetType();
-                    itemSet.add(widget);
+                    itemSet.add(widget);//加入条目集合
                     /**
                      * Don't close cursor here, only the adapter could close it
                      */
                 } else {
-                    Log.e(TAG, "Invalid cursor");
+                    Log.e(TAG, "Invalid cursor");//设置标签，无效的cursor
                     return null;
                 }
             }
@@ -128,14 +128,14 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
-    public int getSelectedCount() {
+    public int getSelectedCount() {//获取选项个数
         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()) {
+        while (iter.hasNext()) {//如果iter后面还有，则count加一
             if (true == iter.next()) {
                 count++;
             }
@@ -143,40 +143,40 @@ public class NotesListAdapter extends CursorAdapter {
         return count;
     }
 
-    public boolean isAllSelected() {
+    public boolean isAllSelected() {//判断是否全选
         int checkedCount = getSelectedCount();
         return (checkedCount != 0 && checkedCount == mNotesCount);
     }
 
-    public boolean isSelectedItem(final int position) {
+    public boolean isSelectedItem(final int position) {//判断是否为选项表
         if (null == mSelectedIndex.get(position)) {
             return false;
         }
-        return mSelectedIndex.get(position);
+        return mSelectedIndex.get(position);//判断Item是否被选中的状态
     }
 
     @Override
-    protected void onContentChanged() {
-        super.onContentChanged();
+    protected void onContentChanged() {//activity内容变动时调用calcNotesCount计算便签数量
+        super.onContentChanged();//执行父类函数
         calcNotesCount();
     }
 
     @Override
     public void changeCursor(Cursor cursor) {
-        super.changeCursor(cursor);
+        super.changeCursor(cursor);//重载父类函数
         calcNotesCount();
     }
 
-    private void calcNotesCount() {
+    private void calcNotesCount() {//实现方式类似前面代码中的selectAll函数
         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) {
+            if (c != null) {//判断语句，如果光标不是null，那么便得到信息，便签数目加1
+                if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {//若选项的数据类型为便签类型，那么计数+1
                     mNotesCount++;
                 }
             } else {
-                Log.e(TAG, "Invalid cursor");
+                Log.e(TAG, "Invalid cursor");//否则就将设置为无效的光标
                 return;
             }
         }

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

@@ -30,80 +30,82 @@ 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;
+public class NotesListItem extends LinearLayout {// 构建便签列表的各个项目的详细具体信息
+    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);
-        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);
+    public NotesListItem(Context context) {// 初始化基本信息
+        super(context);//调用父类具有相同形参的函数
+        inflate(context, R.layout.note_item, this);//inflate()作用就是将xml定义的一个布局找出来
+        mAlert = (ImageView) findViewById(R.id.iv_alert_icon);//findViewById用于从contentView中查找指定ID的View，转换出来的形式根据需要而定
+        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);//获取复选框
     }
 
-    public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
-        if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
+    public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {//根据data的属性对各个控件的属性的控制，
+        // 主要是可见性Visibility，内容setText，格式setTextAppearance
+        if (choiceMode && data.getType() == Notes.TYPE_NOTE) {//如果处于选择模式并且是便签类型时，设置为可见及勾选，否则设置为不可见。
             mCheckBox.setVisibility(View.VISIBLE);
-            mCheckBox.setChecked(checked);
+            mCheckBox.setChecked(checked);//设置勾选
         } else {
-            mCheckBox.setVisibility(View.GONE);
+            mCheckBox.setVisibility(View.GONE);//否则设置复选框不可见
         }
 
-        mItemData = data;
-        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
-            mCallName.setVisibility(View.GONE);
-            mAlert.setVisibility(View.VISIBLE);
-            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+        mItemData = data;//把数据传给标签
+        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//设置控件属性，通过判断保存到文件夹的ID、当前ID以及父ID之间关系决定
+            mCallName.setVisibility(View.GONE);//设置setText 的style
+            mAlert.setVisibility(View.VISIBLE);//设置提醒闹钟可见
+            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);//设置外观风格
             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);
-        } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
+                    + context.getString(R.string.format_folder_files_count, data.getNotesCount()));//设置标题内容
+            mAlert.setImageResource(R.drawable.call_record);//设置图片来源
+        } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {//闹钟设置
             mCallName.setVisibility(View.VISIBLE);
-            mCallName.setText(data.getCallName());
-            mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
+            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.setVisibility(View.VISIBLE);
+            if (data.hasAlert()) {//如果当前便签存在提醒时间
+                mAlert.setImageResource(R.drawable.clock);//设置图片来源
+                mAlert.setVisibility(View.VISIBLE);//
             } else {
                 mAlert.setVisibility(View.GONE);
-            }
+            }//否则设置提醒图标不可见
         } else {
-            mCallName.setVisibility(View.GONE);
+            mCallName.setVisibility(View.GONE);//如果父类和当前id均与保存在文件夹中的id不同，设置联系人姓名不可见
             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
 
-            if (data.getType() == Notes.TYPE_FOLDER) {
-                mTitle.setText(data.getSnippet()
+            if (data.getType() == Notes.TYPE_FOLDER) {//设置标题格式
+                mTitle.setText(data.getSnippet()//设置便签标题内容为便签的前面部分的内容+文件数+便签数
                         + context.getString(R.string.format_folder_files_count,
                                 data.getNotesCount()));
                 mAlert.setVisibility(View.GONE);
             } else {
                 mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
-                if (data.hasAlert()) {
+                //若没有设置标题，将标题设置为内容前面部分
+                if (data.hasAlert()) {//若存在提醒时间
                     mAlert.setImageResource(R.drawable.clock);
                     mAlert.setVisibility(View.VISIBLE);
                 } else {
-                    mAlert.setVisibility(View.GONE);
+                    mAlert.setVisibility(View.GONE);//否则设置威不可见
                 }
             }
         }
         mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
 
-        setBackground(data);
+        setBackground(data);//设置背景
     }
 
-    private void setBackground(NoteItemData data) {
-        int id = data.getBgColorId();
-        if (data.getType() == Notes.TYPE_NOTE) {
-            if (data.isSingle() || data.isOneFollowingFolder()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
+    private void setBackground(NoteItemData data) {//根据data的文件属性来设置背景
+        int id = data.getBgColorId();//获取id，用此id用来获取背景颜色
+        if (data.getType() == Notes.TYPE_NOTE) {//若是note型文件，则4种情况，对于4种不同情况的背景来源
+            if (data.isSingle() || data.isOneFollowingFolder()) {//单个数据或只有一个文件夹
+                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));//设置背景颜色为单个便签背景
             } else if (data.isLast()) {
                 setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
             } else if (data.isFirst() || data.isMultiFollowingFolder()) {
@@ -118,5 +120,5 @@ public class NotesListItem extends LinearLayout {
 
     public NoteItemData getItemData() {
         return mItemData;
-    }
+    }//返回当前便签的文件信息
 }

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

@@ -49,60 +49,64 @@ import net.micode.notes.gtask.remote.GTaskSyncService;
 
 
 public class NotesPreferenceActivity extends PreferenceActivity {
+    //NotesPreferenceActivity，在小米便签中主要实现的是对背景颜色和字体大小的数据储存。
+    // 继承了PreferenceActivity主要功能为对系统信息和配置进行自动保存的Activity
     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;
-
+    //设置账户分组
     private GTaskReceiver mReceiver;
-
+    //同步任务接收器
     private Account[] mOriAccounts;
-
+    //账户
     private boolean mHasAddedAccount;
-
+    // 账户的has标记
     @Override
-    protected void onCreate(Bundle icicle) {
-        super.onCreate(icicle);
+    protected void onCreate(Bundle icicle) {//创建一个activity，在函数里要完成所有的正常静态设置
+        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);
-        mReceiver = new GTaskReceiver();
-        IntentFilter filter = new IntentFilter();
+        //根据同步账户密码进行账户分组
+        mReceiver = new GTaskReceiver();//设置同步任务接收器
+        IntentFilter filter = new IntentFilter();//设置过滤项
         filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
         registerReceiver(mReceiver, filter);
-
+        //注册监听器，和对应的filter绑定
         mOriAccounts = null;
         View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
         getListView().addHeaderView(header, null, true);
+        //从xml获取Listview，获取listvivew，ListView的作用:用于列出所有选择
     }
 
     @Override
-    protected void onResume() {
-        super.onResume();
+    protected void onResume() {//activity交互功能的实现，用于接受用户的输入
+        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) {
-                for (Account accountNew : accounts) {
-                    boolean found = false;
-                    for (Account accountOld : mOriAccounts) {
+        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;
+                            break;//.若是没有找到旧的账户，那么同步账号中就只添加新账户
                         }
                     }
                     if (!found) {
@@ -117,70 +121,72 @@ public class NotesPreferenceActivity extends PreferenceActivity {
     }
 
     @Override
-    protected void onDestroy() {
+    protected void onDestroy() {//销毁Activity
         if (mReceiver != null) {
-            unregisterReceiver(mReceiver);
+            unregisterReceiver(mReceiver);//执行销毁操作
         }
         super.onDestroy();
     }
 
-    private void loadAccountPreference() {
-        mAccountCategory.removeAll();
+    private void loadAccountPreference() {//设置账户信息
+        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) {
-                if (!GTaskSyncService.isSyncing()) {
+        accountPref.setTitle(getString(R.string.preferences_account_title));//首选项的大小标题
+        accountPref.setSummary(getString(R.string.preferences_account_summary));//与google task同步便签记录
+        accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {//设置preference的的监听器
+            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();
+                        showChangeAccountConfirmAlertDialog();//已有账户则显示确认对话框
                     }
-                } else {
+                } else {//若处于同步状态的情况下
                     Toast.makeText(NotesPreferenceActivity.this,
                             R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
                             .show();
-                }
+                }//不能切换处于同步的账号
                 return true;
             }
         });
 
-        mAccountCategory.addPreference(accountPref);
+        mAccountCategory.addPreference(accountPref);//根据新建首选项编辑新的账户分组
     }
 
-    private void loadSyncButton() {
+    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() {
+        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 {
-            syncButton.setText(getString(R.string.preferences_button_sync_immediately));
+            syncButton.setText(getString(R.string.preferences_button_sync_immediately));//非同步状态下按键显示“立即同步”，设置相关监听器
             syncButton.setOnClickListener(new View.OnClickListener() {
-                public void onClick(View v) {
+                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);
-        } else {
+            lastSyncTimeView.setVisibility(View.VISIBLE);//根据当前同步服务器设置时间显示框的文本以及可见性
+        } else {//设置显示内容
             long lastSyncTime = getLastSyncTime(this);
             if (lastSyncTime != 0) {
                 lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
@@ -189,74 +195,75 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 lastSyncTimeView.setVisibility(View.VISIBLE);
             } else {
                 lastSyncTimeView.setVisibility(View.GONE);
-            }
+            }//最近同步时间为空设置同步时间不可见
         }
     }
 
     private void refreshUI() {
         loadAccountPreference();
         loadSyncButton();
-    }
+    }//刷新标签界面
 
-    private void showSelectAccountAlertDialog() {
+    private void showSelectAccountAlertDialog() {//显示账户选择的对话框并进行账户的设置
         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);
+        dialogBuilder.setCustomTitle(titleView);//设置标题及子标题内容
+        dialogBuilder.setPositiveButton(null, null);//取消设置键按钮
 
-        Account[] accounts = getGoogleAccounts();
-        String defAccount = getSyncAccountName(this);
+        Account[] accounts = getGoogleAccounts();//获得谷歌当前账户列表
+        String defAccount = getSyncAccountName(this);//默认账户
 
         mOriAccounts = accounts;
-        mHasAddedAccount = false;
+        mHasAddedAccount = false;//获得账户同步信息
 
-        if (accounts.length > 0) {
+        if (accounts.length > 0) {//如果有账户，则显示所有账户名称
             CharSequence[] items = new CharSequence[accounts.length];
             final CharSequence[] itemMapping = items;
             int checkedItem = -1;
             int index = 0;
-            for (Account account : accounts) {
+            for (Account account : accounts) {//for循环检查账户列表
                 if (TextUtils.equals(account.name, defAccount)) {
-                    checkedItem = index;
+                    checkedItem = index;//查询目标账户
                 }
                 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();
+                    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() {
+        //添加新账户，并为账户添加对话框视图
+        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);
+                });//建立网络组件
+                startActivityForResult(intent, -1);//返回上一选项
                 dialog.dismiss();
             }
         });
     }
 
-    private void showChangeAccountConfirmAlertDialog() {
+    private void showChangeAccountConfirmAlertDialog() {//刷新标签界面
         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,
@@ -269,42 +276,42 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 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) {
+                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)) {
+    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);
+                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);
 
             // clean up local gtask related info
             new Thread(new Runnable() {
-                public void run() {
+                public void run() {//清除本地的gtask关联的信息 将一些参数设置为0或NULL
                     ContentValues values = new ContentValues();
                     values.put(NoteColumns.GTASK_ID, "");
                     values.put(NoteColumns.SYNC_ID, 0);
@@ -314,24 +321,24 @@ public class NotesPreferenceActivity extends PreferenceActivity {
 
             Toast.makeText(NotesPreferenceActivity.this,
                     getString(R.string.preferences_toast_success_set_accout, account),
-                    Toast.LENGTH_SHORT).show();
+                    Toast.LENGTH_SHORT).show();//将toast的文本信息置为“设置账户成功”并显示出来
         }
     }
 
-    private void removeSyncAccount() {
+    private void removeSyncAccount() {//删除同步账户
         SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
-        SharedPreferences.Editor editor = settings.edit();
-        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
+        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)) {
+        if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {//删除当前账户存在时间
             editor.remove(PREFERENCE_LAST_SYNC_TIME);
         }
         editor.commit();
 
         // clean up local gtask related info
-        new Thread(new Runnable() {
-            public void run() {
+        new Thread(new Runnable() {//
+            public void run() {//清除本地的gtask关联的信息，将一些参数设置为0或NULL
                 ContentValues values = new ContentValues();
                 values.put(NoteColumns.GTASK_ID, "");
                 values.put(NoteColumns.SYNC_ID, 0);
@@ -340,49 +347,50 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         }).start();
     }
 
-    public static String getSyncAccountName(Context context) {
+    public static String getSyncAccountName(Context context) {//通过共享的首选项里的信息直接获取
         SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
-                Context.MODE_PRIVATE);
+                Context.MODE_PRIVATE);//获取同步账户名称
         return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
     }
 
-    public static void setLastSyncTime(Context context, long time) {
+    public static void setLastSyncTime(Context context, long time) {//函数：设置最终同步的时间
         SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
-                Context.MODE_PRIVATE);
+                Context.MODE_PRIVATE);//从共享首选项中找到相关账户并获取其编辑器
         SharedPreferences.Editor editor = settings.edit();
         editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);
         editor.commit();
     }
 
-    public static long getLastSyncTime(Context context) {
+    public static long getLastSyncTime(Context context) {////通过共享的首选项里的信息直接获取
         SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
-                Context.MODE_PRIVATE);
+                Context.MODE_PRIVATE);//通过共享，获取时间
         return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
     }
 
     private class GTaskReceiver extends BroadcastReceiver {
-
+        //响应收到的广播情况
         @Override
-        public void onReceive(Context context, Intent intent) {
+        public void onReceive(Context context, Intent intent) {//获取随广播而来的Intent中的同步服务的数据
             refreshUI();
             if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
                 TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
                 syncStatus.setText(intent
                         .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
-            }
+            }//如果在同步状态，改变同步按钮显示的文本
 
         }
     }
 
-    public boolean onOptionsItemSelected(MenuItem item) {
+    public boolean onOptionsItemSelected(MenuItem item) {//处理菜单选项
         switch (item.getItemId()) {
-            case android.R.id.home:
+            case android.R.id.home://返回主界面
                 Intent intent = new Intent(this, NotesListActivity.class);
+                //开始创建活动
                 intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
                 startActivity(intent);
                 return true;
             default:
-                return false;
+                return false;//若出现错误则返回
         }
     }
 }