1

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

@@ -15,7 +15,7 @@
  */
 
 package net.micode.notes.ui;
-
+ 
 import android.content.Context;
 import android.text.format.DateUtils;
 import android.view.View;
@@ -23,46 +23,53 @@ import android.widget.CheckBox;
 import android.widget.ImageView;
 import android.widget.LinearLayout;
 import android.widget.TextView;
-
+ 
 import net.micode.notes.R;
 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 ImageView mAlert;//闹钟图片
-    private TextView mTitle;
+    private TextView mTitle;  //标题
-    private TextView mTime;
+    private TextView mTime;   //时间
-    private TextView mCallName;
+    private TextView mCallName;    //名称
-    private NoteItemData mItemData;
+    private NoteItemData mItemData; //标签数据
-    private CheckBox mCheckBox;
+    private CheckBox mCheckBox;    //打钩框
-
+ 
+    /*
+     * 初始化基本信息
+    */
     public NotesListItem(Context context) {
-        super(context);
+        super(context);   //super()的主要作用是调整调用父类构造函数的顺序
-        inflate(context, R.layout.note_item, this);
+        inflate(context, R.layout.note_item, this);//Inflate可用于将一个xml中定义的布局控件找出来,这里的xml是r.layout
-        mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
+        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);
     }
-
+  ///根据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.setVisibility(View.VISIBLE);  //设置可见行为
-            mCheckBox.setChecked(checked);
+            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);
-            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
+            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);//设置该textview的style
+            
             mTitle.setText(context.getString(R.string.call_record_folder_name)
-                    + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
+                    + context.getString(R.string.format_folder_files_count, data.getNotesCount()));//settext为设置内容
             mAlert.setImageResource(R.drawable.call_record);
         } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
             mCallName.setVisibility(View.VISIBLE);
@@ -70,7 +77,7 @@ public class NotesListItem extends LinearLayout {
             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 +85,6 @@ public class NotesListItem extends LinearLayout {
         } else {
             mCallName.setVisibility(View.GONE);
             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
-
             if (data.getType() == Notes.TYPE_FOLDER) {
                 mTitle.setText(data.getSnippet()
                         + context.getString(R.string.format_folder_files_count,
@@ -94,29 +100,33 @@ public class NotesListItem extends LinearLayout {
                 }
             }
         }
-        mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
+        
-
+        mTime. setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));//获取相关时间，从data里编辑的日期中获取
+       
         setBackground(data);
     }
 
+    //根据data的文件属性来设置背景
     private void setBackground(NoteItemData data) {
         int id = data.getBgColorId();
+        //若是note型文件，对于4种不同情况的背景来源的处理
         if (data.getType() == Notes.TYPE_NOTE) {
+        	
             if (data.isSingle() || data.isOneFollowingFolder()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
+                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));//单个数据并且只有一个子文件夹
             } else if (data.isLast()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
+                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));//是最后一个数据
             } else if (data.isFirst() || data.isMultiFollowingFolder()) {
-                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
+                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));//是一个数据并有多个子文件夹
             } else {
                 setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
             }
         } else {
-            setBackgroundResource(NoteItemBgResources.getFolderBgRes());
+        	
+            setBackgroundResource(NoteItemBgResources.getFolderBgRes());//若不是note直接调用文件夹的背景来源
         }
     }
-
     public NoteItemData getItemData() {
         return mItemData;
     }
-}
+}

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

@@ -15,7 +15,7 @@
  */
 
 package net.micode.notes.ui;
-
+ 
 import android.accounts.Account;
 import android.accounts.AccountManager;
 import android.app.ActionBar;
@@ -41,70 +41,92 @@ 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.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);//先执行父类的创建函数
+        
+        getActionBar().setDisplayHomeAsUpEnabled(true);//给左上角图标的左边加上一个返回的图标 
+ 
+        addPreferencesFromResource(R.xml.preferences);//添加xml来源并显示 xml
+        
+        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);//根据同步账户关键码来初始化分组
 
-        /* using the app icon for navigation */
-        getActionBar().setDisplayHomeAsUpEnabled(true);
 
-        addPreferencesFromResource(R.xml.preferences);
+        //初始化同步组件
-        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
         mReceiver = new GTaskReceiver();
         IntentFilter filter = new IntentFilter();
         filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
         registerReceiver(mReceiver, filter);
-
+        
+ 
         mOriAccounts = null;
         View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
-        getListView().addHeaderView(header, null, true);
+        
+        getListView().addHeaderView(header, null, true);//获取listvivew，并在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();
+            Account[] accounts = getGoogleAccounts();//获取google同步账户
+
+            //若原账户不为空且当前账户有增加
             if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
-                for (Account accountNew : accounts) {
+            	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;
@@ -112,74 +134,86 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 }
             }
         }
-
+ 
-        refreshUI();
+        refreshUI();//刷新标签界面
     }
-
+ 
     @Override
+    /*
+     * 函数功能：销毁一个activity
+     */
     protected void onDestroy() {
         if (mReceiver != null) {
-            unregisterReceiver(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) {
                 if (!GTaskSyncService.isSyncing()) {
                     if (TextUtils.isEmpty(defaultAccount)) {
-                        // the first time to set account
+                        showSelectAccountAlertDialog();//若是第一次建立账户显示选择账户提示对话框
-                        showSelectAccountAlertDialog();
                     } else {
-                        // if the account has already been set, we need to promp
+                        showChangeAccountConfirmAlertDialog();//若是已经建立则显示修改对话框并进行修改操作
-                        // user about the risk
-                        showChangeAccountConfirmAlertDialog();
                     }
                 } else {
                     Toast.makeText(NotesPreferenceActivity.this,
                             R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
-                            .show();
+                            .show();//若在没有同步的情况下，则在toast中显示不能修改
                 }
                 return true;
             }
         });
 
-        mAccountCategory.addPreference(accountPref);
+        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);
+        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);
+                    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);
+                    GTaskSyncService.startSync(NotesPreferenceActivity.this);//若是不同步则设置按钮显示的文本为“立即同步”以及对应监听器
                 }
             });
+          
         }
-        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
+        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));//设置按键可用还是不可用
-
+        
-        // set last sync time
+ 
+        // 设置最终同步时间
         if (GTaskSyncService.isSyncing()) {
             lastSyncTimeView.setText(GTaskSyncService.getProgressString());
-            lastSyncTimeView.setVisibility(View.VISIBLE);
+            lastSyncTimeView.setVisibility(View.VISIBLE); // 根据当前同步服务器设置时间显示框的文本以及可见性   
         } else {
             long lastSyncTime = getLastSyncTime(this);
             if (lastSyncTime != 0) {
@@ -188,34 +222,43 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                                 lastSyncTime)));
                 lastSyncTimeView.setVisibility(View.VISIBLE);
             } else {
-                lastSyncTimeView.setVisibility(View.GONE);
+                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);
 
+        //获取同步账户信息
         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;
@@ -223,86 +266,124 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             int index = 0;
             for (Account account : accounts) {
                 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();
+                            dialog.dismiss();//取消对话框
+                            
                             refreshUI();
                         }
+                        
                     });
         }
-
+ 
         View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
-        dialogBuilder.setView(addAccountView);
+        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;
+                mHasAddedAccount = true;//将新加账户的hash置true
-                Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
+                
+                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() {
         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);
+        
+        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)
         };
+
+
+        //设置对话框要显示的一个list，用于显示change，remove，cancel等命令
         dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
+        	//按键功能，由which来决定
             public void onClick(DialogInterface dialog, int which) {
                 if (which == 0) {
-                    showSelectAccountAlertDialog();
+                    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)) {
             SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
-            SharedPreferences.Editor editor = settings.edit();
+            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
+            editor.commit();//提交修改的数据
-            setLastSyncTime(this, 0);
+            
-
+ 
-            // clean up local gtask related info
+            
+            setLastSyncTime(this, 0);//将最后同步时间清零
+          
+ 
+            //重置当地同步任务的信息
             new Thread(new Runnable() {
                 public void run() {
                     ContentValues values = new ContentValues();
@@ -311,25 +392,34 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                     getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
                 }
             }).start();
-
+            
+            //将toast的文本信息置为“设置账户成功”并显示出来
             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();
+        editor.commit();//提交更新后的数据
-
+        
-        // clean up local gtask related info
+        //重置当地同步任务的信息
         new Thread(new Runnable() {
             public void run() {
                 ContentValues values = new ContentValues();
@@ -338,51 +428,78 @@ 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();
+        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)) {
-                TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
+                //获取随广播而来的Intent中的同步服务的数据
+
+            	TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
                 syncStatus.setText(intent
-                        .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
+                        .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));//通过获取的数据在设置系统的状态
             }
-
+ 
         }
     }
-
+ 
+    /*
+     * 功能：处理菜单的选项
+     * 参数:MenuItem菜单选项
+     */
     public boolean onOptionsItemSelected(MenuItem item) {
         switch (item.getItemId()) {
+            //在主页情况下在创建连接组件intent，发出清空的信号并开始一个相应的activity
             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;
         }
     }
 }
+