diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesPreferenceActivity.java b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesPreferenceActivity.java index 07c5f7e..f9950dd 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesPreferenceActivity.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesPreferenceActivity.java @@ -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: