FragmentActivity.java revision 3fafb0817f980d1819d0708b3c3da00454ba4c1f
1/* 2 * Copyright (C) 2011 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package android.support.v4.app; 18 19import android.app.Activity; 20import android.content.Context; 21import android.content.Intent; 22import android.content.res.Configuration; 23import android.content.res.Resources; 24import android.content.res.TypedArray; 25import android.os.Bundle; 26import android.os.Handler; 27import android.os.Message; 28import android.os.Parcelable; 29import android.util.AttributeSet; 30import android.util.Log; 31import android.view.KeyEvent; 32import android.view.Menu; 33import android.view.MenuItem; 34import android.view.View; 35import android.view.ViewGroup; 36import android.view.Window; 37 38import java.io.FileDescriptor; 39import java.io.PrintWriter; 40import java.util.ArrayList; 41import java.util.HashMap; 42 43/** 44 * Base class for activities that want to use the support-based 45 * {@link android.support.v4.app.Fragment} and 46 * {@link android.support.v4.content.Loader} APIs. 47 * 48 * <p>When using this class as opposed to new platform's built-in fragment 49 * and loader support, you must use the {@link #getSupportFragmentManager()} 50 * and {@link #getSupportLoaderManager()} methods respectively to access 51 * those features. 52 * 53 * <p class="note"><strong>Note:</strong> If you want to implement an activity that includes 54 * an <a href="{@docRoot}guide/topics/ui/actionbar.html">action bar</a>, you should instead use 55 * the {@link android.support.v7.app.ActionBarActivity} class, which is a subclass of this one, 56 * so allows you to use {@link android.support.v4.app.Fragment} APIs on API level 7 and higher.</p> 57 * 58 * <p>Known limitations:</p> 59 * <ul> 60 * <li> <p>When using the <code><fragment></code> tag, this implementation can not 61 * use the parent view's ID as the new fragment's ID. You must explicitly 62 * specify an ID (or tag) in the <code><fragment></code>.</p> 63 * <li> <p>Prior to Honeycomb (3.0), an activity's state was saved before pausing. 64 * Fragments are a significant amount of new state, and dynamic enough that one 65 * often wants them to change between pausing and stopping. These classes 66 * throw an exception if you try to change the fragment state after it has been 67 * saved, to avoid accidental loss of UI state. However this is too restrictive 68 * prior to Honeycomb, where the state is saved before pausing. To address this, 69 * when running on platforms prior to Honeycomb an exception will not be thrown 70 * if you change fragments between the state save and the activity being stopped. 71 * This means that in some cases if the activity is restored from its last saved 72 * state, this may be a snapshot slightly before what the user last saw.</p> 73 * </ul> 74 */ 75public class FragmentActivity extends Activity { 76 private static final String TAG = "FragmentActivity"; 77 78 static final String FRAGMENTS_TAG = "android:support:fragments"; 79 80 // This is the SDK API version of Honeycomb (3.0). 81 private static final int HONEYCOMB = 11; 82 83 static final int MSG_REALLY_STOPPED = 1; 84 static final int MSG_RESUME_PENDING = 2; 85 86 final Handler mHandler = new Handler() { 87 @Override 88 public void handleMessage(Message msg) { 89 switch (msg.what) { 90 case MSG_REALLY_STOPPED: 91 if (mStopped) { 92 doReallyStop(false); 93 } 94 break; 95 case MSG_RESUME_PENDING: 96 onResumeFragments(); 97 mFragments.execPendingActions(); 98 break; 99 default: 100 super.handleMessage(msg); 101 } 102 } 103 104 }; 105 final FragmentManagerImpl mFragments = new FragmentManagerImpl(); 106 final FragmentContainer mContainer = new FragmentContainer() { 107 @Override 108 public View findViewById(int id) { 109 return FragmentActivity.this.findViewById(id); 110 } 111 }; 112 113 boolean mCreated; 114 boolean mResumed; 115 boolean mStopped; 116 boolean mReallyStopped; 117 boolean mRetaining; 118 119 boolean mOptionsMenuInvalidated; 120 121 boolean mCheckedForLoaderManager; 122 boolean mLoadersStarted; 123 HashMap<String, LoaderManagerImpl> mAllLoaderManagers; 124 LoaderManagerImpl mLoaderManager; 125 126 static final class NonConfigurationInstances { 127 Object activity; 128 Object custom; 129 HashMap<String, Object> children; 130 ArrayList<Fragment> fragments; 131 HashMap<String, LoaderManagerImpl> loaders; 132 } 133 134 static class FragmentTag { 135 public static final int[] Fragment = { 136 0x01010003, 0x010100d0, 0x010100d1 137 }; 138 public static final int Fragment_id = 1; 139 public static final int Fragment_name = 0; 140 public static final int Fragment_tag = 2; 141 } 142 143 // ------------------------------------------------------------------------ 144 // HOOKS INTO ACTIVITY 145 // ------------------------------------------------------------------------ 146 147 /** 148 * Dispatch incoming result to the correct fragment. 149 */ 150 @Override 151 protected void onActivityResult(int requestCode, int resultCode, Intent data) { 152 mFragments.noteStateNotSaved(); 153 int index = requestCode>>16; 154 if (index != 0) { 155 index--; 156 if (mFragments.mActive == null || index < 0 || index >= mFragments.mActive.size()) { 157 Log.w(TAG, "Activity result fragment index out of range: 0x" 158 + Integer.toHexString(requestCode)); 159 return; 160 } 161 Fragment frag = mFragments.mActive.get(index); 162 if (frag == null) { 163 Log.w(TAG, "Activity result no fragment exists for index: 0x" 164 + Integer.toHexString(requestCode)); 165 } else { 166 frag.onActivityResult(requestCode&0xffff, resultCode, data); 167 } 168 return; 169 } 170 171 super.onActivityResult(requestCode, resultCode, data); 172 } 173 174 /** 175 * Take care of popping the fragment back stack or finishing the activity 176 * as appropriate. 177 */ 178 public void onBackPressed() { 179 if (!mFragments.popBackStackImmediate()) { 180 finish(); 181 } 182 } 183 184 /** 185 * Dispatch configuration change to all fragments. 186 */ 187 @Override 188 public void onConfigurationChanged(Configuration newConfig) { 189 super.onConfigurationChanged(newConfig); 190 mFragments.dispatchConfigurationChanged(newConfig); 191 } 192 193 /** 194 * Perform initialization of all fragments and loaders. 195 */ 196 @Override 197 protected void onCreate(Bundle savedInstanceState) { 198 mFragments.attachActivity(this, mContainer, null); 199 // Old versions of the platform didn't do this! 200 if (getLayoutInflater().getFactory() == null) { 201 getLayoutInflater().setFactory(this); 202 } 203 204 super.onCreate(savedInstanceState); 205 206 NonConfigurationInstances nc = (NonConfigurationInstances) 207 getLastNonConfigurationInstance(); 208 if (nc != null) { 209 mAllLoaderManagers = nc.loaders; 210 } 211 if (savedInstanceState != null) { 212 Parcelable p = savedInstanceState.getParcelable(FRAGMENTS_TAG); 213 mFragments.restoreAllState(p, nc != null ? nc.fragments : null); 214 } 215 mFragments.dispatchCreate(); 216 } 217 218 /** 219 * Dispatch to Fragment.onCreateOptionsMenu(). 220 */ 221 @Override 222 public boolean onCreatePanelMenu(int featureId, Menu menu) { 223 if (featureId == Window.FEATURE_OPTIONS_PANEL) { 224 boolean show = super.onCreatePanelMenu(featureId, menu); 225 show |= mFragments.dispatchCreateOptionsMenu(menu, getMenuInflater()); 226 if (android.os.Build.VERSION.SDK_INT >= HONEYCOMB) { 227 return show; 228 } 229 // Prior to Honeycomb, the framework can't invalidate the options 230 // menu, so we must always say we have one in case the app later 231 // invalidates it and needs to have it shown. 232 return true; 233 } 234 return super.onCreatePanelMenu(featureId, menu); 235 } 236 237 /** 238 * Add support for inflating the <fragment> tag. 239 */ 240 @Override 241 public View onCreateView(String name, Context context, AttributeSet attrs) { 242 if (!"fragment".equals(name)) { 243 return super.onCreateView(name, context, attrs); 244 } 245 246 String fname = attrs.getAttributeValue(null, "class"); 247 TypedArray a = context.obtainStyledAttributes(attrs, FragmentTag.Fragment); 248 if (fname == null) { 249 fname = a.getString(FragmentTag.Fragment_name); 250 } 251 int id = a.getResourceId(FragmentTag.Fragment_id, View.NO_ID); 252 String tag = a.getString(FragmentTag.Fragment_tag); 253 a.recycle(); 254 255 if (!Fragment.isSupportFragmentClass(this, fname)) { 256 // Invalid support lib fragment; let the device's framework handle it. 257 // This will allow android.app.Fragments to do the right thing. 258 return super.onCreateView(name, context, attrs); 259 } 260 261 View parent = null; // NOTE: no way to get parent pre-Honeycomb. 262 int containerId = parent != null ? parent.getId() : 0; 263 if (containerId == View.NO_ID && id == View.NO_ID && tag == null) { 264 throw new IllegalArgumentException(attrs.getPositionDescription() 265 + ": Must specify unique android:id, android:tag, or have a parent with an id for " + fname); 266 } 267 268 // If we restored from a previous state, we may already have 269 // instantiated this fragment from the state and should use 270 // that instance instead of making a new one. 271 Fragment fragment = id != View.NO_ID ? mFragments.findFragmentById(id) : null; 272 if (fragment == null && tag != null) { 273 fragment = mFragments.findFragmentByTag(tag); 274 } 275 if (fragment == null && containerId != View.NO_ID) { 276 fragment = mFragments.findFragmentById(containerId); 277 } 278 279 if (FragmentManagerImpl.DEBUG) Log.v(TAG, "onCreateView: id=0x" 280 + Integer.toHexString(id) + " fname=" + fname 281 + " existing=" + fragment); 282 if (fragment == null) { 283 fragment = Fragment.instantiate(this, fname); 284 fragment.mFromLayout = true; 285 fragment.mFragmentId = id != 0 ? id : containerId; 286 fragment.mContainerId = containerId; 287 fragment.mTag = tag; 288 fragment.mInLayout = true; 289 fragment.mFragmentManager = mFragments; 290 fragment.onInflate(this, attrs, fragment.mSavedFragmentState); 291 mFragments.addFragment(fragment, true); 292 293 } else if (fragment.mInLayout) { 294 // A fragment already exists and it is not one we restored from 295 // previous state. 296 throw new IllegalArgumentException(attrs.getPositionDescription() 297 + ": Duplicate id 0x" + Integer.toHexString(id) 298 + ", tag " + tag + ", or parent id 0x" + Integer.toHexString(containerId) 299 + " with another fragment for " + fname); 300 } else { 301 // This fragment was retained from a previous instance; get it 302 // going now. 303 fragment.mInLayout = true; 304 // If this fragment is newly instantiated (either right now, or 305 // from last saved state), then give it the attributes to 306 // initialize itself. 307 if (!fragment.mRetaining) { 308 fragment.onInflate(this, attrs, fragment.mSavedFragmentState); 309 } 310 mFragments.moveToState(fragment); 311 } 312 313 if (fragment.mView == null) { 314 throw new IllegalStateException("Fragment " + fname 315 + " did not create a view."); 316 } 317 if (id != 0) { 318 fragment.mView.setId(id); 319 } 320 if (fragment.mView.getTag() == null) { 321 fragment.mView.setTag(tag); 322 } 323 return fragment.mView; 324 } 325 326 /** 327 * Destroy all fragments and loaders. 328 */ 329 @Override 330 protected void onDestroy() { 331 super.onDestroy(); 332 333 doReallyStop(false); 334 335 mFragments.dispatchDestroy(); 336 if (mLoaderManager != null) { 337 mLoaderManager.doDestroy(); 338 } 339 } 340 341 /** 342 * Take care of calling onBackPressed() for pre-Eclair platforms. 343 */ 344 @Override 345 public boolean onKeyDown(int keyCode, KeyEvent event) { 346 if (android.os.Build.VERSION.SDK_INT < 5 /* ECLAIR */ 347 && keyCode == KeyEvent.KEYCODE_BACK 348 && event.getRepeatCount() == 0) { 349 // Take care of calling this method on earlier versions of 350 // the platform where it doesn't exist. 351 onBackPressed(); 352 return true; 353 } 354 355 return super.onKeyDown(keyCode, event); 356 } 357 358 /** 359 * Dispatch onLowMemory() to all fragments. 360 */ 361 @Override 362 public void onLowMemory() { 363 super.onLowMemory(); 364 mFragments.dispatchLowMemory(); 365 } 366 367 /** 368 * Dispatch context and options menu to fragments. 369 */ 370 @Override 371 public boolean onMenuItemSelected(int featureId, MenuItem item) { 372 if (super.onMenuItemSelected(featureId, item)) { 373 return true; 374 } 375 376 switch (featureId) { 377 case Window.FEATURE_OPTIONS_PANEL: 378 return mFragments.dispatchOptionsItemSelected(item); 379 380 case Window.FEATURE_CONTEXT_MENU: 381 return mFragments.dispatchContextItemSelected(item); 382 383 default: 384 return false; 385 } 386 } 387 388 /** 389 * Call onOptionsMenuClosed() on fragments. 390 */ 391 @Override 392 public void onPanelClosed(int featureId, Menu menu) { 393 switch (featureId) { 394 case Window.FEATURE_OPTIONS_PANEL: 395 mFragments.dispatchOptionsMenuClosed(menu); 396 break; 397 } 398 super.onPanelClosed(featureId, menu); 399 } 400 401 /** 402 * Dispatch onPause() to fragments. 403 */ 404 @Override 405 protected void onPause() { 406 super.onPause(); 407 mResumed = false; 408 if (mHandler.hasMessages(MSG_RESUME_PENDING)) { 409 mHandler.removeMessages(MSG_RESUME_PENDING); 410 onResumeFragments(); 411 } 412 mFragments.dispatchPause(); 413 } 414 415 /** 416 * Handle onNewIntent() to inform the fragment manager that the 417 * state is not saved. If you are handling new intents and may be 418 * making changes to the fragment state, you want to be sure to call 419 * through to the super-class here first. Otherwise, if your state 420 * is saved but the activity is not stopped, you could get an 421 * onNewIntent() call which happens before onResume() and trying to 422 * perform fragment operations at that point will throw IllegalStateException 423 * because the fragment manager thinks the state is still saved. 424 */ 425 @Override 426 protected void onNewIntent(Intent intent) { 427 super.onNewIntent(intent); 428 mFragments.noteStateNotSaved(); 429 } 430 431 /** 432 * Dispatch onResume() to fragments. Note that for better inter-operation 433 * with older versions of the platform, at the point of this call the 434 * fragments attached to the activity are <em>not</em> resumed. This means 435 * that in some cases the previous state may still be saved, not allowing 436 * fragment transactions that modify the state. To correctly interact 437 * with fragments in their proper state, you should instead override 438 * {@link #onResumeFragments()}. 439 */ 440 @Override 441 protected void onResume() { 442 super.onResume(); 443 mHandler.sendEmptyMessage(MSG_RESUME_PENDING); 444 mResumed = true; 445 mFragments.execPendingActions(); 446 } 447 448 /** 449 * Dispatch onResume() to fragments. 450 */ 451 @Override 452 protected void onPostResume() { 453 super.onPostResume(); 454 mHandler.removeMessages(MSG_RESUME_PENDING); 455 onResumeFragments(); 456 mFragments.execPendingActions(); 457 } 458 459 /** 460 * This is the fragment-orientated version of {@link #onResume()} that you 461 * can override to perform operations in the Activity at the same point 462 * where its fragments are resumed. Be sure to always call through to 463 * the super-class. 464 */ 465 protected void onResumeFragments() { 466 mFragments.dispatchResume(); 467 } 468 469 /** 470 * Dispatch onPrepareOptionsMenu() to fragments. 471 */ 472 @Override 473 public boolean onPreparePanel(int featureId, View view, Menu menu) { 474 if (featureId == Window.FEATURE_OPTIONS_PANEL && menu != null) { 475 if (mOptionsMenuInvalidated) { 476 mOptionsMenuInvalidated = false; 477 menu.clear(); 478 onCreatePanelMenu(featureId, menu); 479 } 480 boolean goforit = onPrepareOptionsPanel(view, menu); 481 goforit |= mFragments.dispatchPrepareOptionsMenu(menu); 482 return goforit; 483 } 484 return super.onPreparePanel(featureId, view, menu); 485 } 486 487 /** 488 * @hide 489 */ 490 protected boolean onPrepareOptionsPanel(View view, Menu menu) { 491 return super.onPreparePanel(Window.FEATURE_OPTIONS_PANEL, view, menu); 492 } 493 494 /** 495 * Retain all appropriate fragment and loader state. You can NOT 496 * override this yourself! Use {@link #onRetainCustomNonConfigurationInstance()} 497 * if you want to retain your own state. 498 */ 499 @Override 500 public final Object onRetainNonConfigurationInstance() { 501 if (mStopped) { 502 doReallyStop(true); 503 } 504 505 Object custom = onRetainCustomNonConfigurationInstance(); 506 507 ArrayList<Fragment> fragments = mFragments.retainNonConfig(); 508 boolean retainLoaders = false; 509 if (mAllLoaderManagers != null) { 510 // prune out any loader managers that were already stopped and so 511 // have nothing useful to retain. 512 LoaderManagerImpl loaders[] = new LoaderManagerImpl[mAllLoaderManagers.size()]; 513 mAllLoaderManagers.values().toArray(loaders); 514 if (loaders != null) { 515 for (int i=0; i<loaders.length; i++) { 516 LoaderManagerImpl lm = loaders[i]; 517 if (lm.mRetaining) { 518 retainLoaders = true; 519 } else { 520 lm.doDestroy(); 521 mAllLoaderManagers.remove(lm.mWho); 522 } 523 } 524 } 525 } 526 if (fragments == null && !retainLoaders && custom == null) { 527 return null; 528 } 529 530 NonConfigurationInstances nci = new NonConfigurationInstances(); 531 nci.activity = null; 532 nci.custom = custom; 533 nci.children = null; 534 nci.fragments = fragments; 535 nci.loaders = mAllLoaderManagers; 536 return nci; 537 } 538 539 /** 540 * Save all appropriate fragment state. 541 */ 542 @Override 543 protected void onSaveInstanceState(Bundle outState) { 544 super.onSaveInstanceState(outState); 545 Parcelable p = mFragments.saveAllState(); 546 if (p != null) { 547 outState.putParcelable(FRAGMENTS_TAG, p); 548 } 549 } 550 551 /** 552 * Dispatch onStart() to all fragments. Ensure any created loaders are 553 * now started. 554 */ 555 @Override 556 protected void onStart() { 557 super.onStart(); 558 559 mStopped = false; 560 mReallyStopped = false; 561 mHandler.removeMessages(MSG_REALLY_STOPPED); 562 563 if (!mCreated) { 564 mCreated = true; 565 mFragments.dispatchActivityCreated(); 566 } 567 568 mFragments.noteStateNotSaved(); 569 mFragments.execPendingActions(); 570 571 if (!mLoadersStarted) { 572 mLoadersStarted = true; 573 if (mLoaderManager != null) { 574 mLoaderManager.doStart(); 575 } else if (!mCheckedForLoaderManager) { 576 mLoaderManager = getLoaderManager(null, mLoadersStarted, false); 577 // the returned loader manager may be a new one, so we have to start it 578 if ((mLoaderManager != null) && (!mLoaderManager.mStarted)) { 579 mLoaderManager.doStart(); 580 } 581 } 582 mCheckedForLoaderManager = true; 583 } 584 // NOTE: HC onStart goes here. 585 586 mFragments.dispatchStart(); 587 if (mAllLoaderManagers != null) { 588 LoaderManagerImpl loaders[] = new LoaderManagerImpl[mAllLoaderManagers.size()]; 589 mAllLoaderManagers.values().toArray(loaders); 590 if (loaders != null) { 591 for (int i=0; i<loaders.length; i++) { 592 LoaderManagerImpl lm = loaders[i]; 593 lm.finishRetain(); 594 lm.doReportStart(); 595 } 596 } 597 } 598 } 599 600 /** 601 * Dispatch onStop() to all fragments. Ensure all loaders are stopped. 602 */ 603 @Override 604 protected void onStop() { 605 super.onStop(); 606 607 mStopped = true; 608 mHandler.sendEmptyMessage(MSG_REALLY_STOPPED); 609 610 mFragments.dispatchStop(); 611 } 612 613 // ------------------------------------------------------------------------ 614 // NEW METHODS 615 // ------------------------------------------------------------------------ 616 617 /** 618 * Use this instead of {@link #onRetainNonConfigurationInstance()}. 619 * Retrieve later with {@link #getLastCustomNonConfigurationInstance()}. 620 */ 621 public Object onRetainCustomNonConfigurationInstance() { 622 return null; 623 } 624 625 /** 626 * Return the value previously returned from 627 * {@link #onRetainCustomNonConfigurationInstance()}. 628 */ 629 public Object getLastCustomNonConfigurationInstance() { 630 NonConfigurationInstances nc = (NonConfigurationInstances) 631 getLastNonConfigurationInstance(); 632 return nc != null ? nc.custom : null; 633 } 634 635 /** 636 * Support library version of {@link Activity#invalidateOptionsMenu}. 637 * 638 * <p>Invalidate the activity's options menu. This will cause relevant presentations 639 * of the menu to fully update via calls to onCreateOptionsMenu and 640 * onPrepareOptionsMenu the next time the menu is requested. 641 */ 642 public void supportInvalidateOptionsMenu() { 643 if (android.os.Build.VERSION.SDK_INT >= HONEYCOMB) { 644 // If we are running on HC or greater, we can use the framework 645 // API to invalidate the options menu. 646 ActivityCompatHoneycomb.invalidateOptionsMenu(this); 647 return; 648 } 649 650 // Whoops, older platform... we'll use a hack, to manually rebuild 651 // the options menu the next time it is prepared. 652 mOptionsMenuInvalidated = true; 653 } 654 655 /** 656 * Print the Activity's state into the given stream. This gets invoked if 657 * you run "adb shell dumpsys activity <activity_component_name>". 658 * 659 * @param prefix Desired prefix to prepend at each line of output. 660 * @param fd The raw file descriptor that the dump is being sent to. 661 * @param writer The PrintWriter to which you should dump your state. This will be 662 * closed for you after you return. 663 * @param args additional arguments to the dump request. 664 */ 665 public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) { 666 if (android.os.Build.VERSION.SDK_INT >= HONEYCOMB) { 667 // XXX This can only work if we can call the super-class impl. :/ 668 //ActivityCompatHoneycomb.dump(this, prefix, fd, writer, args); 669 } 670 writer.print(prefix); writer.print("Local FragmentActivity "); 671 writer.print(Integer.toHexString(System.identityHashCode(this))); 672 writer.println(" State:"); 673 String innerPrefix = prefix + " "; 674 writer.print(innerPrefix); writer.print("mCreated="); 675 writer.print(mCreated); writer.print("mResumed="); 676 writer.print(mResumed); writer.print(" mStopped="); 677 writer.print(mStopped); writer.print(" mReallyStopped="); 678 writer.println(mReallyStopped); 679 writer.print(innerPrefix); writer.print("mLoadersStarted="); 680 writer.println(mLoadersStarted); 681 if (mLoaderManager != null) { 682 writer.print(prefix); writer.print("Loader Manager "); 683 writer.print(Integer.toHexString(System.identityHashCode(mLoaderManager))); 684 writer.println(":"); 685 mLoaderManager.dump(prefix + " ", fd, writer, args); 686 } 687 mFragments.dump(prefix, fd, writer, args); 688 writer.print(prefix); writer.println("View Hierarchy:"); 689 dumpViewHierarchy(prefix + " ", writer, getWindow().getDecorView()); 690 } 691 692 private static String viewToString(View view) { 693 StringBuilder out = new StringBuilder(128); 694 out.append(view.getClass().getName()); 695 out.append('{'); 696 out.append(Integer.toHexString(System.identityHashCode(view))); 697 out.append(' '); 698 switch (view.getVisibility()) { 699 case View.VISIBLE: out.append('V'); break; 700 case View.INVISIBLE: out.append('I'); break; 701 case View.GONE: out.append('G'); break; 702 default: out.append('.'); break; 703 } 704 out.append(view.isFocusable() ? 'F' : '.'); 705 out.append(view.isEnabled() ? 'E' : '.'); 706 out.append(view.willNotDraw() ? '.' : 'D'); 707 out.append(view.isHorizontalScrollBarEnabled()? 'H' : '.'); 708 out.append(view.isVerticalScrollBarEnabled() ? 'V' : '.'); 709 out.append(view.isClickable() ? 'C' : '.'); 710 out.append(view.isLongClickable() ? 'L' : '.'); 711 out.append(' '); 712 out.append(view.isFocused() ? 'F' : '.'); 713 out.append(view.isSelected() ? 'S' : '.'); 714 out.append(view.isPressed() ? 'P' : '.'); 715 out.append(' '); 716 out.append(view.getLeft()); 717 out.append(','); 718 out.append(view.getTop()); 719 out.append('-'); 720 out.append(view.getRight()); 721 out.append(','); 722 out.append(view.getBottom()); 723 final int id = view.getId(); 724 if (id != View.NO_ID) { 725 out.append(" #"); 726 out.append(Integer.toHexString(id)); 727 final Resources r = view.getResources(); 728 if (id != 0 && r != null) { 729 try { 730 String pkgname; 731 switch (id&0xff000000) { 732 case 0x7f000000: 733 pkgname="app"; 734 break; 735 case 0x01000000: 736 pkgname="android"; 737 break; 738 default: 739 pkgname = r.getResourcePackageName(id); 740 break; 741 } 742 String typename = r.getResourceTypeName(id); 743 String entryname = r.getResourceEntryName(id); 744 out.append(" "); 745 out.append(pkgname); 746 out.append(":"); 747 out.append(typename); 748 out.append("/"); 749 out.append(entryname); 750 } catch (Resources.NotFoundException e) { 751 } 752 } 753 } 754 out.append("}"); 755 return out.toString(); 756 } 757 758 private void dumpViewHierarchy(String prefix, PrintWriter writer, View view) { 759 writer.print(prefix); 760 if (view == null) { 761 writer.println("null"); 762 return; 763 } 764 writer.println(viewToString(view)); 765 if (!(view instanceof ViewGroup)) { 766 return; 767 } 768 ViewGroup grp = (ViewGroup)view; 769 final int N = grp.getChildCount(); 770 if (N <= 0) { 771 return; 772 } 773 prefix = prefix + " "; 774 for (int i=0; i<N; i++) { 775 dumpViewHierarchy(prefix, writer, grp.getChildAt(i)); 776 } 777 } 778 779 void doReallyStop(boolean retaining) { 780 if (!mReallyStopped) { 781 mReallyStopped = true; 782 mRetaining = retaining; 783 mHandler.removeMessages(MSG_REALLY_STOPPED); 784 onReallyStop(); 785 } 786 } 787 788 /** 789 * Pre-HC, we didn't have a way to determine whether an activity was 790 * being stopped for a config change or not until we saw 791 * onRetainNonConfigurationInstance() called after onStop(). However 792 * we need to know this, to know whether to retain fragments. This will 793 * tell us what we need to know. 794 */ 795 void onReallyStop() { 796 if (mLoadersStarted) { 797 mLoadersStarted = false; 798 if (mLoaderManager != null) { 799 if (!mRetaining) { 800 mLoaderManager.doStop(); 801 } else { 802 mLoaderManager.doRetain(); 803 } 804 } 805 } 806 807 mFragments.dispatchReallyStop(); 808 } 809 810 // ------------------------------------------------------------------------ 811 // FRAGMENT SUPPORT 812 // ------------------------------------------------------------------------ 813 814 /** 815 * Called when a fragment is attached to the activity. 816 */ 817 public void onAttachFragment(Fragment fragment) { 818 } 819 820 /** 821 * Return the FragmentManager for interacting with fragments associated 822 * with this activity. 823 */ 824 public FragmentManager getSupportFragmentManager() { 825 return mFragments; 826 } 827 828 /** 829 * Modifies the standard behavior to allow results to be delivered to fragments. 830 * This imposes a restriction that requestCode be <= 0xffff. 831 */ 832 @Override 833 public void startActivityForResult(Intent intent, int requestCode) { 834 if (requestCode != -1 && (requestCode&0xffff0000) != 0) { 835 throw new IllegalArgumentException("Can only use lower 16 bits for requestCode"); 836 } 837 super.startActivityForResult(intent, requestCode); 838 } 839 840 /** 841 * Called by Fragment.startActivityForResult() to implement its behavior. 842 */ 843 public void startActivityFromFragment(Fragment fragment, Intent intent, 844 int requestCode) { 845 if (requestCode == -1) { 846 super.startActivityForResult(intent, -1); 847 return; 848 } 849 if ((requestCode&0xffff0000) != 0) { 850 throw new IllegalArgumentException("Can only use lower 16 bits for requestCode"); 851 } 852 super.startActivityForResult(intent, ((fragment.mIndex+1)<<16) + (requestCode&0xffff)); 853 } 854 855 void invalidateSupportFragment(String who) { 856 //Log.v(TAG, "invalidateSupportFragment: who=" + who); 857 if (mAllLoaderManagers != null) { 858 LoaderManagerImpl lm = mAllLoaderManagers.get(who); 859 if (lm != null && !lm.mRetaining) { 860 lm.doDestroy(); 861 mAllLoaderManagers.remove(who); 862 } 863 } 864 } 865 866 // ------------------------------------------------------------------------ 867 // LOADER SUPPORT 868 // ------------------------------------------------------------------------ 869 870 /** 871 * Return the LoaderManager for this fragment, creating it if needed. 872 */ 873 public LoaderManager getSupportLoaderManager() { 874 if (mLoaderManager != null) { 875 return mLoaderManager; 876 } 877 mCheckedForLoaderManager = true; 878 mLoaderManager = getLoaderManager(null, mLoadersStarted, true); 879 return mLoaderManager; 880 } 881 882 LoaderManagerImpl getLoaderManager(String who, boolean started, boolean create) { 883 if (mAllLoaderManagers == null) { 884 mAllLoaderManagers = new HashMap<String, LoaderManagerImpl>(); 885 } 886 LoaderManagerImpl lm = mAllLoaderManagers.get(who); 887 if (lm == null) { 888 if (create) { 889 lm = new LoaderManagerImpl(who, this, started); 890 mAllLoaderManagers.put(who, lm); 891 } 892 } else { 893 lm.updateActivity(this); 894 } 895 return lm; 896 } 897} 898