/* * 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. */ /** * 文件: NotesPreferenceActivity.java * 描述: 便签应用的设置界面 * 作用: 提供应用设置选项,特别是Google账户同步功能的配置 * 功能: * 1. 管理Google账户同步设置 * 2. 提供同步按钮和状态显示 * 3. 处理账户选择和添加 * 4. 显示上次同步时间 */ 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; /** * 便签设置活动类 * * 继承自PreferenceActivity,提供便签应用的设置界面 * 主要功能是配置Google账户同步,包括账户选择和同步操作 * 显示同步状态和上次同步时间 */ 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; /** Google任务同步广播接收器 */ private GTaskReceiver mReceiver; /** 原始账户列表,用于检测新添加的账户 */ private Account[] mOriAccounts; /** 是否已添加新账户的标志 */ private boolean mHasAddedAccount; /** * 活动创建时的初始化 * * @param icicle 保存的实例状态 */ @Override protected void onCreate(Bundle icicle) { super.onCreate(icicle); /* 设置应用图标用于导航 */ 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); } /** * 活动恢复时的处理 * 检查是否添加了新账户,并刷新UI */ @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(); } /** * 活动销毁时的清理工作 */ @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); } } } /** * 刷新UI显示 * 更新账户设置和同步按钮状态 */ 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) { // 移除账户 removeSyncAccount(); refreshUI(); } } }); dialogBuilder.show(); } /** * 获取设备上的所有Google账户 * * @return Google账户数组 */ private Account[] getGoogleAccounts() { AccountManager accountManager = AccountManager.get(this); return accountManager.getAccountsByType("com.google"); } /** * 设置同步账户 * * @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); // 清除本地Google任务相关信息 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(); } } /** * 移除同步账户 * 清除所有同步相关设置 */ 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(); // 清除本地Google任务相关信息 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(); } /** * 获取同步账户名称 * * @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, ""); } /** * 设置上次同步时间 * * @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(); } /** * 获取上次同步时间 * * @param context 上下文环境 * @return 上次同步的时间戳,如果未同步则返回0 */ public static long getLastSyncTime(Context context) { SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0); } /** * Google任务同步广播接收器 * 用于接收同步服务的状态更新广播 */ private class GTaskReceiver extends BroadcastReceiver { /** * 接收同步服务广播 * 更新UI显示同步状态 */ @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); syncStatus.setText(intent .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG)); } } } /** * 处理选项菜单项点击事件 * * @param item 点击的菜单项 * @return 是否已处理事件 */ 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); return true; default: return false; } } }