diff --git a/java/net/micode/notes/ui/NotesPreferenceActivity.java b/java/net/micode/notes/ui/NotesPreferenceActivity.java index 07c5f7e..83bbff6 100644 --- a/java/net/micode/notes/ui/NotesPreferenceActivity.java +++ b/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 + * http://www.apache.org/licenses/LICENSE-2.0 * * 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[] { - "gmail-ls" - }); + 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); 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, - Context.MODE_PRIVATE); + 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 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); + 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) { + // 刷新 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 - .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG)); + syncStatus.setText(intent.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; } } -} +} \ No newline at end of file