pull/4/head
fxk 2 years ago
parent 8211fe7d98
commit 0afe9e0e34

@ -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));
//根据同步修改的账户信息设置标题以及子标题的内容
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:

Loading…
Cancel
Save