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

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

@@ -5,7 +5,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        <url id="d0s4q1f37oq8u4itada0" type="url" status="parsed" title="Apache License, Version 2.0" wc="10467">http://www.apache.org/licenses/LICENSE-2.0</url>
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -49,41 +49,48 @@ import net.micode.notes.gtask.remote.GTaskSyncService;
 
 
 public class NotesPreferenceActivity extends PreferenceActivity {
+    // 定义偏好设置名称
     public static final String PREFERENCE_NAME = "notes_preferences";
-
+    // 定义同步账户名称偏好设置键
     public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";
-
+    // 定义最后同步时间偏好设置键
     public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
-
+    // 定义随机背景颜色偏好设置键
     public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";
-
+    // 定义同步账户偏好设置键
     private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
-
+    // 定义授权过滤键
     private static final String AUTHORITIES_FILTER_KEY = "authorities";
 
+    // 定义账户类别偏好设置
     private PreferenceCategory mAccountCategory;
-
+    // 定义同步服务广播接收器
     private GTaskReceiver mReceiver;
-
+    // 定义原始账户数组
     private Account[] mOriAccounts;
-
+    // 定义是否已添加账户的标志
     private boolean mHasAddedAccount;
 
     @Override
     protected void onCreate(Bundle icicle) {
         super.onCreate(icicle);
 
-        /* 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);
     }
@@ -92,20 +99,23 @@ public class NotesPreferenceActivity extends PreferenceActivity {
     protected void onResume() {
         super.onResume();
 
-        // need to set sync account automatically if user has added a new
+        // 如果用户添加了新账户，则自动设置同步账户
-        // account
         if (mHasAddedAccount) {
+            // 获取谷歌账户
             Account[] accounts = getGoogleAccounts();
             if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
                 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;
                     }
@@ -113,53 +123,67 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             }
         }
 
+        // 刷新 UI
         refreshUI();
     }
 
     @Override
     protected void onDestroy() {
+        // 注销广播接收器
         if (mReceiver != null) {
             unregisterReceiver(mReceiver);
         }
         super.onDestroy();
     }
 
+    // 加载账户偏好设置
     private void loadAccountPreference() {
+        // 移除所有账户偏好设置
         mAccountCategory.removeAll();
 
+        // 创建新的账户偏好设置
         Preference accountPref = new Preference(this);
+        // 获取默认同步账户名称
         final String defaultAccount = getSyncAccountName(this);
+        // 设置账户偏好设置的标题和摘要
         accountPref.setTitle(getString(R.string.preferences_account_title));
         accountPref.setSummary(getString(R.string.preferences_account_summary));
+        // 设置账户偏好设置的点击监听器
         accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
             public boolean onPreferenceClick(Preference preference) {
+                // 如果同步服务未运行
                 if (!GTaskSyncService.isSyncing()) {
+                    // 如果默认账户名称为空
                     if (TextUtils.isEmpty(defaultAccount)) {
-                        // the first time to set account
+                        // 显示选择账户对话框
                         showSelectAccountAlertDialog();
                     } else {
-                        // if the account has already been set, we need to promp
+                        // 显示更改账户确认对话框
-                        // user about the risk
                         showChangeAccountConfirmAlertDialog();
                     }
                 } else {
+                    // 显示无法更改账户的提示
                     Toast.makeText(NotesPreferenceActivity.this,
-                            R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
+                                    R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
                             .show();
                 }
                 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()) {
+            // 如果同步服务正在运行，设置按钮文本为取消同步
             syncButton.setText(getString(R.string.preferences_button_sync_cancel));
             syncButton.setOnClickListener(new View.OnClickListener() {
                 public void onClick(View v) {
@@ -167,6 +191,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 }
             });
         } else {
+            // 如果同步服务未运行，设置按钮文本为立即同步
             syncButton.setText(getString(R.string.preferences_button_sync_immediately));
             syncButton.setOnClickListener(new View.OnClickListener() {
                 public void onClick(View v) {
@@ -174,13 +199,16 @@ 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) {
                 lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
@@ -193,29 +221,35 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         }
     }
 
+    // 刷新 UI
     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;
 
+        // 如果有谷歌账户，设置单选按钮
         if (accounts.length > 0) {
             CharSequence[] items = new CharSequence[accounts.length];
             final CharSequence[] itemMapping = items;
@@ -230,6 +264,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             dialogBuilder.setSingleChoiceItems(items, checkedItem,
                     new DialogInterface.OnClickListener() {
                         public void onClick(DialogInterface dialog, int which) {
+                            // 设置同步账户并关闭对话框
                             setSyncAccount(itemMapping[which].toString());
                             dialog.dismiss();
                             refreshUI();
@@ -237,6 +272,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                     });
         }
 
+        // 加载添加账户布局并设置点击监听器
         View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
         dialogBuilder.setView(addAccountView);
 
@@ -245,18 +281,19 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             public void onClick(View v) {
                 mHasAddedAccount = true;
                 Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
-                intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
+                intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] { "gmail-ls" });
-                    "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);
         TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
         titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
@@ -265,6 +302,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         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),
@@ -283,13 +321,16 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         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();
             if (account != null) {
@@ -299,10 +340,10 @@ public class NotesPreferenceActivity extends PreferenceActivity {
             }
             editor.commit();
 
-            // clean up last sync time
+            // 清除最后同步时间
             setLastSyncTime(this, 0);
 
-            // clean up local gtask related info
+            // 清除本地与同步相关的数据
             new Thread(new Runnable() {
                 public void run() {
                     ContentValues values = new ContentValues();
@@ -312,13 +353,16 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 }
             }).start();
 
+            // 显示设置账户成功的提示
             Toast.makeText(NotesPreferenceActivity.this,
                     getString(R.string.preferences_toast_success_set_accout, account),
                     Toast.LENGTH_SHORT).show();
         }
     }
 
+    // 移除同步账户
     private void removeSyncAccount() {
+        // 移除同步账户名称和最后同步时间
         SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
         SharedPreferences.Editor editor = settings.edit();
         if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
@@ -329,7 +373,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         }
         editor.commit();
 
-        // clean up local gtask related info
+        // 清除本地与同步相关的数据
         new Thread(new Runnable() {
             public void run() {
                 ContentValues values = new ContentValues();
@@ -340,43 +384,44 @@ public class NotesPreferenceActivity extends PreferenceActivity {
         }).start();
     }
 
+    // 获取同步账户名称
     public static String getSyncAccountName(Context context) {
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+        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) {
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+        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) {
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+        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) {
+            // 刷新 UI 并更新同步状态文本
             refreshUI();
             if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
                 TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
-                syncStatus.setText(intent
+                syncStatus.setText(intent.getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
-                        .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
             }
-
         }
     }
 
+    // 处理菜单项点击事件
     public boolean onOptionsItemSelected(MenuItem item) {
         switch (item.getItemId()) {
             case android.R.id.home:
+                // 返回笔记列表活动
                 Intent intent = new Intent(this, NotesListActivity.class);
                 intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
                 startActivity(intent);
@@ -385,4 +430,4 @@ public class NotesPreferenceActivity extends PreferenceActivity {
                 return false;
         }
     }
-}
+}