From eb5dacddc443db0752529a69a9c48dab1b129a18 Mon Sep 17 00:00:00 2001 From: Scott Main Date: Mon, 9 Jan 2012 17:36:46 -0800 Subject: [PATCH] docs: add links to Android Design from dev docs Change-Id: Ib2334be0a05d33008d2e4850547ff1c3b7b16764 --- docs/html/design/static/ico_styleguide.png | Bin 0 -> 697 bytes docs/html/guide/guide_toc.cs | 8 +++--- .../practices/ui_guidelines/icon_design.jd | 10 +++++++ .../ui_guidelines/icon_design_action_bar.jd | 6 +++++ .../ui_guidelines/icon_design_dialog.jd | 6 +++++ .../ui_guidelines/icon_design_launcher.jd | 9 +++++++ .../ui_guidelines/icon_design_list.jd | 7 +++++ .../ui_guidelines/icon_design_menu.jd | 7 +++++ .../ui_guidelines/icon_design_status_bar.jd | 7 +++++ .../ui_guidelines/icon_design_tab.jd | 7 +++++ .../guide/practices/ui_guidelines/index.jd | 25 +++++++++++++----- .../practices/ui_guidelines/widget_design.jd | 7 +++++ .../fundamentals/tasks-and-back-stack.jd | 11 +++++++- docs/html/guide/topics/ui/actionbar.jd | 18 ++++++++++++- docs/html/guide/topics/ui/dialogs.jd | 12 +++++++++ .../topics/ui/notifiers/notifications.jd | 14 ++++++++++ 16 files changed, 141 insertions(+), 13 deletions(-) create mode 100644 docs/html/design/static/ico_styleguide.png diff --git a/docs/html/design/static/ico_styleguide.png b/docs/html/design/static/ico_styleguide.png new file mode 100644 index 0000000000000000000000000000000000000000..c12907c8f2a04dab285ab0502ab145bf7bb6ebc8 GIT binary patch literal 697 zcmV;q0!ICbP)rb{o*DyIAMfl&N28NOs)~!YHOycQZM{v1!#^!YF3f-QZ^Q zME5RO?2yzp*XbQLlDDQpI5xe*2DQy~(>CS;&zf6_IJt~zWK1|VXU#3sHs%74YJZnO zH3;cgI#-vB2USL%X6{)_J1bYG$ArKl29~InH4jy-ydkN)zCp!t;~nk2Z2-LfkPH7o zdw;Xeua$N3DCEKR-ZsLq5ssZSFu|lwA%STR>3Hug>f{c|A}BQ^i{SrpYo4sUz(PY3 zL^0Lz)CEy&+-zE%(nE6EAM$CuZ=Lps#sa6+Dg7n6@E;28`tzux?Lql;pTGYue2)}m zvTYd;iPs;pf9Ypp`b9MhXk$ZLjn5i-Mnk0Mf86Iy`o}#4gs$-yM7Rcc fyog*iLcse2i|72WpOvWp00000NkvXXu0mjf6^A!% literal 0 HcmV?d00001 diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs index a9c4d307b7a03..7f3894dd33a28 100644 --- a/docs/html/guide/guide_toc.cs +++ b/docs/html/guide/guide_toc.cs @@ -751,20 +751,20 @@ applications
  • +
    • Launcher Icons - updated
      • +
    • Menu Icons
    • Action Bar Icons - new!
      • +
    • Status Bar Icons - updated
      • +
    • Tab Icons
      • diff --git a/docs/html/guide/practices/ui_guidelines/icon_design.jd b/docs/html/guide/practices/ui_guidelines/icon_design.jd index 07b73bb592516..96aecf5b868b3 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design.jd @@ -57,6 +57,16 @@ Screens + +
      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design, including more guidelines +for Iconography.

      +
      + + +

      Creating a unified look and feel throughout a user interface adds value to your product. Streamlining the graphic style will also make the UI seem more professional to users.

      diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_action_bar.jd b/docs/html/guide/practices/ui_guidelines/icon_design_action_bar.jd index 449c27f4e50aa..2476255b7ecb0 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_action_bar.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_action_bar.jd @@ -29,6 +29,12 @@ Screens +
      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design, including more guidelines +for Iconography.

      +

      Action Bar icons are graphical elements placed in the +

      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design, including more guidelines +for Iconography.

      +

      Dialog icons are shown in pop-up dialog boxes that prompt the user for diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_launcher.jd b/docs/html/guide/practices/ui_guidelines/icon_design_launcher.jd index 3f6061c499e6a..6b686b1ca3432 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_launcher.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_launcher.jd @@ -26,6 +26,15 @@ Screens +

      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design, including more guidelines +for Iconography.

      +
      + + +

      A launcher icon is a graphic that represents your application. Launcher icons are used by Launcher applications and appear on the user’s Home screen. Launcher icons can also be used to represent shortcuts into your application (for example, a contact shortcut icon that opens detail diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_list.jd b/docs/html/guide/practices/ui_guidelines/icon_design_list.jd index 7bf34cc57d388..fd4dc6bdbc7bd 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_list.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_list.jd @@ -28,6 +28,13 @@ Screens +

      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design, including more guidelines +for Iconography.

      +
      +

      List view icons look a lot like dialog icons, but they use an inner shadow effect where the light source is above the object. They are also designed to be diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_menu.jd b/docs/html/guide/practices/ui_guidelines/icon_design_menu.jd index 974e48f7ca392..e267013af6515 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_menu.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_menu.jd @@ -32,6 +32,13 @@ Screens +

      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design, including more guidelines +for Iconography.

      +
      +

      Menu icons are graphical elements placed in the options menu shown to users when they press the Menu button. They are drawn in a flat-front perspective and diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_status_bar.jd b/docs/html/guide/practices/ui_guidelines/icon_design_status_bar.jd index b8e07b5352db2..a20c1ee0a7850 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_status_bar.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_status_bar.jd @@ -40,6 +40,13 @@ Screens +

      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design, including more guidelines +for Iconography.

      +
      +

      Status bar icons are used to represent notifications from your application in the status bar.

      diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_tab.jd b/docs/html/guide/practices/ui_guidelines/icon_design_tab.jd index 271bd858a94dd..f85398d27af0f 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_tab.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_tab.jd @@ -32,6 +32,13 @@ Screens +
      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design, including more guidelines +for Iconography.

      +
      +

      Tab icons are graphical elements used to represent individual tabs in a multi-tab interface. Each tab icon has two states: unselected and selected.

      diff --git a/docs/html/guide/practices/ui_guidelines/index.jd b/docs/html/guide/practices/ui_guidelines/index.jd index 0e42788543119..325527536b65a 100644 --- a/docs/html/guide/practices/ui_guidelines/index.jd +++ b/docs/html/guide/practices/ui_guidelines/index.jd @@ -2,18 +2,28 @@ page.title=User Interface Guidelines @jd:body - + +
      + +

      New Guides for App Designers!

      +

      The Android UX team has put together a set of guidelines for the interaction and +visual design of Android applications. The new collection provides an overview of +Android styles, design patterns, building blocks for exceptional Android designs, and more.

      +

      Android Design

      + +

      Over time, the documents below will be deprecated as more design information is published at +the new location.

      +
      + -

      The Android UI team has begun developing guidelines for the interaction and -visual design of Android applications. Look here for articles that describe -these guidelines as we release them.

      Icon Design Guidelines and Android Icon Templates Pack -» updated
      +»
      Your applications need a wide variety of icons, from a launcher icon to icons in menus, dialogs, tabs, the status bar, and lists. The Icon Guidelines describe each kind of icon in detail, with specifications for the size, color, @@ -22,7 +32,8 @@ The Icon Templates Pack is an archive of Photoshop and Illustrator templates and filters that make it much simpler to create conforming icons.
      -
      Widget Design Guidelines updated
      +
      Widget Design +Guidelines
      A widget displays an application's most important or timely information at a glance, on a user's Home screen. These design guidelines describe how to design widgets that fit with others on the Home screen. They include links to @@ -43,7 +54,7 @@ graphics files and templates that will make your designer's life easier.
      Android applications make use of Option menus and Context menus that enable users to perform operations and navigate to other parts of your application or to other applications. These guidelines describe - the difference between Options and Context menus, how to arrange + the difference between Options anontext menus, how to arrange menu items, when to put commands on-screen, and other details about menu design.
      diff --git a/docs/html/guide/practices/ui_guidelines/widget_design.jd b/docs/html/guide/practices/ui_guidelines/widget_design.jd index f63f3c4a8a763..d7894070e7006 100644 --- a/docs/html/guide/practices/ui_guidelines/widget_design.jd +++ b/docs/html/guide/practices/ui_guidelines/widget_design.jd @@ -44,6 +44,13 @@ parent.link=index.html +
      +

      New Guides for App Designers!

      +

      Check out the new documents for designers at Android Design.

      +
      + +

      App widgets (sometimes just "widgets") are a feature introduced in Android 1.5 and vastly improved in Android 3.0 and 3.1. A widget can display an application's most timely or otherwise relevant information at a glance, on a user's Home screen. The standard Android system image diff --git a/docs/html/guide/topics/fundamentals/tasks-and-back-stack.jd b/docs/html/guide/topics/fundamentals/tasks-and-back-stack.jd index 5a1f7a2885582..086ba71d717fc 100644 --- a/docs/html/guide/topics/fundamentals/tasks-and-back-stack.jd +++ b/docs/html/guide/topics/fundamentals/tasks-and-back-stack.jd @@ -34,7 +34,9 @@ to perform other tasks without losing their work

      See also

        -
      1. Application Lifecycle video
        2. +
      2. Android Design: +Navigation
        3. +
      3. Application Lifecycle video
      4. {@code <activity>} manifest element
        5. @@ -172,6 +174,13 @@ destroyed. The previous activity in the stack is resumed. When an activity is de
    +
    +

    Navigation Design

    +

    For more about how app navigation works on Android, read Android Design's Navigation guide.

    +
    + +

    Saving Activity State

    As discussed above, the system's default behavior preserves the state of an activity when it is diff --git a/docs/html/guide/topics/ui/actionbar.jd b/docs/html/guide/topics/ui/actionbar.jd index 3c0ef26ef5fbf..e4cff177b7365 100644 --- a/docs/html/guide/topics/ui/actionbar.jd +++ b/docs/html/guide/topics/ui/actionbar.jd @@ -73,8 +73,10 @@ href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/app/inde API Demos

    • -

    See also

    item +

    See also

      +
    1. Android Design: Action Bar
    2. Menus
    3. Supporting Tablets and Handsets
      4. @@ -124,6 +126,14 @@ landscape handset), showing the logo on the left, navigation tabs, and an action right (plus the overflow menu button).

      +
      +

      Action Bar Design

      +

      For design guidelines, read Android Design's Action Bar guide.

      +
      + + +

      Remaining backward-compatible

      @@ -536,6 +546,12 @@ the email application, but presses the action bar icon to navigate up, rather th

      Figure 6. Example behavior for UP navigation after entering the Email app from the People app.

      +
      +

      Navigation Design

      +

      For more about how Up and Back navigation differ, read Android Design's Navigation guide.

      +
      +

      To enable the icon for up navigation (which displays the "up" indicator next to the icon), call {@link android.app.ActionBar#setDisplayHomeAsUpEnabled setDisplayHomeAsUpEnabled(true)} on your {@link android.app.ActionBar}:

      diff --git a/docs/html/guide/topics/ui/dialogs.jd b/docs/html/guide/topics/ui/dialogs.jd index 16f14cbc7ae4f..82cbfd161b6b4 100644 --- a/docs/html/guide/topics/ui/dialogs.jd +++ b/docs/html/guide/topics/ui/dialogs.jd @@ -37,6 +37,11 @@ DatePicker
    4. Hello TimePicker
    + +

    See also

    +
      +
    1. Android Design: Dialogs
      2. +
    @@ -70,6 +75,13 @@ of the following subclasses:

    base {@link android.app.Dialog} object or any of the subclasses listed above and define a new layout. See the section on Creating a Custom Dialog below.

    +
    +

    Dialog Design

    +

    For design guidelines, read Android Design's Dialogs guide.

    +
    + +

    Showing a Dialog

    diff --git a/docs/html/guide/topics/ui/notifiers/notifications.jd b/docs/html/guide/topics/ui/notifiers/notifications.jd index 7bc1cde3ff367..71aa2fecd2d8b 100644 --- a/docs/html/guide/topics/ui/notifiers/notifications.jd +++ b/docs/html/guide/topics/ui/notifiers/notifications.jd @@ -33,6 +33,12 @@ user clicks it
  • {@link android.app.Notification}
  • {@link android.app.NotificationManager}
    • + +

    See also

    +
      +
    1. Android +Design: Notifications
      2. +
    @@ -61,6 +67,14 @@ when selected by the user.

    Figure 2. The notifications window.

    +
    +

    Notification Design

    +

    For design guidelines, read Android Design's Notifications guide.

    +
    + + +

    The Basics

    An {@link android.app.Activity} or {@link android.app.Service} can initiate a status bar