diff --git a/README.md b/README.md index cb51a42..722a882 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,10 @@ # gitProject1 1.精读小米便签源代码，写泛读报告 +<<<<<<< HEAD + +2. +======= ======= <<<<<<< HEAD <<<<<<< HEAD @@ -24,3 +28,4 @@ abc 1.精读小米便签源代码，写泛读报告 >>>>>>> ec5b092c2fe5adbe24627fc2992503627dc1795b >>>>>>> 5f5cff49fcbaa1b5df8823143d84bbfcc52cd49f +>>>>>>> 63fc6f227a94c2fab6101a51858ced17a7619c89 diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteEditText.java b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteEditText.java index 2afe2a8..ff72da5 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteEditText.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteEditText.java @@ -36,7 +36,7 @@ import net.micode.notes.R; import java.util.HashMap; import java.util.Map; - +//继承edittext，设置便签设置文本框 public class NoteEditText extends EditText { private static final String TAG = "NoteEditText"; private int mIndex; @@ -46,6 +46,8 @@ public class NoteEditText extends EditText { private static final String SCHEME_HTTP = "http:" ; private static final String SCHEME_EMAIL = "mailto:" ; +//定义了一个名为sSchemaActionResMap的静态常量map,构成字符串与整数的映射 +//用于存储电话网站还有邮箱 private static final Map sSchemaActionResMap = new HashMap(); static { sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel); @@ -56,54 +58,69 @@ public class NoteEditText extends EditText { /** * Call by the {@link NoteEditActivity} to delete or add edit text */ + +//在NoteEditActivity中删除或添加文本的操作，可以看做是一个文本是否被变的标记 public interface OnTextViewChangeListener { /** * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens * and the text is null */ + //在按下删除键且文本为空时删除当前编辑文本 void onEditTextDelete(int index, String text); /** * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER} * happen */ + //在按下回车键时在当前编辑文本后添加编辑文本 void onEditTextEnter(int index, String text); /** * Hide or show item option when text change - */ + */ + //在文本更改时隐藏或显示项目选项 void onTextChange(int index, boolean hasText); } private OnTextViewChangeListener mOnTextViewChangeListener; + + //根据context设置文本 public NoteEditText(Context context) { super(context, null); + //用super引用父类变量 mIndex = 0; } + //光标设置 public void setIndex(int index) { mIndex = index; } + //初始化文本修改标记 public void setOnTextViewChangeListener(OnTextViewChangeListener listener) { mOnTextViewChangeListener = listener; } + //初始化便签 public NoteEditText(Context context, AttributeSet attrs) { super(context, attrs, android.R.attr.editTextStyle); } + // 根据defstyle自动初始化 public NoteEditText(Context context, AttributeSet attrs, int defStyle) { super(context, attrs, defStyle); // TODO Auto-generated constructor stub } - @Override + @Override + //重写函数 + //view里的函数 public boolean onTouchEvent(MotionEvent event) { - switch (event.getAction()) { + switch (event.getAction()) { + //重写了需要处理屏幕被按下的事 + //改变坐标值 case MotionEvent.ACTION_DOWN: - int x = (int) event.getX(); int y = (int) event.getY(); x -= getTotalPaddingLeft(); @@ -111,9 +128,12 @@ public class NoteEditText extends EditText { x += getScrollX(); y += getScrollY(); + //用布局控件layout根据x,y的新值设置新的位置 Layout layout = getLayout(); int line = layout.getLineForVertical(y); int off = layout.getOffsetForHorizontal(line, x); + + //光标位置更新 Selection.setSelection(getText(), off); break; } @@ -123,7 +143,9 @@ public class NoteEditText extends EditText { @Override public boolean onKeyDown(int keyCode, KeyEvent event) { + //根据按键的 Unicode 编码值来处理 switch (keyCode) { + //更具用户按下的keyCode是进入还是删除来处理事件 case KeyEvent.KEYCODE_ENTER: if (mOnTextViewChangeListener != null) { return false; @@ -135,30 +157,40 @@ public class NoteEditText extends EditText { default: break; } + //继续执行父类的其他点击事件 return super.onKeyDown(keyCode, event); } @Override public boolean onKeyUp(int keyCode, KeyEvent event) { + //根据按键的 Unicode 编码值来处理，有删除和进入2种操作 switch(keyCode) { - case KeyEvent.KEYCODE_DEL: + case KeyEvent.KEYCODE_DEL: + //当按键为删除键时，如果 mOnTextViewChangeListener 不为 null，则会检查当前光标位置是否为0且 mIndex不为0，则调用 if (mOnTextViewChangeListener != null) { if (0 == mSelectionStartBeforeDelete && mIndex != 0) { mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString()); + //利用上文OnTextViewChangeListener对KEYCODE_DEL按键情况的删除函数进行删除 return true; } } else { + //否则，会在日志中输出一条信息，表示文本视图更改监听器未设置。 Log.d(TAG, "OnTextViewChangeListener was not seted"); } break; - case KeyEvent.KEYCODE_ENTER: + case KeyEvent.KEYCODE_ENTER: + //当按键为进入键时 if (mOnTextViewChangeListener != null) { int selectionStart = getSelectionStart(); + //获取当前位置 String text = getText().subSequence(selectionStart, length()).toString(); + //获取当前文本 setText(getText().subSequence(0, selectionStart)); + //根据获取位置设置当前文本 mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text); } else { Log.d(TAG, "OnTextViewChangeListener was not seted"); + //其他情况报错，并输出文档的改动监听器并没有建立 } break; default: @@ -168,30 +200,48 @@ public class NoteEditText extends EditText { } @Override + //焦点变化时处理事件 + //focused表示是否获得焦点 + //direction表示焦点变化的方向 + //previouslyFocusedRect表示之前获得焦点视图的位置 protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) { + if (mOnTextViewChangeListener != null) { + //监听器已经建立 if (!focused && TextUtils.isEmpty(getText())) { + //获取到焦点并且文本不为空 mOnTextViewChangeListener.onTextChange(mIndex, false); + //false则隐藏事件选项 } else { mOnTextViewChangeListener.onTextChange(mIndex, true); + //true则显示事件选项 } } + //继续执行父类的其他焦点变化的事件 super.onFocusChanged(focused, direction, previouslyFocusedRect); } - @Override + @Override + //用于生成上下文菜单 protected void onCreateContextMenu(ContextMenu menu) { + //检查文本 if (getText() instanceof Spanned) { + // 获取选定文本的起始和结束位置 int selStart = getSelectionStart(); int selEnd = getSelectionEnd(); + // 计算选定文本的最小和最大位置 int min = Math.min(selStart, selEnd); int max = Math.max(selStart, selEnd); + // 获取选定文本中的所有 URLSpan final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class); - if (urls.length == 1) { + //如果只有一个URLSpan + if (urls.length == 1) { int defaultResId = 0; + //获取计划表中所有的key值 for(String schema: sSchemaActionResMap.keySet()) { + //若url可以添加则在添加后将defaultResId置为key所映射的值 if(urls[0].getURL().indexOf(schema) >= 0) { defaultResId = sSchemaActionResMap.get(schema); break; @@ -201,7 +251,7 @@ public class NoteEditText extends EditText { if (defaultResId == 0) { defaultResId = R.string.note_link_other; } - + //在菜单中增加选项 menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener( new OnMenuItemClickListener() { public boolean onMenuItemClick(MenuItem item) { @@ -212,6 +262,7 @@ public class NoteEditText extends EditText { }); } } + //执行父类的其他菜单创建事件 super.onCreateContextMenu(menu); } } diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteItemData.java b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteItemData.java index 0f5a878..bcbf223 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteItemData.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteItemData.java @@ -24,7 +24,7 @@ import net.micode.notes.data.Contact; import net.micode.notes.data.Notes; import net.micode.notes.data.Notes.NoteColumns; import net.micode.notes.tool.DataUtils; - +//上面代码导入了一些类 public class NoteItemData { static final String [] PROJECTION = new String [] { @@ -42,6 +42,7 @@ public class NoteItemData { NoteColumns.WIDGET_TYPE, }; + //根据英文翻译理解 private static final int ID_COLUMN = 0; private static final int ALERTED_DATE_COLUMN = 1; private static final int BG_COLOR_ID_COLUMN = 2; @@ -54,7 +55,7 @@ public class NoteItemData { private static final int TYPE_COLUMN = 9; private static final int WIDGET_ID_COLUMN = 10; private static final int WIDGET_TYPE_COLUMN = 11; - + private long mId; private long mAlertDate; private int mBgColorId; @@ -76,7 +77,9 @@ public class NoteItemData { private boolean mIsOneNoteFollowingFolder; private boolean mIsMultiNotesFollowingFolder; + //初始化 public NoteItemData(Context context, Cursor cursor) { + //获取属性值 mId = cursor.getLong(ID_COLUMN); mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN); mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN); @@ -92,10 +95,11 @@ public class NoteItemData { mWidgetId = cursor.getInt(WIDGET_ID_COLUMN); mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN); + //初始化电话号码信息 mPhoneNumber = ""; - if (mParentId == Notes.ID_CALL_RECORD_FOLDER) { + if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {//如果nParentId等于Notes.ID_CALL_RECORD_FOLDER mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId); - if (!TextUtils.isEmpty(mPhoneNumber)) { + if (!TextUtils.isEmpty(mPhoneNumber)) {//mphonenumber里有符合字符串，则用contart功能连接 mName = Contact.getContact(context, mPhoneNumber); if (mName == null) { mName = mPhoneNumber; @@ -106,34 +110,40 @@ public class NoteItemData { if (mName == null) { mName = ""; } + //检查光标位置 checkPostion(cursor); } private void checkPostion(Cursor cursor) { + //检查当前行是否是最后一行是就设置mIsLastItem为true反之为false mIsLastItem = cursor.isLast() ? true : false; + //检查当前行是否是第一行是就设置mIsFirstItem为true反之为false mIsFirstItem = cursor.isFirst() ? true : false; + //检查是否是唯一一行 mIsOnlyOneItem = (cursor.getCount() == 1); mIsMultiNotesFollowingFolder = false; mIsOneNoteFollowingFolder = false; - if (mType == Notes.TYPE_NOTE && !mIsFirstItem) { + if (mType == Notes.TYPE_NOTE && !mIsFirstItem) { //检查当前项是否为note而且不是第一行 + //获取当前行位置赋值给position int position = cursor.getPosition(); - if (cursor.moveToPrevious()) { + if (cursor.moveToPrevious()) { //获取光标位置后看上一行 if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER - || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) { - if (cursor.getCount() > (position + 1)) { + || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {//若光标满足系统或note格式 + if (cursor.getCount() > (position + 1)) {//如果行数大于位置+1则设置为true 表示是否为文件夹或系统类型后面的多行 mIsMultiNotesFollowingFolder = true; - } else { + } else { //否则设置mIsOneNoteFollowingFolder为true 表示当前行是文件夹或系统类型后面的唯一一行 mIsOneNoteFollowingFolder = true; } } - if (!cursor.moveToNext()) { + if (!cursor.moveToNext()) { //如果光标不能移动到下一行，则输出“移回先前位置但移动失败” throw new IllegalStateException("cursor move to previous but can't move back"); } } } } + //获取标记 public boolean isOneFollowingFolder() { return mIsOneNoteFollowingFolder; } @@ -214,6 +224,8 @@ public class NoteItemData { return (mAlertDate > 0); } + //若数据父id为保存至文件夹模式的id且满足电话号码单元不为空 + //则isCallRecord为true public boolean isCallRecord() { return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber)); } diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListActivity.java b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListActivity.java index e843aec..c358dae 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListActivity.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListActivity.java @@ -78,17 +78,20 @@ import java.io.InputStream; import java.io.InputStreamReader; import java.util.HashSet; + +//主界面 public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener { + //文件夹备注列表查询令牌 private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0; - + //文件夹列表查询令牌 private static final int FOLDER_LIST_QUERY_TOKEN = 1; - + //菜单文件夹删除 private static final int MENU_FOLDER_DELETE = 0; - + //菜单文件夹视图 private static final int MENU_FOLDER_VIEW = 1; - + //菜单文件夹更改名称 private static final int MENU_FOLDER_CHANGE_NAME = 2; - + //首选项添加简介 // private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction"; private enum ListEditState { @@ -99,6 +102,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt private BackgroundQueryHandler mBackgroundQueryHandler; + //便签列表适配器 private NotesListAdapter mNotesListAdapter; private ListView mNotesListView; @@ -113,10 +117,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt private TextView mTitleBar; + //当前文件夹id private long mCurrentFolderId; + //内容解析程序 private ContentResolver mContentResolver; + //模式回调 private ModeCallback mModeCallBack; private static final String TAG = "NotesListActivity"; @@ -136,43 +143,64 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt private final static int REQUEST_CODE_NEW_NODE = 103; @Override + //创建类 第一次创建时系统调用此方法 protected void onCreate(Bundle savedInstanceState) { + + //保存的实例状态 super.onCreate(savedInstanceState); + //设置内容视图 setContentView(R.layout.note_list); + //初始化资源 initResources(); /** * Insert an introduction when user firstly use this application */ + + //调用 setAppInfoFromRawRes 方法来插入应用程序介绍 当用户第一次使用此应用程序时 setAppInfoFromRawRes(); } @Override + + // 返回一些子模块完成的数据交给主Activity处理 protected void onActivityResult(int requestCode, int resultCode, Intent data) { - if (resultCode == RESULT_OK + //如果结果代码和结果OK值相等 且（requestCode 满足 请求代码打开节点或请求代码新建节点） + if (resultCode == RESULT_OK && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) { mNotesListAdapter.changeCursor(null); } else { + //否则调用父亲onActivityResult方法 super.onActivityResult(requestCode, resultCode, data); } } + //从原始资源中读取介绍文件并将其内容存储在一个StringBuilder对象中 private void setAppInfoFromRawRes() { + // Android平台给我们提供了一个SharedPreferences类，它是一个轻量级的存储类，特别适合用于保存软件配置参数。 SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this); + //查SharedPreferences对象中是否存在一个名为PREFERENCE_ADD_INTRODUCTION的布尔值。 + //如果该值不存在或为假，则执行以下操作 if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) { + //创建一个名为sb的新的StringBuilder对象 StringBuilder sb = new StringBuilder(); InputStream in = null; try { + //声明一个名为in的输入流变量并初始化为null + //使用getResources().openRawResource(R.raw.introduction)打开原始资源中名为“introduction”的文件 + //并将其存储在输入流变量in中 in = getResources().openRawResource(R.raw.introduction); - if (in != null) { + if (in != null) {//如果in非空 InputStreamReader isr = new InputStreamReader(in); BufferedReader br = new BufferedReader(isr); char [] buf = new char[1024]; int len = 0; + //表示将字符数组buf中从索引0开始， + //长度为len的子数组添加到StringBuilder对象sb的末尾 while ((len = br.read(buf)) > 0) { sb.append(buf, 0, len); } - } else { + } else {//否则使用Log.e方法记录一条错误消息并返回 Log.e(TAG, "Read introduction file error"); return; } @@ -181,6 +209,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt return; } finally { if(in != null) { + //若不为空尝试关闭输入流且捕捉可能发生的IOException异常 try { in.close(); } catch (IOException e) { @@ -190,11 +219,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } + // 创建空的WorkingNote WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER, AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE, ResourceParser.RED); note.setWorkingText(sb.toString()); if (note.saveNote()) { + // 更新保存note的信息 sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit(); } else { Log.e(TAG, "Save introduction note error"); @@ -204,22 +235,33 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } @Override + //先调用父类onStart方法 + //然后调用startAsyncNotesListQuery方法 protected void onStart() { super.onStart(); startAsyncNotesListQuery(); } + private void initResources() { + //获取内容解析器（ContentResolve）的数据，得到类似数据表的东西 mContentResolver = this.getContentResolver(); mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver()); mCurrentFolderId = Notes.ID_ROOT_FOLDER; + + // findViewById 是安卓编程的定位函数，主要是引用.R文件里的引用名 mNotesListView = (ListView) findViewById(R.id.notes_list); mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null), null, false); + + //为ListView设置OnItemClickListener和OnItemLongClickListener监听器 mNotesListView.setOnItemClickListener(new OnListItemClickListener()); mNotesListView.setOnItemLongClickListener(this); + //创建一个新的NotesListAdapter对象并将其存储在名为mNotesListAdapter的变量中 mNotesListAdapter = new NotesListAdapter(this); mNotesListView.setAdapter(mNotesListAdapter); + + //获取布局文件activity中ID为btn_new_note的按钮（Button）对象 mAddNewNote = (Button) findViewById(R.id.btn_new_note); mAddNewNote.setOnClickListener(this); mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener()); @@ -231,11 +273,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt mModeCallBack = new ModeCallback(); } + // 实现了ListView.MultiChoiceModeListener 和 OnMenuItemClickListener接口 private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener { + //包含三个私有变量 private DropdownMenu mDropDownMenu; private ActionMode mActionMode; private MenuItem mMoveMenu; + //创建ActionMode public boolean onCreateActionMode(ActionMode mode, Menu menu) { getMenuInflater().inflate(R.menu.note_list_options, menu); menu.findItem(R.id.delete).setOnMenuItemClickListener(this); @@ -266,16 +311,19 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } }); + //创建成功则返回true return true; } + //更新菜单 private void updateMenu() { int selectedCount = mNotesListAdapter.getSelectedCount(); // Update dropdown menu String format = getResources().getString(R.string.menu_select_title, selectedCount); - mDropDownMenu.setTitle(format); + mDropDownMenu.setTitle(format);//设置标题 MenuItem item = mDropDownMenu.findItem(R.id.action_select_all); - if (item != null) { + if (item != null) { //若项目非空 + //检查列表适配器是否已经选择了所有列表项 if (mNotesListAdapter.isAllSelected()) { item.setChecked(true); item.setTitle(R.string.menu_deselect_all); @@ -302,23 +350,31 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt mAddNewNote.setVisibility(View.VISIBLE); } + //完成操作模式 public void finishActionMode() { mActionMode.finish(); } + //项目状态检查已更改 public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked) { mNotesListAdapter.setCheckedItem(position, checked); + //更新菜单 updateMenu(); } + //菜单项目点击 public boolean onMenuItemClick(MenuItem item) { + //获取已选择的列表项数量 if (mNotesListAdapter.getSelectedCount() == 0) { + //如果等于0则使用Toast.makeText方法显示一条提示消息 + //返回true Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none), Toast.LENGTH_SHORT).show(); return true; } + //检测菜单ID switch (item.getItemId()) { case R.id.delete: AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this); @@ -342,10 +398,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt default: return false; } + //返回true表示已经成功处理了菜单点击事件 return true; } } + + //已有注释 private class NewNoteOnTouchListener implements OnTouchListener { public boolean onTouch(View v, MotionEvent event) { @@ -408,6 +467,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt }; + //启动异步笔记列表查询 private void startAsyncNotesListQuery() { String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION : NORMAL_SELECTION; @@ -417,12 +477,16 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt }, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC"); } + //BackgroundQueryHandler类可能用于执行后台查询操 private final class BackgroundQueryHandler extends AsyncQueryHandler { public BackgroundQueryHandler(ContentResolver contentResolver) { + //调用父类的构造函数 + //后续代码可以使用ContentResolver对象来执行异步查询 super(contentResolver); } @Override + //处理查询结果 protected void onQueryComplete(int token, Object cookie, Cursor cursor) { switch (token) { case FOLDER_NOTE_LIST_QUERY_TOKEN: @@ -441,6 +505,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } + //显示文件夹列表菜单 接受一个Cursor对象 private void showFolderListMenu(Cursor cursor) { AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this); builder.setTitle(R.string.menu_title_select_folder); @@ -462,6 +527,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt builder.show(); } + //创建新的便签 private void createNewNote() { Intent intent = new Intent(this, NoteEditActivity.class); intent.setAction(Intent.ACTION_INSERT_OR_EDIT); @@ -469,12 +535,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE); } + //批量删除 private void batchDelete() { new AsyncTask>() { protected HashSet doInBackground(Void... unused) { HashSet widgets = mNotesListAdapter.getSelectedWidget(); if (!isSyncMode()) { // if not synced, delete notes directly + //如果未同步，直接删除文件夹 if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter .getSelectedItemIds())) { } else { @@ -482,18 +550,22 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } else { // in sync mode, we'll move the deleted note into the trash + // 在同步模式下，我们会将已删除的笔记移入回收站 // folder if (!DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter .getSelectedItemIds(), Notes.ID_TRASH_FOLER)) { Log.e(TAG, "Move notes to trash folder error, should not happens"); } } + //返回小部件 return widgets; } @Override protected void onPostExecute(HashSet widgets) { if (widgets != null) { + //应用程序微件属性 + //遍历这些对象并检查每个对象的 widgetId 和 widgetType 属性 for (AppWidgetAttribute widget : widgets) { if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) { @@ -501,11 +573,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } } + //结束操作模式 mModeCallBack.finishActionMode(); } }.execute(); } + //删除文件夹 private void deleteFolder(long folderId) { if (folderId == Notes.ID_ROOT_FOLDER) { Log.e(TAG, "Wrong folder id, should not happen " + folderId); @@ -518,9 +592,11 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt folderId); if (!isSyncMode()) { // if not synced, delete folder directly + ////如果未同步，直接删除文件夹 DataUtils.batchDeleteNotes(mContentResolver, ids); } else { // in sync mode, we'll move the deleted folder into the trash folder + // 在同步模式下，我们会将已删除的文件夹移动到垃圾箱文件夹中 DataUtils.batchMoveToFolder(mContentResolver, ids, Notes.ID_TRASH_FOLER); } if (widgets != null) { @@ -533,6 +609,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } + //打开结点 private void openNode(NoteItemData data) { Intent intent = new Intent(this, NoteEditActivity.class); intent.setAction(Intent.ACTION_VIEW); @@ -540,25 +617,35 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE); } + //打开菜单 private void openFolder(NoteItemData data) { + //获取当前文件夹id mCurrentFolderId = data.getId(); + //调用异步查询 startAsyncNotesListQuery(); - if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) { + if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//如果是 + //将 mState 设置为 ListEditState.CALL_RECORD_FOLDER + //并将 mAddNewNote 视图设置为不可见 mState = ListEditState.CALL_RECORD_FOLDER; mAddNewNote.setVisibility(View.GONE); - } else { + } else {//否则 + //将 mState 设置为 ListEditState.SUB_FOLDER mState = ListEditState.SUB_FOLDER; } - if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) { + if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//如果等于 + //则将标题栏的文本设置为字符串资源 R.string.call_record_folder_name mTitleBar.setText(R.string.call_record_folder_name); - } else { + } else {//否则获取代码段 mTitleBar.setText(data.getSnippet()); } + //最后，将标题栏设置为可见 mTitleBar.setVisibility(View.VISIBLE); } public void onClick(View v) { switch (v.getId()) { + //如果id等于R.id.btn_new_note + //创建新便签 case R.id.btn_new_note: createNewNote(); break; @@ -567,6 +654,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } + //显示软输入 private void showSoftInput() { InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE); if (inputMethodManager != null) { @@ -574,11 +662,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } } + //隐藏软输入 private void hideSoftInput(View view) { InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE); inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0); } + //显示创建或修改文件夹对话框 private void showCreateOrModifyFolderDialog(final boolean create) { final AlertDialog.Builder builder = new AlertDialog.Builder(this); View view = LayoutInflater.from(this).inflate(R.layout.dialog_edit_text, null); @@ -642,7 +732,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } /** * When the name edit text is null, disable the positive button + 当名称编辑文本为空时，禁用正按钮 */ + + //添加文本更改监听器 etName.addTextChangedListener(new TextWatcher() { public void beforeTextChanged(CharSequence s, int start, int count, int after) { // TODO Auto-generated method stub @@ -651,8 +744,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt public void onTextChanged(CharSequence s, int start, int before, int count) { if (TextUtils.isEmpty(etName.getText())) { + //设置关闭 positive.setEnabled(false); - } else { + } else {//设置启用 positive.setEnabled(true); } } @@ -665,34 +759,47 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } @Override + //按下返回键时调用 + //按返回键时根据情况更改类中的数据 public void onBackPressed() { switch (mState) { - case SUB_FOLDER: + case SUB_FOLDER: //等于SUB_FOLDER + //将 mCurrentFolderId 设置为 Notes.ID_ROOT_FOLDER + //将 mState 设置为 ListEditState.NOTE_LIST + //调用 startAsyncNotesListQuery 方法来启动异步查询 + //并将标题栏设置为不可见 mCurrentFolderId = Notes.ID_ROOT_FOLDER; mState = ListEditState.NOTE_LIST; startAsyncNotesListQuery(); mTitleBar.setVisibility(View.GONE); break; - case CALL_RECORD_FOLDER: + case CALL_RECORD_FOLDER: //等于CALL_RECORD_FOLDER（通话记录文件夹） + //则将 mCurrentFolderId 设置为 Notes.ID_ROOT_FOLDER + //将 mState 设置为 ListEditState.NOTE_LIST + //将 mAddNewNote 视图设置为可见，将标题栏设置为不可见 + //并调用 startAsyncNotesListQuery 方法来启动异步查询 mCurrentFolderId = Notes.ID_ROOT_FOLDER; mState = ListEditState.NOTE_LIST; mAddNewNote.setVisibility(View.VISIBLE); mTitleBar.setVisibility(View.GONE); startAsyncNotesListQuery(); break; - case NOTE_LIST: + case NOTE_LIST: //等于NOTE_LIST，调用父类的 onBackPressed 方法 super.onBackPressed(); break; - default: + default: //否则，不执行任何操作 break; } } + //更新widget private void updateWidget(int appWidgetId, int appWidgetType) { Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); if (appWidgetType == Notes.TYPE_WIDGET_2X) { + //放大两倍 intent.setClass(this, NoteWidgetProvider_2x.class); } else if (appWidgetType == Notes.TYPE_WIDGET_4X) { + //放大四倍 intent.setClass(this, NoteWidgetProvider_4x.class); } else { Log.e(TAG, "Unspported widget type"); @@ -707,6 +814,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt setResult(RESULT_OK, intent); } + + //声明监听器，建立菜单，包括名称，视图，删除操作，更改名称操作 private final OnCreateContextMenuListener mFolderOnCreateContextMenuListener = new OnCreateContextMenuListener() { public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) { if (mFocusNoteDataItem != null) { @@ -719,6 +828,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt }; @Override + //上下文菜单关闭时调用 public void onContextMenuClosed(Menu menu) { if (mNotesListView != null) { mNotesListView.setOnCreateContextMenuListener(null); @@ -727,16 +837,21 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } @Override + //选择某个上下文菜单时被调用 public boolean onContextItemSelected(MenuItem item) { - if (mFocusNoteDataItem == null) { + if (mFocusNoteDataItem == null) { //如果为空输出The long click data item is null"并返回false Log.e(TAG, "The long click data item is null"); return false; } switch (item.getItemId()) { case MENU_FOLDER_VIEW: + //打开文件夹 openFolder(mFocusNoteDataItem); break; case MENU_FOLDER_DELETE: + //如果等于"MENU_FOLDER_DELETE" + //则创建一个警告对话框来提示用户删除文件夹 + //并在用户确认删除后调用 deleteFolder 方法来删除文件夹 AlertDialog.Builder builder = new AlertDialog.Builder(this); builder.setTitle(getString(R.string.alert_title_delete)); builder.setIcon(android.R.drawable.ic_dialog_alert); @@ -748,12 +863,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } }); builder.setNegativeButton(android.R.string.cancel, null); - builder.show(); + builder.show();//显示对话框 break; case MENU_FOLDER_CHANGE_NAME: showCreateOrModifyFolderDialog(false); break; default: + //否则不执行操作 break; } @@ -761,11 +877,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } @Override + //准备选项菜单 public boolean onPrepareOptionsMenu(Menu menu) { menu.clear(); if (mState == ListEditState.NOTE_LIST) { getMenuInflater().inflate(R.menu.note_list, menu); // set sync or sync_cancel + //设置同步或同步取消 menu.findItem(R.id.menu_sync).setTitle( GTaskSyncService.isSyncing() ? R.string.menu_sync_cancel : R.string.menu_sync); } else if (mState == ListEditState.SUB_FOLDER) { @@ -779,6 +897,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } @Override + //所选选项项 public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case R.id.menu_new_folder: { @@ -801,15 +920,15 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } break; } - case R.id.menu_setting: { + case R.id.menu_setting: {//启动首选项活动 startPreferenceActivity(); break; } - case R.id.menu_new_note: { + case R.id.menu_new_note: {//创建新便签 createNewNote(); break; } - case R.id.menu_search: + case R.id.menu_search: //已请求搜索 onSearchRequested(); break; default: @@ -819,11 +938,13 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } @Override + //调用startSearch函数 public boolean onSearchRequested() { startSearch(null, false, null /* appData */, false); return true; } + //实现将便签导出到文本功能 private void exportNoteToText() { final BackupUtils backup = BackupUtils.getInstance(NotesListActivity.this); new AsyncTask() { @@ -866,16 +987,19 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt }.execute(); } + //判断是否正在同步 private boolean isSyncMode() { return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0; } + //跳转到PreferenceActivity界面 private void startPreferenceActivity() { Activity from = getParent() != null ? getParent() : this; Intent intent = new Intent(from, NotesPreferenceActivity.class); from.startActivityIfNeeded(intent, -1); } + //实现对便签列表项的点击事件（短按） private class OnListItemClickListener implements OnItemClickListener { public void onItemClick(AdapterView parent, View view, int position, long id) { @@ -917,6 +1041,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } + //开始查询目标文件夹 private void startQueryDestinationFolders() { String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?"; selection = (mState == ListEditState.NOTE_LIST) ? selection: @@ -935,6 +1060,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt NoteColumns.MODIFIED_DATE + " DESC"); } + // 长按某一项时进行的操作 + // 如果长按的是便签，则通过ActionMode菜单实现；如果长按的是文件夹，则通过ContextMenu菜单实现； public boolean onItemLongClick(AdapterView parent, View view, int position, long id) { if (view instanceof NotesListItem) { mFocusNoteDataItem = ((NotesListItem) view).getItemData(); diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListAdapter.java b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListAdapter.java index 51c9cb9..d580932 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListAdapter.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListAdapter.java @@ -31,56 +31,72 @@ import java.util.HashSet; import java.util.Iterator; +//便签列表适配器 +//实现鼠标和编辑便签链接的桥梁 public class NotesListAdapter extends CursorAdapter { private static final String TAG = "NotesListAdapter"; - private Context mContext; - private HashMap mSelectedIndex; - private int mNotesCount; - private boolean mChoiceMode; + private Context mContext; + private HashMap mSelectedIndex; //所选索引 + private int mNotesCount; //便签数量 + private boolean mChoiceMode; //选择模式 public static class AppWidgetAttribute { public int widgetId; public int widgetType; }; + //初始化NotesListAdapter public NotesListAdapter(Context context) { - super(context, null); - mSelectedIndex = new HashMap(); + super(context, null); //置空父类对象 + mSelectedIndex = new HashMap(); //更新哈希表 mContext = context; mNotesCount = 0; } @Override + //新建视图来保存光标指向内容 public View newView(Context context, Cursor cursor, ViewGroup parent) { + //新建项目选项 return new NotesListItem(context); } @Override + //绑定视图 将视图于光标进行捆绑 public void bindView(View view, Context context, Cursor cursor) { if (view instanceof NotesListItem) { + //检查视图是否为NotesListItem类型 + //是的话则创建一个新的 NoteItemData 对象并使用它来绑定视图 NoteItemData itemData = new NoteItemData(context, cursor); ((NotesListItem) view).bind(context, itemData, mChoiceMode, isSelectedItem(cursor.getPosition())); } } + //设置勾选框 public void setCheckedItem(final int position, final boolean checked) { + //根据position，checked来设置下标 mSelectedIndex.put(position, checked); + //刷新activity notifyDataSetChanged(); } + //判断是否处于选择模式 public boolean isInChoiceMode() { return mChoiceMode; } + //设置选择模式 public void setChoiceMode(boolean mode) { mSelectedIndex.clear(); mChoiceMode = mode; } + //选择全部选项 public void selectAll(boolean checked) { + //获取光标位置 Cursor cursor = getCursor(); for (int i = 0; i < getCount(); i++) { + //遍历所有光标可用的位置在判断为便签类型之后勾选单项框 if (cursor.moveToPosition(i)) { if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) { setCheckedItem(i, checked); @@ -89,14 +105,15 @@ public class NotesListAdapter extends CursorAdapter { } } + //建立选择项的下标列表 public HashSet getSelectedItemIds() { - HashSet itemSet = new HashSet(); - for (Integer position : mSelectedIndex.keySet()) { - if (mSelectedIndex.get(position) == true) { + HashSet itemSet = new HashSet();//哈希表 + for (Integer position : mSelectedIndex.keySet()) {//遍历 mSelectedIndex 变量中的所有位置 + if (mSelectedIndex.get(position) == true) {//如果光标位置为true Long id = getItemId(position); if (id == Notes.ID_ROOT_FOLDER) { Log.d(TAG, "Wrong item id, should not happen"); - } else { + } else {//否则添加到itemSet中 itemSet.add(id); } } @@ -105,19 +122,23 @@ public class NotesListAdapter extends CursorAdapter { return itemSet; } + //建立桌面Widget的选项表 public HashSet getSelectedWidget() { HashSet itemSet = new HashSet(); for (Integer position : mSelectedIndex.keySet()) { if (mSelectedIndex.get(position) == true) { Cursor c = (Cursor) getItem(position); if (c != null) { + //光标非空则建立widget并编辑下标和类型 AppWidgetAttribute widget = new AppWidgetAttribute(); NoteItemData item = new NoteItemData(mContext, c); widget.widgetId = item.getWidgetId(); widget.widgetType = item.getWidgetType(); + //添加到itemSet itemSet.add(widget); /** * Don't close cursor here, only the adapter could close it + * 不要在此处关闭光标，只有适配器可以关闭它 */ } else { Log.e(TAG, "Invalid cursor"); @@ -128,11 +149,14 @@ public class NotesListAdapter extends CursorAdapter { return itemSet; } + //获取选项个数 public int getSelectedCount() { + //获取下标值 Collection values = mSelectedIndex.values(); - if (null == values) { + if (null == values) { //values为空返回0 return 0; } + //初始化 Iterator iter = values.iterator(); int count = 0; while (iter.hasNext()) { @@ -143,12 +167,16 @@ public class NotesListAdapter extends CursorAdapter { return count; } + //判断是否被全部选中 public boolean isAllSelected() { int checkedCount = getSelectedCount(); + //返回比较是否检查数等于便签数且不为0 return (checkedCount != 0 && checkedCount == mNotesCount); } + //判断是否为选项表 public boolean isSelectedItem(final int position) { + //获取的光标位置是否为空 if (null == mSelectedIndex.get(position)) { return false; } @@ -156,17 +184,20 @@ public class NotesListAdapter extends CursorAdapter { } @Override + //在适配器内容发生更改时调用计算便签数量 protected void onContentChanged() { super.onContentChanged(); calcNotesCount(); } @Override + //光标更改时计算便签数量 public void changeCursor(Cursor cursor) { super.changeCursor(cursor); calcNotesCount(); } + //计算便签数量 private void calcNotesCount() { mNotesCount = 0; for (int i = 0; i < getCount(); i++) { diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListItem.java b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListItem.java index 1221e80..477a821 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListItem.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NotesListItem.java @@ -30,17 +30,21 @@ import net.micode.notes.tool.DataUtils; import net.micode.notes.tool.ResourceParser.NoteItemBgResources; +//创建便签列表项目选项 public class NotesListItem extends LinearLayout { - private ImageView mAlert; - private TextView mTitle; - private TextView mTime; - private TextView mCallName; - private NoteItemData mItemData; - private CheckBox mCheckBox; + private ImageView mAlert; //警报 + private TextView mTitle; //标题 + private TextView mTime; //时间 + private TextView mCallName; //呼叫名称 + private NoteItemData mItemData; //数据 + private CheckBox mCheckBox; //✔框 + //初始化 public NotesListItem(Context context) { + //调整调用父类构造函数的顺序 super(context); inflate(context, R.layout.note_item, this); + //findViewById 查找现有试图 mAlert = (ImageView) findViewById(R.id.iv_alert_icon); mTitle = (TextView) findViewById(R.id.tv_title); mTime = (TextView) findViewById(R.id.tv_time); @@ -48,18 +52,23 @@ public class NotesListItem extends LinearLayout { mCheckBox = (CheckBox) findViewById(android.R.id.checkbox); } + //根据data的属性对各个控件的属性的控制，主要是可见性Visibility，内容setText，格式setTextAppearance public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) { if (choiceMode && data.getType() == Notes.TYPE_NOTE) { - mCheckBox.setVisibility(View.VISIBLE); - mCheckBox.setChecked(checked); - } else { + mCheckBox.setVisibility(View.VISIBLE); //设置为可见 + mCheckBox.setChecked(checked); //打勾 + } else {//否则被隐藏 mCheckBox.setVisibility(View.GONE); } + //根据data来设置 mItemData = data; if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) { + //隐藏呼叫名称视图 mCallName.setVisibility(View.GONE); + //显示报警视图 mAlert.setVisibility(View.VISIBLE); + //设置文本外观 mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem); mTitle.setText(context.getString(R.string.call_record_folder_name) + context.getString(R.string.format_folder_files_count, data.getNotesCount())); @@ -70,7 +79,7 @@ public class NotesListItem extends LinearLayout { mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem); mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); if (data.hasAlert()) { - mAlert.setImageResource(R.drawable.clock); + mAlert.setImageResource(R.drawable.clock); mAlert.setVisibility(View.VISIBLE); } else { mAlert.setVisibility(View.GONE); @@ -94,24 +103,29 @@ public class NotesListItem extends LinearLayout { } } } + //设置内容，获取相关时间，从data里编辑的日期中获取 mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate())); setBackground(data); } + //传入data设置背景 private void setBackground(NoteItemData data) { int id = data.getBgColorId(); + //如果是Notes.TYPE_NOTE if (data.getType() == Notes.TYPE_NOTE) { + //如果是单个且只有一个文件夹 if (data.isSingle() || data.isOneFollowingFolder()) { setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id)); - } else if (data.isLast()) { + } else if (data.isLast()) { //如果是最后一个数据 setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id)); - } else if (data.isFirst() || data.isMultiFollowingFolder()) { + } else if (data.isFirst() || data.isMultiFollowingFolder()) { //如果是一个数据且有多个子文件夹 setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id)); } else { setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id)); } } else { + //若非note则获取文件夹背景来源 setBackgroundResource(NoteItemBgResources.getFolderBgRes()); } } 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: diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java b/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java index ec6f819..d96f98a 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java @@ -14,6 +14,13 @@ * limitations under the License. */ +//abcdefgzjhcjrllw +//123456114514 + + + + +// 可以修改 //sadadsa package net.micode.notes.widget; import android.app.PendingIntent; import android.appwidget.AppWidgetManager; @@ -32,6 +39,10 @@ import net.micode.notes.tool.ResourceParser; import net.micode.notes.ui.NoteEditActivity; import net.micode.notes.ui.NotesListActivity; + +//这段代码定义了一个名为NoteWidgetProvider的抽象类，它继承自AppWidgetProvider类。 +//NoteWidgetProvider类定义了一个名为PROJECTION的静态字符串数组，它包含三个元素：NoteColumns.ID、NoteColumns.BG_COLOR_ID和NoteColumns.SNIPPET。 +//这些元素可能用于定义查询数据库时需要返回的列。 public abstract class NoteWidgetProvider extends AppWidgetProvider { public static final String [] PROJECTION = new String [] { NoteColumns.ID, @@ -39,13 +50,17 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { NoteColumns.SNIPPET }; +//这段代码定义了四个静态常量。前三个常量COLUMN_ID、COLUMN_BG_COLOR_ID和COLUMN_SNIPPET分别被赋值为0、1和2。 +//这些常量可能用于定义查询数据库时需要返回的列的索引。 +//第四个常量TAG被赋值为字符串"NoteWidgetProvider"，它可能用于记录日志时标识日志来源。 public static final int COLUMN_ID = 0; public static final int COLUMN_BG_COLOR_ID = 1; public static final int COLUMN_SNIPPET = 2; - + private static final String TAG = "NoteWidgetProvider"; @Override + //删除便签程序小部件 public void onDeleted(Context context, int[] appWidgetIds) { ContentValues values = new ContentValues(); values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); @@ -57,6 +72,7 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { } } + //获取小部件信息 private Cursor getNoteWidgetInfo(Context context, int widgetId) { return context.getContentResolver().query(Notes.CONTENT_NOTE_URI, PROJECTION, @@ -65,21 +81,27 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { null); } + //更新应用程序小部件 protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { update(context, appWidgetManager, appWidgetIds, false); } + //更新 private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds, boolean privacyMode) { + //遍历所有小部件 ID for (int i = 0; i < appWidgetIds.length; i++) { + //若有效 获取默认背景 ID 和一个空字符串作为 snippet if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) { int bgId = ResourceParser.getDefaultBgId(context); String snippet = ""; + //创建一个指向 NoteEditActivity 的意图 Intent intent = new Intent(context, NoteEditActivity.class); intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP); intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]); intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType()); + //查询以获取有关该小部件的信息 Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]); if (c != null && c.moveToFirst()) { if (c.getCount() > 1) { @@ -91,7 +113,7 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { bgId = c.getInt(COLUMN_BG_COLOR_ID); intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID)); intent.setAction(Intent.ACTION_VIEW); - } else { + } else {//它将 snippet 设置为默认文本，并将意图设置为插入或编辑操作 snippet = context.getResources().getString(R.string.widget_havenot_content); intent.setAction(Intent.ACTION_INSERT_OR_EDIT); } @@ -105,6 +127,7 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId); /** * Generate the pending intent to start host for the widget + * 生成为小组件启动主机的挂起意图 */ PendingIntent pendingIntent = null; if (privacyMode) { @@ -124,9 +147,12 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { } } + //获取 Bg 资源标识 protected abstract int getBgResourceId(int bgId); + //获取布局标识 protected abstract int getLayoutId(); + //获取小部件类型 protected abstract int getWidgetType(); } diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_2x.java b/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_2x.java index adcb2f7..8a607d6 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_2x.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_2x.java @@ -27,20 +27,24 @@ import net.micode.notes.tool.ResourceParser; public class NoteWidgetProvider_2x extends NoteWidgetProvider { @Override public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { + // 调用父类的 update 方法 super.update(context, appWidgetManager, appWidgetIds); } @Override protected int getLayoutId() { + //返回布局资源 ID return R.layout.widget_2x; } @Override + // 调用 ResourceParser.WidgetBgResources 类的静态方法 getWidget2xBgResource protected int getBgResourceId(int bgId) { return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId); } @Override + //// 返回小部件类型常量 protected int getWidgetType() { return Notes.TYPE_WIDGET_2X; } diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_4x.java b/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_4x.java index c12a02e..80c6548 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_4x.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider_4x.java @@ -23,6 +23,7 @@ import net.micode.notes.R; import net.micode.notes.data.Notes; import net.micode.notes.tool.ResourceParser; +//同NoteWidgetProvider_2x public class NoteWidgetProvider_4x extends NoteWidgetProvider { @Override