Merge "Update widget design guidelines for padding and 8dp." into ics-mr0

sizes, widget layouts must adapt to different Home screen grid cell sizes.</p>

<p>Below is an example layout that a music widget showing text information and two buttons can use.

It builds upon the previous discussion of adding margins depending on OS version.</p>

It builds upon the previous discussion of adding margins depending on OS version. Note that the

most robust and resilient way to add margins to the widget is to wrap the widget frame and contents

in a padded {@link android.widget.FrameLayout}.</p>

<pre>

<FrameLayout

  android:layout_width="match_parent"

  android:layout_height="match_parent"

  android:layout_margin="@dimen/widget_margin">

  android:padding="@dimen/widget_margin">

  <LinearLayout

    android:layout_width="match_parent"

<p>When a user adds the widget to their home screen, on an example Android 4.0 device where each

grid cell is 80dp × 100dp in size and 16dp of margins are automatically applied on all sizes,

grid cell is 80dp × 100dp in size and 8dp of margins are automatically applied on all sizes,

the widget will be stretched, like so:</p>

<img src="{@docRoot}images/widget_design/music_example_stretched.png"

  alt="Music widget sitting on an example 80dp x 100dp grid with 16dp of automatic margins

  alt="Music widget sitting on an example 80dp x 100dp grid with 8dp of automatic margins

  added by the system" id="music_example_stretched">

<p class="img-caption"><strong>Figure 7.</strong> Music widget sitting on an example 80dp x 100dp

grid with 16dp of automatic margins added by the system.</p>

grid with 8dp of automatic margins added by the system.</p>

<h2 id="templates">Using the App Widget Templates Pack</h2>

<FrameLayout

  android:layout_width="match_parent"

  android:layout_height="match_parent"

  <strong>android:layout_margin="@dimen/widget_margin"&gt;</strong>

  <strong>android:padding="@dimen/widget_margin"&gt;</strong>

  <LinearLayout

    android:layout_width="match_parent"

  <li>Create two dimensions resources, one in <code>res/values/</code> to provide the pre-Android 4.0 custom margins, and one in <code>res/values-v14/</code> to provide no extra padding for Android 4.0 widgets:

    <p><strong>res/values/dimens.xml</strong>:<br>

    <pre>&lt;dimen name="widget_margin"&gt;15dp&lt;/dimen&gt;</pre></p>

    <pre>&lt;dimen name="widget_margin"&gt;8dp&lt;/dimen&gt;</pre></p>

    <p><strong>res/values-v14/dimens.xml</strong>:<br>

    <pre>&lt;dimen name="widget_margin"&gt;0dp&lt;/dimen&gt;</pre></p>