am 54403d8a: am f5ad5b26: am 8709fb2a: Merge "update Getting Started class...

- from: /sdk/compatibility-library.html

  to: /tools/support-library/index.html

- from: /training/basics/fragments/support-lib.html

  to: /tools/support-library/setup.html

- from: /sdk/eclipse-adt.html

  to: /tools/sdk/eclipse-adt.html

http://developer.android.com/training/basics/supporting-devices/languages.html

http://developer.android.com/training/basics/supporting-devices/screens.html

http://developer.android.com/training/basics/supporting-devices/platforms.html

http://developer.android.com/training/basics/fragments/support-lib.html

http://developer.android.com/training/basics/fragments/creating.html

http://developer.android.com/training/basics/fragments/fragment-ui.html

http://developer.android.com/training/basics/fragments/communicating.html

<p>You can think of a fragment as a modular section of an activity, which has its own lifecycle,

receives its own input events, and which you can add or remove while the activity is running (sort

of like a "sub activity" that you can reuse in different activities). This lesson shows how to

extend the {@link android.support.v4.app.Fragment} class using the Support Library so your app

remains compatible with devices running system versions as old as Android 1.6.</p>

extend the {@link android.support.v4.app.Fragment} class using the <a

href="{@docRoot}tools/support-library/index.html">Support Library</a> so your app

remains compatible with devices running system versions as low as Android 1.6.</p>

<p class="note"><strong>Note:</strong> If you decide for other reasons that the minimum

<p class="note"><strong>Note:</strong> If you decide that the minimum

API level your app requires is 11 or higher, you don't need to use the Support

Library and can instead use the framework's built in {@link android.app.Fragment} class and related

APIs. Just be aware that this lesson is focused on using the APIs from the Support Library, which

use a specific package signature and sometimes slightly different API names than the versions

included in the platform.</p>

<p>Before you begin this lesson, you must set up your Android project to use the Support Library.

If you have not used the Support Library before, set up your project to use the <strong>v4</strong>

library by following the <a href="{@docRoot}tools/support-library/setup.html">Support Library

Setup</a> document. However, you can also include the <a href=

"{@docRoot}guide/topics/ui/actionbar.html">action bar</a> in your activities by instead using the

<strong>v7 appcompat</strong> library, which is compatible with Android 2.1 (API level 7)

and also includes the {@link android.support.v4.app.Fragment} APIs.</p>

<h2 id="Create">Create a Fragment Class</h2>

screen is considered "large" (specified by the <code>large</code> qualifier in the directory

name).</p>

<p><code>res/layout-large/news_articles.xml:</code></p>

<p class="code-caption">res/layout-large/news_articles.xml</p>

<pre>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

    android:orientation="horizontal"

</LinearLayout>

</pre>

<p class="note"><strong>Tip:</strong> For more information about creating layouts for different

<p class="note"><strong>Tip:</strong> For more about creating layouts for different

screen sizes, read <a href="{@docRoot}training/multiscreen/screensizes.html">Supporting Different

Screen Sizes</a>.</p>

<p>Here's how an activity applies this layout:</p>

<p>Then apply the layout to your activity:</p>

<pre>

import android.os.Bundle;

}

</pre>

<p>If you're using the <a href="{@docRoot}tools/support-library/features.html#v7-appcompat">v7

appcompat library</a>, your activity should instead extend {@link

android.support.v7.app.ActionBarActivity}, which is a subclass of {@link

android.support.v4.app.FragmentActivity} (for more information,

read <a href="{@docRoot}training/basics/actionbar/index.html">Adding the Action Bar</a>).</p>

<p class="note"><strong>Note:</strong> When you add a fragment to an activity layout by defining

the fragment in the layout XML file, you <em>cannot</em> remove the fragment at runtime. If you plan

<h2>Lessons</h2>

<dl>

  <dt><b><a href="support-lib.html">Using the Android Support Library</a></b></dt>

    <dd>Learn how to use more recent framework APIs in earlier versions of Android by bundling

the Android Support Library into your app.</dd>

  <dt><b><a href="creating.html">Creating a Fragment</a></b></dt>

    <dd>Learn how to build a fragment and implement basic behaviors within its callback

methods.</dd>

<p class="note"><strong>Note:</strong> Several elements of this class require the

<a href="{@docRoot}tools/support-library/index.html">Support Library</a> APIs.

If you have not used the Support Library before, follow the lesson about <a

href="{@docRoot}training/basics/fragments/support-lib.html">Using the Support Library</a>

to get your project set up.</p>

If you have not used the Support Library before, follow the instructions

in the <a href="{@docRoot}tools/support-library/setup.html">Support Library Setup</a>

document.</p>

<h2 id="lessons">Lessons</h2>