/* * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) * * Licensed under the Apache License, Version 2.0 (the "License"); * 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 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package net.micode.notes.ui; import android.accounts.Account; import android.accounts.AccountManager; import android.app.ActionBar; import android.app.AlertDialog; import android.content.BroadcastReceiver; import android.content.ContentValues; import android.content.Context; import android.content.DialogInterface; import android.content.Intent; import android.content.IntentFilter; import android.content.SharedPreferences; import android.os.Bundle; import android.preference.Preference; import android.preference.Preference.OnPreferenceClickListener; import android.preference.PreferenceActivity; import android.preference.PreferenceCategory; import android.text.TextUtils; import android.text.format.DateFormat; import android.view.LayoutInflater; import android.view.Menu; import android.view.MenuItem; 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; 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"; // 权限过滤键 // 类成员变量定义部分：主要用于账户同步和UI更新 private PreferenceCategory mAccountCategory; // 账户分类偏好项 private GTaskReceiver mReceiver; // 接收同步任务的广播接收器 private Account[] mOriAccounts; // 原始账户数组 private boolean mHasAddedAccount; // 标记是否已添加新账户 /** * 当设置Activity创建时调用。 * 主要进行界面初始化和设置账户同步。 * * @param icicle 保存Activity状态的Bundle，用于恢复状态。 */ @Override protected void onCreate(Bundle icicle) { super.onCreate(icicle); // 设置返回按钮 getActionBar().setDisplayHomeAsUpEnabled(true); // 从XML加载偏好设置 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); } /** * 当设置Activity恢复到前台时调用。 * 主要用于检查并自动设置新添加的账户进行同步。 */ @Override protected void onResume() { super.onResume(); // 自动设置新添加的账户进行同步 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; } } } } // 刷新UI refreshUI(); } /** * 当Activity即将被销毁时调用，用于注销广播接收器。 */ @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)) { // 如果尚未设置账户，则展示选择账户对话框 showSelectAccountAlertDialog(); } else { // 如果已经设置账户，则展示更改账户确认对话框 showChangeAccountConfirmAlertDialog(); } } else { // 如果正在同步中，则展示无法更改账户的提示 Toast.makeText(NotesPreferenceActivity.this, 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); // 获取上次同步时间视图 // 根据同步状态设置按钮文本和点击事件 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.setOnClickListener(new View.OnClickListener() { public void onClick(View v) { GTaskSyncService.startSync(NotesPreferenceActivity.this); // 设置点击事件为开始同步 } }); } syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this))); // 只有在设置了同步账户时才使能同步按钮 // 根据同步状态设置上次同步时间的显示 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, 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(); // 加载同步按钮 } /** * 显示选择账户的对话框。 * 该对话框列出了已连接的Google账户，并允许用户选择一个账户用于同步。 * 如果没有账户，对话框将提供添加账户的选项。 */ 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); // 移除默认的确定按钮 // 获取当前设备上的Google账户 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; int checkedItem = -1; // 记录默认选中的账户 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(); } }); } // 添加“添加账户”选项 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) { 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); 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); // 创建菜单项并设置点击事件 CharSequence[] menuItemArray = new CharSequence[]{ 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) { // 选择更改账户，显示账户选择对话框 showSelectAccountAlertDialog(); } else if (which == 1) { // 选择移除账户，执行移除操作并刷新UI removeSyncAccount(); refreshUI(); } } }); dialogBuilder.show(); } /** * 获取设备上的Google账户列表。 * * @return Account[] 返回设备上所有类型为“com.google”的账户数组。 */ private Account[] getGoogleAccounts() { AccountManager accountManager = AccountManager.get(this); return accountManager.getAccountsByType("com.google"); } /** * 设置同步账户信息。 * 如果当前账户与传入账户不一致，则更新SharedPreferences中的账户信息，并清理本地相关的gtask信息。 * * @param 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); } else { editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, ""); } editor.commit(); // 清理上次同步时间 setLastSyncTime(this, 0); // 清理本地相关的gtask信息 new Thread(new Runnable() { public void run() { ContentValues values = new ContentValues(); values.put(NoteColumns.GTASK_ID, ""); values.put(NoteColumns.SYNC_ID, 0); getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); } }).start(); // 显示设置成功的提示信息 Toast.makeText(NotesPreferenceActivity.this, getString(R.string.preferences_toast_success_set_accout, account), Toast.LENGTH_SHORT).show(); } } /** * 移除同步账户信息。 * 清除SharedPreferences中的账户信息和上次同步时间，并清理本地相关的gtask信息。 */ 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(); // 清理本地相关的gtask信息 new Thread(new Runnable() { public void run() { ContentValues values = new ContentValues(); values.put(NoteColumns.GTASK_ID, ""); values.put(NoteColumns.SYNC_ID, 0); getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); } }).start(); } /** * 获取当前同步账户名。 * 从SharedPreferences中获取存储的账户名，默认为空字符串。 * * @param context 上下文 * @return 同步账户名 */ public static String getSyncAccountName(Context context) { SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, ""); } /** * 设置上次同步的时间。 * 将指定的时间保存到SharedPreferences中。 * * @param context 上下文 * @param time 上次同步的时间戳 */ 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(); } /** * 获取上次同步的时间。 * 从SharedPreferences中获取上次同步的时间戳，默认为0。 * * @param context 上下文 * @return 上次同步的时间戳 */ public static long getLastSyncTime(Context context) { SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0); } /** * 广播接收器类，用于接收gtask同步相关的广播消息，并据此刷新UI。 */ private class GTaskReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { refreshUI(); // 如果广播消息表明正在同步，则更新UI显示的同步状态信息 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)); } } } /** * 处理选项菜单项的选择事件。 * * @param item 选中的菜单项 * @return 如果事件已处理，则返回true；否则返回false。 */ public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case android.R.id.home: // 当选择返回按钮时，启动NotesListActivity并清除当前活动栈顶以上的所有活动 Intent intent = new Intent(this, NotesListActivity.class); intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP); startActivity(intent); return true; default: return false; } } }