diff options
Diffstat (limited to 'docs/html/guide')
| -rw-r--r-- | docs/html/guide/appendix/api-levels.jd | 1 | ||||
| -rw-r--r-- | docs/html/guide/developing/tools/emulator.jd | 2 | ||||
| -rw-r--r-- | docs/html/guide/guide_toc.cs | 4 | ||||
| -rw-r--r-- | docs/html/guide/practices/screens_support.jd | 31 | ||||
| -rw-r--r-- | docs/html/guide/practices/ui_guidelines/icon_design.jd | 12 | ||||
| -rw-r--r-- | docs/html/guide/practices/ui_guidelines/icon_design_1.jd | 16 |
6 files changed, 37 insertions, 29 deletions
diff --git a/docs/html/guide/appendix/api-levels.jd b/docs/html/guide/appendix/api-levels.jd index 398d863..c5112f6 100644 --- a/docs/html/guide/appendix/api-levels.jd +++ b/docs/html/guide/appendix/api-levels.jd @@ -83,6 +83,7 @@ Android platform.</p> <table> <tr><th>Platform Version</th><th>API Level</th></tr> + <tr><td>Android 2.2</td><td>8</td></tr> <tr><td>Android 2.1</td><td>7</td></tr> <tr><td>Android 2.0.1</td><td>6</td></tr> <tr><td>Android 2.0</td><td>5</td></tr> diff --git a/docs/html/guide/developing/tools/emulator.jd b/docs/html/guide/developing/tools/emulator.jd index dbfc8ef..6363ab2 100644 --- a/docs/html/guide/developing/tools/emulator.jd +++ b/docs/html/guide/developing/tools/emulator.jd @@ -7,7 +7,7 @@ page.title=Android Emulator that runs on your computer. The emulator lets you prototype, develop, and test Android applications without using a physical device. </p> -<p>The Android emulator all of the hardware and software features +<p>The Android emulator mimics all of the hardware and software features of a typical mobile device, except that it can not receive or place actual phone calls. It provides a variety of navigation and control keys, which you can "press" using your mouse or keyboard to generate events for your application. It also diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs index e542cd4..3d356ae 100644 --- a/docs/html/guide/guide_toc.cs +++ b/docs/html/guide/guide_toc.cs @@ -110,7 +110,7 @@ <li class="toggle-list"> <div><a href="<?cs var:toroot ?>guide/topics/resources/index.html"> <span class="en">Application Resources</span> - </a></div> + </a> <span class="new">new!</span></div> <ul> <li><a href="<?cs var:toroot ?>guide/topics/resources/providing-resources.html"> <span class="en">Providing Resources</span> @@ -127,7 +127,7 @@ <li class="toggle-list"> <div><a href="<?cs var:toroot ?>guide/topics/resources/available-resources.html"> <span class="en">Resource Types</span> - </a></div> + </a> <span class="new">new!</span></div> <ul> <li><a href="<?cs var:toroot ?>guide/topics/resources/animation-resource.html">Animation</a></li> <li><a href="<?cs var:toroot ?>guide/topics/resources/color-list-resource.html">Color State List</a></li> diff --git a/docs/html/guide/practices/screens_support.jd b/docs/html/guide/practices/screens_support.jd index 5e61e6c..1e254f0 100644 --- a/docs/html/guide/practices/screens_support.jd +++ b/docs/html/guide/practices/screens_support.jd @@ -169,8 +169,12 @@ device screen. At run time, the platform handles the loading of the correct size or density resources, based on the generalized size or density of the current device screen, and adapts them to the actual pixel map of the screen.</p> -<p>The range of screens supported by Android and the generalized screen -configurations that the platform maps them to are shown in the table below. </p> +<p>The table below lists some of the more common screens supported +by Android and illustrates how the platform maps them to generalized screen +configurations.</p> + +<p class="table-caption" id="screens-table"><strong>Table 1.</strong> Examples of +device screens supported by Android.</p> <table id="screens-table" width="80%" style="margin-top:2em;"> <tbody> @@ -236,15 +240,13 @@ configurations that the platform maps them to are shown in the table below. </p> </tbody> </table> -<p class="caption" style="margin-top:1em;margin-bottom:1.5em;"><strong>Table -1.</strong> Summary of device screens supported by Android. </p> +<p class="caption" style="margin-top:1em;margin-bottom:1.5em;"> </p> <p>As shown above, the various screen configurations are arranged around a -baseline screen — HVGA (320x480) resolution on a 3.2" screen — which -is assigned a size of "normal" and a density of "medium". The HVGA screen is -used as the baseline because all applications written against Android 1.5 or -earlier are (by definition) written for the HVGA screen used on the T-Mobile G1 -and similar devices.</p> +<em>baseline screen</em> that is assigned a size of "normal" and a density of +"medium". The HVGA screen is used as the baseline because all applications +written against Android 1.5 or earlier are (by definition) written for the HVGA +screen used on the T-Mobile G1 and similar devices.</p> <!-- <p>Note that each screen configuration spans a range of actual resolutions and physical screen sizes. For example, the The baseline configuration spans a @@ -267,6 +269,11 @@ rendering your application on the current device screen, provided that the UI is properly implemented. For more information, see <a href="#screen-independence">Best Practices for Screen Independence</a>.</p> +<!-- +<p>For an overview of the relative numbers of high (hdpi), medium (mdpi), and +low (ldpi) density screens, see the <a +href="{@docRoot}guide/resources/dashboard/screen-densities.html">Screen Densities dashboard</a>.</p> +--> <h3 id="support">How Android supports multiple screens</h3> @@ -401,7 +408,7 @@ including those written against Android 1.5 and earlier platform versions, can display properly on most devices, especially when the device's screen is at the baseline "normal" size or larger. </p> -<p>However, note that applications written for the baseline HVGA screen may need +<p>However, note that applications written for the baseline screen may need minor adjustments before they display properly on smaller screens such as QVGA. With the reduced screen area of small screens, there may be tradeoffs in design, content, and function that you, as the application developer, need to consider. @@ -557,7 +564,7 @@ support:</p> <li>If you declare <code>largeScreens="false"</code>, your application can still be installed by users of devices with large screens. When run on a device with a large screen, this attribute value causes the platform to run the -application in compatibility mode, rendering it in a baseline HVGA screen area +application in compatibility mode, rendering it in a baseline screen area (normal size, medium density) reserved on the larger screen. See <a href="#compatibility-examples">Screen-Compatibility Examples</a> for an illustration of what an application looks like when displayed in compatibility @@ -803,7 +810,7 @@ that you use in your code. The sections below provide more information. </p> <p>In some cases, you will need to express dimensions in <code>dip</code> and then convert them to pixels. Imagine an application in which a scroll gesture is recognized after the user's finger has moved by at least 16 pixels. On a -baseline HVGA screen, the user will have to move his finger by 16 pixels / 160 +baseline screen, the user will have to move his finger by 16 pixels / 160 dpi = 1/10th of an inch (or 2.5 mm) before the gesture is recognized. On a device with a high (240) density display, the user will move his finger by only 16 pixels / 240 dpi = 1/15th of an inch (or 1.7 mm.) The distance is much diff --git a/docs/html/guide/practices/ui_guidelines/icon_design.jd b/docs/html/guide/practices/ui_guidelines/icon_design.jd index 3f00b5c..51ccfaf 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design.jd @@ -681,7 +681,7 @@ effects, which are shown below, are used to create depth.</p> <table style="margin:0px;padding:0px;"> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/menu_palette_white.png" alt="Color palette, white" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">White<br>r 0 | g 0 | b 0<br>Used for outer glow and bevel highlight.</td> +<td class="image-caption-c" style="padding-top:.5em;">White<br>r 255 | g 255 | b 255<br>Used for outer glow and bevel highlight.</td> </tr> <tr> @@ -691,7 +691,7 @@ effects, which are shown below, are used to create depth.</p> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/menu_palette_black.png" alt="Color palette, black" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 255 | g 255 | b 255<br>Used for inner shadow and bevel shadow.</td> +<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 0 | g 0 | b 0<br>Used for inner shadow and bevel shadow.</td> </tr> </table> @@ -809,22 +809,22 @@ light, effects, and shadows for status bar icons."/> <table style="margin:0px;padding:0px;"> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_white.png" alt="Color palette, white" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">White<br>r 0 | g 0 | b 0<br>Used for details within the icons and bevel highlight.</td> +<td class="image-caption-c" style="padding-top:.5em;">White<br>r 255 | g 255 | b 255<br>Used for details within the icons and bevel highlight.</td> </tr> <tr> -<td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_fill.png" alt="Color palette, grey gradient" style="margin:.5em 0 0 0;" /></td> +<td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_grey.png" alt="Color palette, grey gradient" style="margin:.5em 0 0 0;" /></td> <td class="image-caption-c" style="padding-top:.5em;">Grey gradient<br><em>1: </em>r 169 | g 169 | b 169<br><em>2: </em>r 126 | g 126 | b 126<br>Used for disabled details within the icon.</td> </tr> <tr> -<td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_grey.png" alt="Color palette, fill gradient" style="margin:.5em 0 0 0;" /></td> +<td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_fill.png" alt="Color palette, fill gradient" style="margin:.5em 0 0 0;" /></td> <td class="image-caption-c" style="padding-top:.5em;">Fill gradient<br><em>1: </em>1 r 105 | g 105 | b 105<br><em>2: </em>r 10 | g 10 | b 10<br>Used as color fill.</td> </tr> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_black.png" alt="Color palette, black" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 255 | g 255 | b 255<br>Used for bevel shadow.</td> +<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 0 | g 0 | b 0<br>Used for bevel shadow.</td> </tr> </table> diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_1.jd b/docs/html/guide/practices/ui_guidelines/icon_design_1.jd index 039f301..1c75843 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_1.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_1.jd @@ -169,7 +169,7 @@ light, effects, and shadows for launcher icons."/> <table style="margin:0px;padding:0px;"> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/launcher_palette_white.png" alt="Color palette, white" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">White<br>r 0 | g 0 | b 0<br>Used for highlights on edges.</td> +<td class="image-caption-c" style="padding-top:.5em;">White<br>r 255 | g 255 | b 255<br>Used for highlights on edges.</td> </tr> <tr> @@ -189,7 +189,7 @@ light, effects, and shadows for launcher icons."/> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/launcher_palette_black.png" alt="Color palette, black" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 255 | g 255 | b 255<br>Used as base color in shadows.</td> +<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 0 | g 0 | b 0<br>Used as base color in shadows.</td> </tr> </table> @@ -300,7 +300,7 @@ effects, which are shown below, are used to create depth.</p> <table style="margin:0px;padding:0px;"> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/menu_palette_white.png" alt="Color palette, white" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">White<br>r 0 | g 0 | b 0<br>Used for outer glow and bevel highlight.</td> +<td class="image-caption-c" style="padding-top:.5em;">White<br>r 255 | g 255 | b 255<br>Used for outer glow and bevel highlight.</td> </tr> <tr> @@ -310,7 +310,7 @@ effects, which are shown below, are used to create depth.</p> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/menu_palette_black.png" alt="Color palette, black" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 255 | g 255 | b 255<br>Used for inner shadow and bevel shadow.</td> +<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 0 | g 0 | b 0<br>Used for inner shadow and bevel shadow.</td> </tr> </table> @@ -412,22 +412,22 @@ light, effects, and shadows for launcher icons."/> <table style="margin:0px;padding:0px;"> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_white.png" alt="Color palette, white" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">White<br>r 0 | g 0 | b 0<br>Used for details within the icons and bevel highlight.</td> +<td class="image-caption-c" style="padding-top:.5em;">White<br>r 255 | g 255 | b 255<br>Used for details within the icons and bevel highlight.</td> </tr> <tr> -<td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_fill.png" alt="Color palette, grey gradient" style="margin:.5em 0 0 0;" /></td> +<td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_grey.png" alt="Color palette, grey gradient" style="margin:.5em 0 0 0;" /></td> <td class="image-caption-c" style="padding-top:.5em;">Grey gradient<br><em>1: </em>r 169 | g 169 | b 169<br><em>2: </em>r 126 | g 126 | b 126<br>Used for disabled details within the icon.</td> </tr> <tr> -<td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_grey.png" alt="Color palette, fill gradient" style="margin:.5em 0 0 0;" /></td> +<td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_fill.png" alt="Color palette, fill gradient" style="margin:.5em 0 0 0;" /></td> <td class="image-caption-c" style="padding-top:.5em;">Fill gradient<br><em>1: </em>1 r 105 | g 105 | b 105<br><em>2: </em>r 10 | g 10 | b 10<br>Used as color fill.</td> </tr> <tr> <td class="image-caption-i"><img src="{@docRoot}images/icon_design/statusbar_palette_black.png" alt="Color palette, black" style="margin:.5em 0 0 0;" /></td> -<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 255 | g 255 | b 255<br>Used for bevel shadow.</td> +<td class="image-caption-c" style="padding-top:.5em;">Black<br>r 0 | g 0 | b 0<br>Used for bevel shadow.</td> </tr> </table> |