sda

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

@@ -47,36 +47,46 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.gtask.remote.GTaskSyncService;
 
-
+//NotesPreferenceActivity其中包含应用程序的偏好设置
+//用户可以通过这个列表来更改应用程序的设置
+//主要实现的是对背景颜色和字体大小的数据储存
+//继承自 PreferenceActivity 类
 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
+    //创建
     protected void onCreate(Bundle icicle) {
+        //调用父类的 onCreate 方法并传入保存的实例状态
         super.onCreate(icicle);
 
         /* using the app icon for navigation */
+        //使用应用程序图标进行导航
+        //设置返回图标
         getActionBar().setDisplayHomeAsUpEnabled(true);
 
+        //从资源添加首选项
+        //添加xml来源并显示 xml
         addPreferencesFromResource(R.xml.preferences);
+         //根据同步账户关键码来初始化分组
         mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
         mReceiver = new GTaskReceiver();
         IntentFilter filter = new IntentFilter();
@@ -84,20 +94,29 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         registerReceiver(mReceiver, filter);
 
         mOriAccounts = null;
+        //获取listvivew并在listview组件上方添加其他组件
         View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
         getListView().addHeaderView(header, null, true);
     }
 
     @Override
+    //
     protected void onResume() {
+        //执行父类
         super.onResume();
 
         // need to set sync account automatically if user has added a new
+        //如果用户添加了新的同步帐户，则需要自动设置同步帐户
         // account
+        //如果为真
         if (mHasAddedAccount) {
+            //获取谷歌账户
             Account[] accounts = getGoogleAccounts();
+            //若原账户不为空且账户数量有增加
             if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
+                //遍历 accounts 中的每个帐户
                 for (Account accountNew : accounts) {
+                    //如果没有找到相同名称的账户，就调用setSyncAccount 方法并传入新帐户的名称
                     boolean found = false;
                     for (Account accountOld : mOriAccounts) {
                         if (TextUtils.equals(accountOld.name, accountNew.name)) {
@@ -112,34 +131,44 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 }
             }
         }
-
+        //刷新UI
         refreshUI();
     }
 
     @Override
+    //摧毁
     protected void onDestroy() {
         if (mReceiver != null) {
-            unregisterReceiver(mReceiver);
+            unregisterReceiver(mReceiver); //注销接收器
         }
+        //调用父类
         super.onDestroy();
     }
 
+    //加载帐户首选项
     private void loadAccountPreference() {
+        //删除所有首选项
         mAccountCategory.removeAll();
 
         Preference accountPref = new Preference(this);
+        //获取默认账户名称
         final String defaultAccount = getSyncAccountName(this);
+        //设置帐户首选项的标题和摘要文本
         accountPref.setTitle(getString(R.string.preferences_account_title));
         accountPref.setSummary(getString(R.string.preferences_account_summary));
         accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
+            //为帐户首选项设置一个点击监听器
             public boolean onPreferenceClick(Preference preference) {
                 if (!GTaskSyncService.isSyncing()) {
                     if (TextUtils.isEmpty(defaultAccount)) {
                         // the first time to set account
+                        //显示选择帐户的警告对话框
                         showSelectAccountAlertDialog();
                     } else {
                         // if the account has already been set, we need to promp
+                        //如果帐户已经设置，我们需要 promp
                         // user about the risk
+                        //展示更改警示对话框
                         showChangeAccountConfirmAlertDialog();
                     }
                 } else {
@@ -150,23 +179,30 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 return true;
             }
         });
-
+        //最后，将帐户首选项添加到成员变量 mAccountCategory 中
         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
+        // set button stat //设置按钮状态
+        //若在同步状态
         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 {
+            //否则设置同步按钮的文本为立即同步
+            //并为按钮设置一个点击监听器，当用户点击按钮时，监听器会调用 GTaskSyncService.startSync 方法并传入当前活动来开始同步
             syncButton.setText(getString(R.string.preferences_button_sync_immediately));
             syncButton.setOnClickListener(new View.OnClickListener() {
                 public void onClick(View v) {
@@ -177,45 +213,56 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
 
         // set last sync time
+        //设置最终同步时间
         if (GTaskSyncService.isSyncing()) {
             lastSyncTimeView.setText(GTaskSyncService.getProgressString());
             lastSyncTimeView.setVisibility(View.VISIBLE);
         } else {
+            //若非同步
             long lastSyncTime = getLastSyncTime(this);
             if (lastSyncTime != 0) {
+                //若不为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 {
+                //否则，将其设置为隐藏
                 lastSyncTimeView.setVisibility(View.GONE);
             }
         }
     }
 
+    //更新界面
     private void refreshUI() {
         loadAccountPreference();
         loadSyncButton();
     }
 
+    //显示账户选择的对话框并进行账户的设置
     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);
 
+        //获取账户
+        //获取账户名称
         Account[] accounts = getGoogleAccounts();
         String defAccount = getSyncAccountName(this);
 
         mOriAccounts = accounts;
         mHasAddedAccount = false;
 
+        //如果账户数量不是0
         if (accounts.length > 0) {
             CharSequence[] items = new CharSequence[accounts.length];
             final CharSequence[] itemMapping = items;
@@ -223,38 +270,48 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             int index = 0;
             for (Account account : accounts) {
                 if (TextUtils.equals(account.name, defAccount)) {
+                    //在账户列表中查询到所需账户
                     checkedItem = index;
                 }
                 items[index++] = account.name;
             }
+            //设置一个单选框
             dialogBuilder.setSingleChoiceItems(items, checkedItem,
+                    //新建一个列表监听器
                     new DialogInterface.OnClickListener() {
                         public void onClick(DialogInterface dialog, int which) {
                             setSyncAccount(itemMapping[which].toString());
-                            dialog.dismiss();
-                            refreshUI();
+                            dialog.dismiss();//取消对话框
+                            refreshUI();//更新界面
                         }
                     });
         }
-
+        //给新加账户对话框设置自定义样式
         View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
         dialogBuilder.setView(addAccountView);
         
+        //显示对话框
         final AlertDialog dialog = dialogBuilder.show();
+        //添加账户账户对话框监听器
         addAccountView.setOnClickListener(new View.OnClickListener() {
             public void onClick(View v) {
+                //账户哈希表置为true
                 mHasAddedAccount = true;
+                //建立网络建立组件
                 Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
                 intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
                     "gmail-ls"
                 });
+                //跳回上一个选项
                 startActivityForResult(intent, -1);
                 dialog.dismiss();
             }
         });
     }
 
+    //显示账户选择对话框和相关账户操作
     private void showChangeAccountConfirmAlertDialog() {
+        //创建对话框
         AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
 
         View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
@@ -262,9 +319,12 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
                 getSyncAccountName(this)));
         TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+        //根据同步修改的账户信息设置标题以及子标题的内容
         subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));        
+        //设置对话框的自定义标题
         dialogBuilder.setCustomTitle(titleView);
 
+        //定义字符串
         CharSequence[] menuItemArray = new CharSequence[] {
                 getString(R.string.preferences_menu_change_account),
                 getString(R.string.preferences_menu_remove_account),
@@ -274,21 +334,25 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             public void onClick(DialogInterface dialog, int which) {
                 if (which == 0) {
                     showSelectAccountAlertDialog();
-                } else if (which == 1) {
+                } else if (which == 1) { //如果witch==1 //删除账户并且跟新便签界面
                     removeSyncAccount();
                     refreshUI();
                 }
             }
         });
+        //显示对话框
         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();
@@ -297,12 +361,15 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             } else {
                 editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
             }
+            //提交修改的数据
             editor.commit();
 
             // clean up last sync time
+            //清理上次同步时间
             setLastSyncTime(this, 0);
 
             // clean up local gtask related info
+            // 清理本地 gtask 相关信息
             new Thread(new Runnable() {
                 public void run() {
                     ContentValues values = new ContentValues();
@@ -312,24 +379,31 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 }
             }).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)) {
+        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {//假如当前首选项中有账户就删除
             editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);
         }
+        //删除当前首选项中有账户时间
         if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {
             editor.remove(PREFERENCE_LAST_SYNC_TIME);
         }
+        //提交
         editor.commit();
 
         // clean up local gtask related info
+        //清理本地 gtask 相关信息
         new Thread(new Runnable() {
             public void run() {
                 ContentValues values = new ContentValues();
@@ -340,31 +414,38 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         }).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);
     }
 
+    //接受同步信息
     private class GTaskReceiver extends BroadcastReceiver {
 
         @Override
         public void onReceive(Context context, Intent intent) {
             refreshUI();
+            //获取随广播而来的Intent中的同步服务的数据
+            //通过获取的数据在设置系统的状态
             if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
                 TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
                 syncStatus.setText(intent
@@ -373,7 +454,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
 
         }
     }
-
+    //处理菜单的选项
     public boolean onOptionsItemSelected(MenuItem item) {
         switch (item.getItemId()) {
             case android.R.id.home: