Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 0d0c4b68 authored by Dirk Dougherty's avatar Dirk Dougherty
Browse files

Doc change: add note about not exiting on onPause().

Change-Id: Iaa5199133b34431b84622bc13579d41131a14390
parent 2b856100
Loading
Loading
Loading
Loading
+3 −0
Original line number Diff line number Diff line
@@ -166,8 +166,11 @@ href="#2DPicker">2D picker</a> is always available.</p>
  <li>A map that asks the user to drop a pin should exit when the pin is dropped.</li>
  <li>A short game can exit when the game finishes.</li>
  <li>A drawing app can finish after 5 seconds of inactivity.</li>

  <p class="note">An app generally should not exit in {@link android.app.Activity#onPause onPause()}.  This is because events such as <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html#Heads-up">Heads-up Notifications</a> can trigger the {@link android.app.Activity#onPause() onPause()} callback.</p>
</ul>


<h3>Manually exiting</h3>

<p>Even with logical exit points like these, some cases may exist where the user may want to