am e8143c25: am 31ed07d3: am 97c0c444: am 4ec5140b: Merge "docs: Update the...

- from: /shareables/training/BitmapFun.zip

  to: /downloads/samples/DisplayingBitmaps.zip

- from: /shareables/auto/AndroidAuto-audio-apps.pdf

  to: http://google.com/design/spec-auto/audio-apps/design-principles.html

- from: /shareables/auto/AndroidAuto-messaging-apps.pdf

  to: http://google.com/design/spec-auto/messaging-apps/voice-based-messaging.html

- from: /shareables/auto/AndroidAuto-custom-colors.pdf

  to: http://google.com/design/spec-auto/colors-branding/color-themes.html

- from: /shareables/...

  to: http://commondatastorage.googleapis.com/androiddevelopers/shareables/...

  to: /training/building-wearables.html

# ---------- DISTRIBUTE ------------------

- from /distribute/tools/promote/badge-files.html

- from: /distribute/tools/promote/badge-files.html

  to: /distribute/tools/promote/badges.html

  <h2><strong>UI Guidelines</strong></h2>

  <ul>

  <li><a href="{@docRoot}shareables/auto/AndroidAuto-audio-apps.pdf">

    <strong>Auto Audio Apps (PDF)</strong></a>

    <strong>Auto Audio Apps</strong></a>

  </li>

  <li><a href="{@docRoot}shareables/auto/AndroidAuto-messaging-apps.pdf">

    <strong>Auto Messaging Apps (PDF)</strong></a>

    <strong>Auto Messaging Apps</strong></a>

  </li>

  <li><a href="{@docRoot}shareables/auto/AndroidAuto-custom-colors.pdf">

    <strong>Auto Color Customization (PDF)</strong></a>

    <strong>Auto Color Customization</strong></a>

  </li>

 </ul>

</div>

  simple, predictable patterns for common tasks.

</p>

<p>

  It's important that you test your auto app for the criteria listed on this page prior to

  submitting to Google Play for review. There are two ways to test your app:

</p>

<ol>

  <li> Use the Android Auto simulator to validate each checklist item. The simulator allows you to

  sideload your app for testing. For more information on the simulator, see

  <a href="{@docRoot}training/auto/start/index.html#test-it">Run and Test Auto Apps</a>.</li>

  <li>Test your app in a vehicle by uploading your app to the alpha/beta channel on Google Play.

  Apps will not work on Auto in vehicles unless they are installed from the Play Store.

  For more information, see <a

  href="{@docRoot}distribute/googleplay/developer-console.html#alpha-beta">Alpha and Beta Testing</a>.

  </li>

</ol>

<p class="caution">

  <strong>Important:</strong> The criteria listed in this page apply to your app's user interface

  and behavior when running on devices connected to an Android Auto screen. Apps must meet these

  criteria to qualify as an Android Auto app on Google Play.

</p>

<div class="headerLine">

  <h2 id="core">

  Core App Quality

  </td>

  <td>

    <p style="margin-bottom:.5em;">

      App does not display on the Auto screen animated elements such as animated graphics, games, video, or

      progress bars.

      App does not display on the Auto screen animated elements such as animated graphics,

      video, or progress bars.

    </p>

  </td>

</tr>

  </td>

  <td>

    <p style="margin-bottom:.5em;">

    App does not include any features that distract the driver.

    App does not include games or other features outside of the intended app types supported

    by Auto.

    (<a href="{@docRoot}training/auto/start/index.html">Learn How</a>)

    </p>

  </td>

</tr>

  </td>

  <td>

    <p style="margin-bottom:.5em;">

    App never presents any form of visual information (notifications, toasts, video, images,

    advertising, etc.) on the phone screen while the app is active in Android Auto.

    App never activates the phone screen to present any form of visual information (notifications,

    toasts, video, images, advertising, etc.) on the phone screen while the app is active in Android

    Auto.

    </p>

  </td>

</tr>

<tr>

  <td rowspan="3" id="layout">

  <td rowspan="1" id="layout">

    Layout

  </td>

  </td>

</tr>

<tr>

  <td id="AU-FT">

    AU-FT

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     App displays all strings using the default Roboto fonts in two approved sizes.

    </p>

  </td>

</tr>

<tr>

  <td id="AU-ST">

    AU-ST

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     App does not display any individual string longer than 120 characters.

    </p>

  </td>

</tr>

<tr>

  <td rowspan="4" id="contrast">

    Visual Contrast

  <td>

    <p style="margin-bottom:.5em;">

     App supports day mode, which renders dark text and controls on a light background.

     (<a href="{@docRoot}shareables/auto/AndroidAuto-custom-colors.pdf">Learn How</a>)

     (<a href="//google.com/design/spec-auto/colors-branding/day-night-colors.html">Learn How</a>)

    </p>

  </td>

</tr>

  <td>

    <p style="margin-bottom:.5em;">

     App supports night mode, which renders light text and controls on a dark background.

     (<a href="{@docRoot}shareables/auto/AndroidAuto-custom-colors.pdf">Learn How</a>)

     (<a href="//google.com/design/spec-auto/colors-branding/day-night-colors.html">Learn How</a>)

    </p>

  </td>

</tr>

    <p style="margin-bottom:.5em;">

     App provides white icon sets that the system colorizes to provide automatic

     contrast compensation.

     (<a href="{@docRoot}shareables/auto/AndroidAuto-custom-colors.pdf">Learn How</a>)

     (<a href="//google.com/design/spec-auto/colors-branding/color-themes.html">Learn How</a>)

    </p>

  </td>

</tr>

  <td>

    <p style="margin-bottom:.5em;">

     App provides colors that the system can optimize for easy in-vehicle readability.

     (<a href="{@docRoot}shareables/auto/AndroidAuto-custom-colors.pdf">Learn How</a>)

     (<a href="//google.com/design/spec-auto/colors-branding/color-themes.html">Learn How</a>)

    </p>

  </td>

</tr>

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     App must support voice commands.

     App must support voice commands in audio apps.

     (<a href="{@docRoot}training/auto/audio/index.html#support_voice">Learn How</a>)

    </p>

  </td>

</tr>

</tr>

<tr>

  <td rowspan="5" id="general">

  <td rowspan="6" id="general">

   General

  </td>

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     App loads in no more than 10 seconds.

     App launches in no more than 10 seconds.

    </p>

  </td>

</tr>

<tr>

  <td id="AU-LC">

    AU-LC

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     App loads content in no more than 10 seconds.

    </p>

  </td>

</tr>

  <td>

    <p style="margin-bottom:.5em;">

     No tasks in the app take more than six steps to complete.

     (<a href="//google.com/design/spec-auto/system-overview/drawer.html#drawer-drawer-content-patterns">Learn How</a>)

    </p>

  </td>

</tr>

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     Any app button which is non-functional or disabled must be grayed out.

     Interactive elements that are intentionally grayed-out must be non-functional.

    </p>

  </td>

</tr>

<tr>

  <td rowspan="2" id="media">

  <td rowspan="1" id="media">

    Media

  </td>

  <td id="AU-PA">

    AU-PA

  <td id="AU-MT">

    AU-MT

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     App has no more than four primary actions plus one optional action overflow toggle (or five if

     no action overflow is used).

     (<a href="{@docRoot}shareables/auto/AndroidAuto-audio-apps.pdf">Learn How</a>)

     Media apps do not autoplay or take over media focus when launched.

     (<a href="{@docRoot}training/auto/audio/index.html#playback-commands">Learn How</a>)

    </p>

  </td>

</tr>

<tr>

  <td id="AU-SA">

    AU-SA

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     App has no more than four optional secondary actions plus one action overflow toggle.

     (<a href="{@docRoot}shareables/auto/AndroidAuto-audio-apps.pdf">Learn How</a>)

    </p>

  </td>

</tr>

<tr>

  <td rowspan="2" id="notifications">

    Notifications

  </td>

</tr>

<tr>

  <td rowspan="5" id="messages">

    Messaging

  </td>

  <td id="AU-MI">

    AU-MI

  </td>

  <td>

    <p style="margin-bottom:.5em;">

      App is able to successfully receive incoming messages.

      (<a href="{@docRoot}training/auto/messaging/index.html">Learn How</a>)

    </p>

  </td>

</tr>

<tr>

  <td id="AU-MG">

    AU-MG

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     Messages are properly grouped and displayed in the correct order.

     (<a href="{@docRoot}training/auto/messaging/index.html#build_conversation">Learn How</a>)

   </p>

  </td>

</tr>

<tr>

  <td id="AU-MR">

    AU-MR

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     User is able to successfully reply to a message.

     (<a href="{@docRoot}training/auto/messaging/index.html">Learn How</a>)

   </p>

  </td>

</tr>

<tr>

  <td id="AU-MS">

    AU-MS

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     Apps use short-form messaging app design patterns. Traditional long-form messaging apps, such

     as apps for email, are not permitted.

   </p>

  </td>

</tr>

<tr>

  <td id="AU-MP">

    AU-MP

  </td>

  <td>

    <p style="margin-bottom:.5em;">

     Apps are peer-to-peer messaging services and not notification service apps such as weather,

     stocks, and sport scores apps.

   </p>

  </td>

</tr>

</table>

<!--

</div>

<p style="margin-top:30px;">

  <strong>After I submit my app, how will find out if my app does not meet all

  <strong>After submitting my app, how will I find out if my app does not meet all

    the requirements for Android Auto?</strong>

</p>

<p>If you are planning to develop apps for Auto, you are encouraged to begin enabling and testing

  your apps now. However, Auto-enabled apps cannot be published at this time. Join the

 <a href="http://g.co/AndroidAutoDev" class="external-link">Auto

 Developers Google+ community</a> for updates on when you will be able to submit

 your Auto-enabled apps.</p>

<p>

  If your app does not meet the usability requirements described on this page, the Play Store team

  will contact you through the email address specified in the <a href=

  "https://play.google.com/apps/publish/">Google Play Developer Console</a> account associated with

  the app.

</p>

<p class="note">

 <strong>Note:</strong> For information about how to publish your Auto app in Google Play, see <a

 href="{@docRoot}distribute/googleplay/auto.html">Distributing to Android Auto</a>.

</p>

  tablets?</strong>

</p>

<p>

  No. When Google begins the approval process, your auto app will undergo a driver safety

  No. When Google begins the approval process, your Auto app will undergo a driver safety

  review, and will not be

  available for distribution until the app is approved. Because this is the same APK as

  for phones and tablets, your Play Store updates for those devices will not be available until the

  Auto approval process is complete.

  Auto app approval process is complete.

</p>

<p class="caution">

{@link android.media.session.MediaSession.Callback#onPause onPause()}, your

app should resume playback.</dd>

<p class="note">

  <strong>Note:</strong> Google Play requires your app not to play music immediately when it

  launches. For more information on this and other requirements, see

<a href="{@docRoot}distribute/essentials/quality/auto.html">Auto App Quality</a>.

</p>

<dt>{@link android.media.session.MediaSession.Callback#onPlayFromMediaId

onPlayFromMediaId()}</dt>

<dd>Invoked when the user chooses to play a specific item. The method is passed

<p>

  Staying connected through messages is important to many drivers. Chat apps can let users

  know if a child need to be picked up, or if a dinner location has been changed. Apps that provide

  sports information might tell the user who just won the big game, and let the user ask questions

  about other games being played. The Android framework enables messaging apps to extend their

  know if a child need to be picked up, or if a dinner location has been changed.

  The Android framework enables messaging apps to extend their

  services into car dashboards using a standard user interface that lets drivers keep their eyes

  on the road.

</p>

<p>

  Messaging apps do not run directly on the Android dashboard hardware. They are installed on

  separate, Android mobile device. When the mobile device is plugged into a dashboard,

  a separate Android mobile device. When the mobile device is plugged into a dashboard,

  the installed messaging apps can offer services for viewing and responding to messages

  through the Auto user interface.

</p>

    has read or replied to a message.

</ul>

<h3 id="#concepts">Concepts and Objects</h3>

<h3 id="concepts">Concepts and objects</h3>

<p>Before you start designing your app, it's helpful to understand how Auto

handles messaging.</p>

<p>Each individual chunk of communication is a <em>message</em>. A message is a

short length of text, suitable for the Auto device to read aloud. In a chat app,

this might be a single message from one person to another: <code>"Fitzy -- Jane

can't come to the ball, her youngest has the croup. :-( --Liz"</code> In a

sports app, a message might be a single bit of news about a game: <code>"Granger

scores for Harpies at 7 minutes in."</code></p>

can't come to the ball, her youngest has the croup. :-( --Liz"</code>.</p>

<p>A <em>conversation</em> is a group of messages that are all grouped together

in some way. Auto uses the conversation information to group the messages

together when presenting them to the user. In a chat app, a conversation might

be all the messages between the user and another person (for example, all

the messages back and forth between Darcy and Elizabeth). In a sports app, a

conversation might be all the messages about a particular game. Every message

the messages back and forth between Darcy and Elizabeth). Every message

belongs to a conversation, even if it's the only message in that conversation.

Each conversation has a <em>conversation name</em>.

The conversation name is used by Android Auto to

present the messages; it's up to your app to choose an appropriate conversation

name. In a chat app, the conversation name is usually the person your user is

talking to.

In a sports app, this might be the name of the teams playing in the game.</p>

talking to.</p>

<p>The v4 support library defines an {@link

android.support.v4.app.NotificationCompat.CarExtender.UnreadConversation

<li>If the user sends a reply, Auto triggers the app's "message reply" intent and

attaches a transcript of the user's response.  The app can take appropriate

action, based on the app's logic. For example, a chat app might interpret the

reply as a message to go to the other conversation participants, while a sports

app might try to interpret the "reply" as a request for other information

("What's the score in the Sharks game?").</li>

reply as a message to go to the other conversation participants.</li>

</ol>