diff options
| author | 2019-10-16 10:27:29 -0700 | |
|---|---|---|
| committer | 2019-10-23 15:19:56 -0700 | |
| commit | 7fe953e729ef95b9b4bf2790a7b22916e406857b (patch) | |
| tree | b7b567a8fe0153ece8d0bd86475c566d3fd85dc2 | |
| parent | c669e81af53145903809ed8eabb841b5a6945b60 (diff) | |
Adjust reportFullyDrawn documentation
Since Q, this API affects how the application is optimized.
Bug: 117575269
Test: manual
Change-Id: I0a448b8a59df4544775739505e50e401b43ba965
| -rw-r--r-- | core/java/android/app/Activity.java | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/core/java/android/app/Activity.java b/core/java/android/app/Activity.java index 2c57622a4df8..9872e306eb9f 100644 --- a/core/java/android/app/Activity.java +++ b/core/java/android/app/Activity.java @@ -2563,9 +2563,12 @@ public class Activity extends ContextThemeWrapper } /** - * Report to the system that your app is now fully drawn, purely for diagnostic - * purposes (calling it does not impact the visible behavior of the activity). - * This is only used to help instrument application launch times, so that the + * Report to the system that your app is now fully drawn, for diagnostic and + * optimization purposes. The system may adjust optimizations to prioritize + * work that happens before reportFullyDrawn is called, to improve app startup. + * Misrepresenting the startup window by calling reportFullyDrawn too late or too + * early may decrease application and startup performance.<p> + * This is also used to help instrument application launch times, so that the * app can report when it is fully in a usable state; without this, the only thing * the system itself can determine is the point at which the activity's window * is <em>first</em> drawn and displayed. To participate in app launch time |