Android6.0 源码修改之 Contacts应用
一、Contacts应用的主界面和联系人详情界面增加顶部菜单添加退出按钮
通过Hierarchy View 工具可以发现
主界面对应的类为 PeopleActivity
联系人详情界面对应的类为 QuickContactActivity
左上角的退出按钮其实很简单，系统actionBar已经帮我们实现了这一功能，只是没有显示出来而已。在onCreate()方法中，在setContentView()方法之后，添加如下代码即可显示返回的箭头
ActionBar mActionBar = getActionBar();
if (mActionBar != null) {
Log.i(TAG, "getSupportActionBar != null....");
mActionBar.setDisplayHomeAsUpEnabled(true);
mActionBar.setHomeButtonEnabled(true);
}
接下来在onOptionsItemSelected()中监听返回按钮的事件即可
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case android.R.id.home: {
finish();
}
return true;
}
....
}
图1 左上角返回退出功能
二、第三方app拉起主界面时直接显示模糊查询对应的联系人列表
简单分析一下，模糊查询需要对应的查询联系人名称，可以通过intent传递参数，这里定义为String类型，当传递参数不为null时，模拟手动点击搜索框对应的逻辑。如下在 PeopleActivity 的 onCreate()方法中增加获取参数的代码
final String queryString = getIntent().getStringExtra("queryString");
if (!TextUtils.isEmpty(queryString)) {
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
showQueryTextFragment(queryString);
}
}, 100);//让搜索逻辑延迟100ms执行
}
通过测试发现，不加延迟触发搜索框对应的逻辑并不会显示模糊查询结果界面。接下来我们分析点击搜索框对应的逻辑代码，找到搜索框对应的控件id，menu_search， 回到刚刚的菜单监听方法 onOptionsItemSelected（）中
@Override
public boolean onOptionsItemSelected(MenuItem item) {
...
switch (item.getItemId()) {
case R.id.menu_search: {
onSearchRequested();
return true;
}
}
...
}
@Override
public boolean onSearchRequested() { // Search key pressed.
Log.d(TAG, "[onSearchRequested]");
//不在搜索模式下，也就是没有点击过搜索框
if (!mActionBarAdapter.isSelectionMode()) {
//获取焦点，弹出键盘
mActionBarAdapter.setSearchMode(true);
}
return true;
}
从上面不难看出最终调用 mActionBarAdapter 的方法，我们接着跟进去
源码位置 packages/apps/Contacts/src/com/android/contacts/activities/ActionBarAdapter.java
public void setSearchMode(boolean flag) {
if (mSearchMode != flag) {
mSearchMode = flag;
update(false /* skipAnimation */);
if (mSearchView == null) {
return;
}
if (mSearchMode) {
mSearchView.setEnabled(true);
setFocusOnSearchView();
} else {
// Disable search view, so that it doesn't keep the IME visible.
mSearchView.setEnabled(false);
}
setQueryString(null);
} else if (flag) {
// Everything is already set up. Still make sure the keyboard is up
//需要注释此处，不然多次调用并退出再次拉起容易出现键盘弹出的情况
//if (mSearchView != null) setFocusOnSearchView();
}
}
public void setFocusOnSearchView() {
//mSearchView获取焦点(先获取焦点才能弹出键盘)
mSearchView.requestFocus();
//弹出键盘
showInputMethod(mSearchView); // Workaround for the "IME not popping up" issue.
}
private void showInputMethod(View view) {
final InputMethodManager imm = (InputMethodManager) mActivity.getSystemService(
Context.INPUT_METHOD_SERVICE);
if (imm != null) {
imm.showSoftInput(view, 0);
}
}
看到这里我们可以猜想到 mSearchView 肯定设置了文字改变监听，继续查找 addTextChangedListener
...
mSearchView.setInputType(EditorInfo.TYPE_CLASS_TEXT
| EditorInfo.TYPE_TEXT_VARIATION_EMAIL_ADDRESS);
mSearchView.addTextChangedListener(new SearchTextWatcher());
...
private class SearchTextWatcher implements TextWatcher {
@Override
public void onTextChanged(CharSequence queryString, int start, int before, int count) {
if (queryString.equals(mQueryString)) {
return;
}
//当前输入的模糊查询的名称
mQueryString = queryString.toString();
if (!mSearchMode) {
if (!TextUtils.isEmpty(queryString)) {
setSearchMode(true);
}
} else if (mListener != null) {
//回调通知 PeopleActivity 改变界面
mListener.onAction(Action.CHANGE_SEARCH_QUERY);
}
mClearSearchView.setVisibility(
TextUtils.isEmpty(queryString) ? View.GONE : View.VISIBLE);
}
@Override
public void afterTextChanged(Editable s) {}
@Override
public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
}
回到 PeopleActivity 中找到监听 Action.CHANGE_SEARCH_QUERY 的代码如下
@Override
public void onAction(int action) {
Log.d(TAG,"[onAction]action = " + action);
/// M: [vcs] @{
if (mVcsController != null) {
mVcsController.onActionVcs(action);
}
/// @}
switch (action) {
...
case ActionBarAdapter.Listener.Action.CHANGE_SEARCH_QUERY:
//获取当前输入的模糊查询姓名
final String queryString = mActionBarAdapter.getQueryString();
//显示对应的fragment
setQueryTextToFragment(queryString);
updateDebugOptionsVisibility(
ENABLE_DEBUG_OPTIONS_HIDDEN_CODE.equals(queryString));
break;
default:
throw new IllegalStateException("Unkonwn ActionBarAdapter action: " + action);
}
}
到此，搜索框模糊查询对应的逻辑就分析完了，那么我们就模拟调用对应的逻辑就ok了，再来把整体流程捋一遍，
点击搜索框->获取焦点->弹出键盘->输入姓名->收到文字内容改变的监听->将输入的内容回调给 PeopleActivity->收到回调显示对应的结果Fragment
好了，通过调用EditText.setText()方法也能触发文字内容改变的监听，前提是要先获取焦点，那么我们的 showQueryTextFragment() 实现如下
private void showQueryTextFragment(String queryString){
Log.d(TAG, "[showQueryTextFragment]");
if (!mActionBarAdapter.isSelectionMode()) {
Log.e(TAG, "[queryString==]"+queryString);
mActionBarAdapter.setSearchMode(true);
mActionBarAdapter.setQueryString(queryString);
}
}
图2 第三方app拉起主界面显示对应的联系人
三、第三方app拉起联系人详情界面只滑动到一半显示的问题
-
图3 拉起只显示一半
图4 拉起完全显示
首先从系统的联系人列表界面点击进入详情界面是能完整显示的，所以猜想应该是传递的参数不太一样。所以还是从onCreate()方法看下来
public class QuickContactActivity extends ContactsActivity {
/**
* QuickContacts immediately takes up the full screen. All possible information is shown.
* This value for {@link android.provider.ContactsContract.QuickContact#EXTRA_MODE}
* should only be used by the Contacts app.
*/
public static final int MODE_FULLY_EXPANDED = 4;
//看上面的注释就知道了肯定是跟这个变量有关系， 立刻显示全屏，应当只用于 联系人 app 使用
@Override
protected void onCreate(Bundle savedInstanceState) {
Trace.beginSection("onCreate()");
super.onCreate(savedInstanceState);
if (RequestPermissionsActivity.startPermissionActivity(this)) {
return;
}
getWindow().setStatusBarColor(Color.TRANSPARENT);
//处理Intent传递的参数
processIntent(getIntent());
.....
//Scroller初始化，传递滚动模式
mScroller.initialize(mMultiShrinkScrollerListener, mExtraMode == MODE_FULLY_EXPANDED);
// mScroller needs to perform asynchronous measurements after initalize(), therefore
// we can't mark this as GONE.
mScroller.setVisibility(View.INVISIBLE);
...
}
private void processIntent(Intent intent) {
...
//获取传递的EXTRA_MODE，不传默认为large，查看api对应的int值为3，MODE_FULLY_EXPANDED为4， 所以不传递参数或者参数对应值不为4就只显示半屏
mExtraMode = getIntent().getIntExtra(QuickContact.EXTRA_MODE, QuickContact.MODE_LARGE);
...
}
}
通过上面的分析 intent需要传递 QuickContact.EXTRA_MODE 参数， 当你点进去 QuickContact中发现并没有对应4的变量(猜想应该是留了一手不让第三方app直接全屏显示)
正确的打开姿势
private void gotoContact(){
Uri personUri = ContentUris.withAppendedId(Contacts.People.CONTENT_URI, 1);
Intent intent = new Intent();
intent.setAction(Intent.ACTION_VIEW);
intent.setData(personUri);
//这句比较关键
intent.putExtra(ContactsContract.QuickContact.EXTRA_MODE, 4);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
startActivity(intent);
}
总结
1、话说当把navigationBar去掉以后，给每个activity添加返回按钮是个很麻烦的工作，可以借鉴一下苹果的思路，直接在屏幕(Window)中添加一个悬浮的按钮处理返回点击事件。具体实现可以看这篇Android6.0 源码修改之 仿IOS添加全屏可拖拽浮窗返回按钮
2、源码没那么可怕，干起来。
