Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

am 5a4d6696: Merge change Ib80db923 into eclair-sdk

Browse Source 
Merge commit '5a4d66965d3c5061d47201fcaa62c90d126e7187' into eclair

* commit '5a4d66965d3c5061d47201fcaa62c90d126e7187':
  doc change: some fixes for online sdk docs. update "testing" section of screens support doc.
This commit is contained in:
Dirk Dougherty
2009-10-28 11:39:55 -07:00
committed by Android Git Automerger
parent fb872d1af3 5a4d66965d
commit 340fbc36fb
11 changed files with 89 additions and 66 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/html/guide/appendix/api-levels.jd
View File

@@ -324,22 +324,24 @@ control to show documentation only for parts of the API that are actually
accessible to your application, based on the API Level that it specifies in accessible to your application, based on the API Level that it specifies in
the <code>android:minSdkVersion</code> attribute of its manifest file. </p> the <code>android:minSdkVersion</code> attribute of its manifest file. </p>
<p>To use filtering, set the control to the same API Level as that specified <p>To use filtering, select the checkbox to enable filtering, just below the
by your application. Notice that APIs introduced in a later API Level are page search box. Then set the "Filter by API Level" control to the same API
then grayed out and their content is masked, since they would not be Level as specified by your application. Notice that APIs introduced in a later
accessible to your application. </p> API Level are then grayed out and their content is masked, since they would not
be accessible to your application. </p>
<p>Filtering by API Level in the documentation does not provide a view <p>Filtering by API Level in the documentation does not provide a view
of what is new or introduced in each API Level &mdash; it simply provides a way of what is new or introduced in each API Level &mdash; it simply provides a way
to view the entire API associated with a given API Level, while excluding API to view the entire API associated with a given API Level, while excluding API
elements introduced in later API Levels.</p> elements introduced in later API Levels.</p>
<p>By default, API Level filtering is enabled and set to show the latest API <p>If you decide that you don't want to filter the API documentation, just
Level. If you do not want to use filtering reference documentation, disable the feature using the checkbox. By default, API Level filtering is
simply select the highest available API Level. </p> disabled, so that you can view the full framework API, regardless of API Level.
</p>
<p>Also note that the reference documentation for individual API elements <p>Also note that the reference documentation for individual API elements
specifies the API Level at which the elements were introduced. The API Level specifies the API Level at which each element was introduced. The API Level
for packages and classes is specified as "Since &lt;api level&gt;" at the for packages and classes is specified as "Since &lt;api level&gt;" at the
top-right corner of the content area on each documentation page. The API Level top-right corner of the content area on each documentation page. The API Level
for class members is specified in their detailed description headers, for class members is specified in their detailed description headers,

96
docs/html/guide/practices/screens_support.jd
View File

@@ -1069,28 +1069,29 @@ not. Once you've tested your application and found that it displays properly on
various screen sizes, you should make sure to add the corresponding size various screen sizes, you should make sure to add the corresponding size
attribute(s) to your application's manifest. --> attribute(s) to your application's manifest. -->
<div id="f9.5" style="float:right;margin:0;padding:0;">
<img src="{@docRoot}images/screens_support/avds-config.png" style="padding:0;margin:0;">
<p class="caption" style="margin:0 0 1.5em 1em;padding:0 0 0 1em;"><strong>Figure 3.</strong>
A typical set of AVDs for testing screens support.</p>
</div>
<p>As a test environment for your applications, set up a series of AVDs that <p>As a test environment for your applications, set up a series of AVDs that
emulate the screen sizes and densities you want to support. The Android SDK emulate the screen sizes and densities you want to support. The Android SDK
includes four emulator skins to get you started. You can use the Android AVD includes six emulator skins to get you started. You can use the Android AVD
Manager or the <code>android</code> tool to create AVDs that use the various Manager or the <code>android</code> tool to create AVDs that use the various
emulator skins and you can also set up custom AVDs to test densities other than emulator skins and you can also set up custom AVDs to test densities other than
the defaults. For general information about working with AVDs, see the defaults. For general information about working with AVDs, see
<a href="{@docRoot}guide/developing/tools/avd.html">Android Virtual <a href="{@docRoot}guide/developing/tools/avd.html">Android Virtual
Devices</a>.</p> Devices</a>.</p>
<p>The Android 1.6 and higher platforms in the SDK include these emulator skins, <p>The Android SDK provides a set of default emulator skins that you can use for
which represent the primary screen configurations that your should test:</p> testing. The skins are included as part of each Android platform that you can
install in your SDK. The Android 1.6 platform offers these default skins:</p>
<ul> <ul>
<li> <li>
QVGA (240x320, low density, small screen) QVGA (240x320, low density, small screen)
</li> </li>
<li>
WQVGA400 (240x400, low density, normal screen)
</li>
<li>
WQVGA432 (240x432, low density, normal screen)
</li>
<li> <li>
HVGA (320x480, medium density, normal screen) HVGA (320x480, medium density, normal screen)
</li> </li>
@@ -1102,6 +1103,18 @@ which represent the primary screen configurations that your should test:</p>
</li> </li>
</ul> </ul>
<p>The Android 2.0 platform offers all of the Android 1.6 default skins,
above, plus:</p>
<ul>
<li>
WQVGA400 (240x400, low density, normal screen)
</li>
<li>
WQVGA432 (240x432, low density, normal screen)
</li>
</ul>
<p>If you are using the <code>android</code> tool command line to create your <p>If you are using the <code>android</code> tool command line to create your
AVDs, here's an example of how to specify the skin you want to use:</p> AVDs, here's an example of how to specify the skin you want to use:</p>
@@ -1130,6 +1143,12 @@ monitor. Using the default densities, the emulator skins included in the Android
<li> <li>
QVGA, low density: 3.3" QVGA, low density: 3.3"
</li> </li>
<li>
WQVGA, low density: 3.9"
</li>
<li>
WQVGA432, low density: 4.1"
</li>
<li> <li>
HVGA, medium density: 3.6" HVGA, medium density: 3.6"
</li> </li>
@@ -1141,6 +1160,12 @@ monitor. Using the default densities, the emulator skins included in the Android
</li> </li>
</ul> </ul>
<div style="float: right;background-color:#fff;margin: 0;padding: 20px 0 20px 20px;width:520px;">
<img src="{@docRoot}images/screens_support/avd-density.png" style="padding:0;margin:0;">
<p class="caption" style="margin:0 0 1.5em 1em;padding:0 0 0 1em; width:280px;"><strong>Figure 4.</strong>
Resolution and density options that you can use, when creating an AVD using the AVD Manager.</p>
</div>
<p>You should also make sure to test your application on different physical <p>You should also make sure to test your application on different physical
screen sizes within a single size-density configuration. For example, according screen sizes within a single size-density configuration. For example, according
to <a href="#range">Table 1</a>, the minimum supported diagonal of QVGA is 2.8". to <a href="#range">Table 1</a>, the minimum supported diagonal of QVGA is 2.8".
@@ -1150,21 +1175,35 @@ To display this is on a 30" monitor you will need to adjust the value passed to
<pre>emulator -avd &lt;name&gt; -scale 0.6</pre> <pre>emulator -avd &lt;name&gt; -scale 0.6</pre>
<p>If you would like to test your application on a screen not supported by the <p>If you would like to test your application on a screen that uses a resolution
built-in skins, you can either adjust an existing skin, or create a custom or density not supported by the built-in skins, you can either adjust an
resolution.</p> existing skin, or create an AVD
that uses a custom resolution or density.</p>
<p>For example, to test on a large WVGA800 screen with medium density:</p> <p>In the AVD Manager, you can specify a custom skin resolution or density in
the Create New AVD dialog, as shown in Figure 4, at right.</p>
<p>In the <code>android</code> tool, follow these steps to create an AVD with a
custom resolution or density:</p>
<ol> <ol>
<li>Create an AVD based on the WVGA800 skin (using the <code>android</code> <li>Use the <code>create avd</code> command to create a new AVD, specifying
tool's command line.)<br></li> the <code>--skin</code> option with a value that references either a default
<li>Answer "yes" when asked about using custom hardware</li> skin name (such as "WVGA800") or a custom skin resolution (such as 240x432).
<li>enter "160" when asked about the value for <em>hw.lcd.density</em> Here's an example:
(120-low, 160-medium, 240-high).</li> <pre>android create avd -n &lt;name&gt; -t &lt;targetID&gt; --skin WVGA800</pre>
</li>
<li>To specify a custom density for the skin, answer "yes" when asked whether
you want to create a custom hardware profile for the new AVD.</li>
<li>Continue through the various profile settings until the tool asks you to
specify "Abstracted LCD density" (<em>hw.lcd.density</em>). Consult <a
href="#range">Table 1</a>, earlier in this document, and enter the appropriate
value. For example, enter "160" to use medium density for the WVGA800 screen.</li>
<li>Set any other hardware options and complete the AVD creation.</li>
</ol> </ol>
<p>When running this AVD, the emulator will emulate a 5.8" WVGA screen.</p> <p>In the example above (WVGA medium density), the new AVD will emulate a 5.8"
WVGA screen.</p>
<p>As an alternative to adjusting the emulator skin configuration, you can use <p>As an alternative to adjusting the emulator skin configuration, you can use
the emulator skin's default density and add the <code>-dpi-device</code> option the emulator skin's default density and add the <code>-dpi-device</code> option
@@ -1172,25 +1211,6 @@ to the emulator command line when starting the AVD. For example, </p>
<pre>emulator -avd WVGA800 -scale 96dpi -dpi-device 160</pre> <pre>emulator -avd WVGA800 -scale 96dpi -dpi-device 160</pre>
<p>If you would like to test your application with a resolution not supported by
the provided skins, you can use the desired resolution in place of the skin
name. For instance, for FWQVGA you would use:</p>
<pre>android create avd ... --skin 240x432</pre>
<p>Next, you would need to set the proper density for the screen. When asked by
the tool whether you want to create a custom hardware profile for the new AVD,
enter "yes". Continue through the various profile settings until the tools asks
you to specify "Abstracted LCD density". Consult <a href="#range">Table 1</a>,
earlier in this document, and enter the appropriate value. For the FWQVGA
screen, the density should be "160", or medium.</p>
<div id="f9.5" style="text-align:left;margin:0;padding:0;">
<img src="{@docRoot}images/screens_support/avds-config.png" style="padding:0;margin:0;">
<p class="caption" style="margin:0 0 1.5em 1em;padding:0 0 0 1em;"><strong>Figure 3.</strong>
A typical set of AVDs for testing screens support.</p>
</div>
<h2 id="compatibility-examples">Screen-Compatibility Examples</h2> <h2 id="compatibility-examples">Screen-Compatibility Examples</h2>

BIN
docs/html/images/screens_support/avd-density.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 53 KiB

1
docs/html/sdk/android-1.5.jd
View File

@@ -16,7 +16,6 @@ sdk.platform.deployableDate=May 2009
<li><a href="#apps">Built-in Applications</a></li> <li><a href="#apps">Built-in Applications</a></li>
<li><a href="#locs">Locales</a></li> <li><a href="#locs">Locales</a></li>
<li><a href="#skins">Emulator Skins</a></li> <li><a href="#skins">Emulator Skins</a></li>
<li><a href="#notes">Other Notes</a></li>
<li><a href="#api">Framework API</a> <li><a href="#api">Framework API</a>
<ol> <ol>
<li><a href="#api-level">API level</a></li> <li><a href="#api-level">API level</a></li>

1
docs/html/sdk/android-1.6.jd
View File

@@ -16,7 +16,6 @@ sdk.platform.deployableDate=October 2009
<li><a href="#apps">Built-in Applications</a></li> <li><a href="#apps">Built-in Applications</a></li>
<li><a href="#locs">Locales</a></li> <li><a href="#locs">Locales</a></li>
<li><a href="#skins">Emulator Skins</a></li> <li><a href="#skins">Emulator Skins</a></li>
<li><a href="#notes">Other Notes</a></li>
<li><a href="#api">Framework API</a> <li><a href="#api">Framework API</a>
<ol> <ol>
<li><a href="#api-level">API level</a></li> <li><a href="#api-level">API level</a></li>

10
docs/html/sdk/api_diff/3/changes.html
View File

@@ -26,12 +26,12 @@ body{overflow:auto;}
body{background-image:url();padding:12px;} body{background-image:url();padding:12px;}
</style> </style>
</head> </head>
<FRAMESET COLS="242,**" frameborder="1" border="7" bordercolor="#e9e9e9"> <FRAMESET COLS="242,**" framespacing="1" frameborder="yes" border="1" bordercolor="#e9e9e9">
<frameset rows="164,**" frameborder="1" border="7" resizable="yes"> <frameset rows="174,**" framespacing="1" frameborder="yes" border="1" bordercolor="#e9e9e9">
<FRAME SRC="changes/jdiff_topleftframe.html" SCROLLING="no" NAME="topleftframe"> <FRAME SRC="changes/jdiff_topleftframe.html" SCROLLING="no" NAME="topleftframe" frameborder="1">
<FRAME SRC="changes/alldiffs_index_all.html" SCROLLING="auto" NAME="bottomleftframe"> <FRAME SRC="changes/alldiffs_index_all.html" SCROLLING="auto" NAME="bottomleftframe" frameborder="1">
</FRAMESET> </FRAMESET>
<FRAME SRC="changes/changes-summary.html" SCROLLING="auto" NAME="rightframe"> <FRAME SRC="changes/changes-summary.html" SCROLLING="auto" NAME="rightframe" frameborder="1">
</FRAMESET> </FRAMESET>
<NOFRAMES> <NOFRAMES>
<H2> <H2>

3
docs/html/sdk/api_diff/3/stylesheet-jdiff.css
View File

@@ -3,6 +3,7 @@
div.and-diff-id {border: 1px solid #eee;position:relative;float:right;clear:both;padding:0px;} div.and-diff-id {border: 1px solid #eee;position:relative;float:right;clear:both;padding:0px;}
table.diffspectable {border:1px;padding:0px;margin:0px;} table.diffspectable {border:1px;padding:0px;margin:0px;}
table.jdiffIndex {margin-bottom:.5em;}
.diffspechead {background-color:#eee;} .diffspechead {background-color:#eee;}
.diffspectable tr {border:0px;padding:0px;} .diffspectable tr {border:0px;padding:0px;}
.diffspectable td {background-color:eee;border:0px;font-size:90%;font-weight:normal;padding:0px;padding-left:1px;padding-right:1px;text-align:center;color:777;} .diffspectable td {background-color:eee;border:0px;font-size:90%;font-weight:normal;padding:0px;padding-left:1px;padding-right:1px;text-align:center;color:777;}
@@ -29,7 +30,7 @@ tt {font-size:11pt;font-family:monospace;}
} }
.hiddenlink { .hiddenlink {
font-size:96%; font-size:96%;
line-height:.8em; /* line-height:.8em; */
text-decoration:none;} text-decoration:none;}
a { a {
text-decoration:none;} text-decoration:none;}

10
docs/html/sdk/api_diff/4/changes.html
View File

@@ -25,12 +25,12 @@ body{overflow:auto;}
<style type="text/css"> <style type="text/css">
</style> </style>
</HEAD> </HEAD>
<FRAMESET COLS="242,**" frameborder="1" border="7" xframespacing="20" bordercolor="#e9e9e9"> <FRAMESET COLS="242,**" framespacing="1" frameborder="yes" border="1" bordercolor="#e9e9e9">
<frameset rows="164,**" frameborder="1" border="7" xframespacing="20" resizable="yes"> <frameset rows="174,**" framespacing="1" frameborder="yes" border="1" bordercolor="#e9e9e9">
<FRAME SRC="changes/jdiff_topleftframe.html" SCROLLING="no" NAME="topleftframe" xframeborder="1" xborder="6" xframespacing="0"> <FRAME SRC="changes/jdiff_topleftframe.html" SCROLLING="no" NAME="topleftframe" frameborder="1">
<FRAME SRC="changes/alldiffs_index_all.html" SCROLLING="auto" NAME="bottomleftframe" xframeborder="1" xborder="1" xframespacing="0"> <FRAME SRC="changes/alldiffs_index_all.html" SCROLLING="auto" NAME="bottomleftframe" frameborder="1">
</FRAMESET> </FRAMESET>
<FRAME SRC="changes/changes-summary.html" SCROLLING="auto" NAME="rightframe" xframeborder="1" xborder="1" xframespacing="0"> <FRAME SRC="changes/changes-summary.html" SCROLLING="auto" NAME="rightframe" frameborder="1">
</FRAMESET> </FRAMESET>
<NOFRAMES> <NOFRAMES>
<H2> <H2>

3
docs/html/sdk/api_diff/4/stylesheet-jdiff.css
View File

@@ -3,6 +3,7 @@
div.and-diff-id {border: 1px solid #eee;position:relative;float:right;clear:both;padding:0px;} div.and-diff-id {border: 1px solid #eee;position:relative;float:right;clear:both;padding:0px;}
table.diffspectable {border:1px;padding:0px;margin:0px;} table.diffspectable {border:1px;padding:0px;margin:0px;}
table.jdiffIndex {margin-bottom:.5em;}
.diffspechead {background-color:#eee;} .diffspechead {background-color:#eee;}
.diffspectable tr {border:0px;padding:0px;} .diffspectable tr {border:0px;padding:0px;}
.diffspectable td {background-color:eee;border:0px;font-size:90%;font-weight:normal;padding:0px;padding-left:1px;padding-right:1px;text-align:center;color:777;} .diffspectable td {background-color:eee;border:0px;font-size:90%;font-weight:normal;padding:0px;padding-left:1px;padding-right:1px;text-align:center;color:777;}
@@ -29,7 +30,7 @@ tt {font-size:11pt;font-family:monospace;}
} }
.hiddenlink { .hiddenlink {
font-size:96%; font-size:96%;
line-height:.8em; /* line-height:.8em; */
text-decoration:none;} text-decoration:none;}
a { a {
text-decoration:none;} text-decoration:none;}

10
docs/html/sdk/api_diff/5/changes.html
View File

@@ -25,12 +25,12 @@ body{overflow:auto;}
<style type="text/css"> <style type="text/css">
</style> </style>
</HEAD> </HEAD>
<FRAMESET COLS="242,**" frameborder="1" border="7" xframespacing="20" bordercolor="#e9e9e9"> <FRAMESET COLS="242,**" framespacing="1" frameborder="yes" border="1" bordercolor="#e9e9e9">
<frameset rows="164,**" frameborder="1" border="7" xframespacing="20" resizable="yes"> <frameset rows="174,**" framespacing="1" frameborder="yes" border="1" bordercolor="#e9e9e9">
<FRAME SRC="changes/jdiff_topleftframe.html" SCROLLING="no" NAME="topleftframe" xframeborder="1" xborder="6" xframespacing="0"> <FRAME SRC="changes/jdiff_topleftframe.html" SCROLLING="no" NAME="topleftframe" frameborder="1">
<FRAME SRC="changes/alldiffs_index_all.html" SCROLLING="auto" NAME="bottomleftframe" xframeborder="1" xborder="1" xframespacing="0"> <FRAME SRC="changes/alldiffs_index_all.html" SCROLLING="auto" NAME="bottomleftframe" frameborder="1">
</FRAMESET> </FRAMESET>
<FRAME SRC="changes/changes-summary.html" SCROLLING="auto" NAME="rightframe" xframeborder="1" xborder="1" xframespacing="0"> <FRAME SRC="changes/changes-summary.html" SCROLLING="auto" NAME="rightframe" frameborder="1">
</FRAMESET> </FRAMESET>
<NOFRAMES> <NOFRAMES>
<H2> <H2>

3
docs/html/sdk/api_diff/5/stylesheet-jdiff.css
View File

@@ -3,6 +3,7 @@
div.and-diff-id {border: 1px solid #eee;position:relative;float:right;clear:both;padding:0px;} div.and-diff-id {border: 1px solid #eee;position:relative;float:right;clear:both;padding:0px;}
table.diffspectable {border:1px;padding:0px;margin:0px;} table.diffspectable {border:1px;padding:0px;margin:0px;}
table.jdiffIndex {margin-bottom:.5em;}
.diffspechead {background-color:#eee;} .diffspechead {background-color:#eee;}
.diffspectable tr {border:0px;padding:0px;} .diffspectable tr {border:0px;padding:0px;}
.diffspectable td {background-color:eee;border:0px;font-size:90%;font-weight:normal;padding:0px;padding-left:1px;padding-right:1px;text-align:center;color:777;} .diffspectable td {background-color:eee;border:0px;font-size:90%;font-weight:normal;padding:0px;padding-left:1px;padding-right:1px;text-align:center;color:777;}
@@ -29,7 +30,7 @@ tt {font-size:11pt;font-family:monospace;}
} }
.hiddenlink { .hiddenlink {
font-size:96%; font-size:96%;
line-height:.8em; /* line-height:.8em; */
text-decoration:none;} text-decoration:none;}
a { a {
text-decoration:none;} text-decoration:none;}