|
|
/*
|
|
|
* 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 {
|
|
|
//NotesPreferenceActivity，在小米便签中主要实现的是对背景颜色和字体大小的数据储存。
|
|
|
// 继承了PreferenceActivity主要功能为对系统信息和配置进行自动保存的Activity
|
|
|
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;
|
|
|
// 账户的has标记
|
|
|
@Override
|
|
|
protected void onCreate(Bundle icicle) {//创建一个activity，在函数里要完成所有的正常静态设置
|
|
|
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);
|
|
|
//注册监听器，和对应的filter绑定
|
|
|
mOriAccounts = null;
|
|
|
View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
|
|
|
getListView().addHeaderView(header, null, true);
|
|
|
//从xml获取Listview，获取listvivew，ListView的作用:用于列出所有选择
|
|
|
}
|
|
|
|
|
|
@Override
|
|
|
protected void onResume() {//activity交互功能的实现，用于接受用户的输入
|
|
|
super.onResume();//
|
|
|
|
|
|
// need to set sync account automatically if user has added a new
|
|
|
// account
|
|
|
if (mHasAddedAccount) {//若用户新加了账户则自动设置同步账户
|
|
|
Account[] accounts = getGoogleAccounts();//获取google同步账户
|
|
|
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;
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
refreshUI();
|
|
|
}
|
|
|
|
|
|
@Override
|
|
|
protected void onDestroy() {//销毁Activity
|
|
|
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));//与google task同步便签记录
|
|
|
accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {//设置preference的的监听器
|
|
|
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)
|
|
|
.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()) {//设置按钮状态
|
|
|
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)));
|
|
|
//如果没有账户，则不可选“立即同步”的按键
|
|
|
// 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,
|
|
|
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;//获得账户同步信息
|
|
|
|
|
|
if (accounts.length > 0) {//如果有账户，则显示所有账户名称
|
|
|
CharSequence[] items = new CharSequence[accounts.length];
|
|
|
final CharSequence[] itemMapping = items;
|
|
|
int checkedItem = -1;
|
|
|
int index = 0;
|
|
|
for (Account account : accounts) {//for循环检查账户列表
|
|
|
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();//显示对话框
|
|
|
}
|
|
|
|
|
|
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) {
|
|
|
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);//若账户不为空，编辑账户的首选项
|
|
|
} else {
|
|
|
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
|
|
|
}
|
|
|
editor.commit();//提交数据
|
|
|
|
|
|
// clean up last sync time
|
|
|
setLastSyncTime(this, 0);
|
|
|
|
|
|
// clean up local gtask related info
|
|
|
new Thread(new Runnable() {
|
|
|
public void run() {//清除本地的gtask关联的信息 将一些参数设置为0或NULL
|
|
|
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();//将toast的文本信息置为“设置账户成功”并显示出来
|
|
|
}
|
|
|
}
|
|
|
|
|
|
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();
|
|
|
|
|
|
// clean up local gtask related info
|
|
|
new Thread(new Runnable() {//
|
|
|
public void run() {//清除本地的gtask关联的信息，将一些参数设置为0或NULL
|
|
|
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();
|
|
|
}
|
|
|
|
|
|
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) {//获取随广播而来的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));
|
|
|
}//如果在同步状态，改变同步按钮显示的文本
|
|
|
|
|
|
}
|
|
|
}
|
|
|
|
|
|
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;//若出现错误则返回
|
|
|
}
|
|
|
}
|
|
|
}
|
