Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit d797c3ca authored by Scott Main's avatar Scott Main
Browse files

update Getting Started class about fragments to remove support lib lesson 

and mention the action bar library, then update any links and add redirect
bug: 10000221

Change-Id: I625c9cc888b213f1b1e31d8a83ae4dab2051395f
parent e827b0d7

docs/html/_redirects.yaml

+3 −0
Original line number Original line Diff line number Diff line
@@ -21,6 +21,9 @@ redirects: 
- from: /sdk/compatibility-library.html

- from: /sdk/compatibility-library.html

  to: /tools/support-library/index.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

- from: /sdk/eclipse-adt.html

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

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

docs/html/sitemap.txt

+0 −1
Original line number Original line Diff line number Diff line
@@ -362,7 +362,6 @@ http://developer.android.com/training/basics/supporting-devices/index.html 
http://developer.android.com/training/basics/supporting-devices/languages.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/screens.html

http://developer.android.com/training/basics/supporting-devices/platforms.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/creating.html

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

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

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

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

docs/html/training/basics/fragments/creating.jd

+26 −11
Original line number Original line Diff line number Diff line
@@ -32,16 +32,25 @@ class="button">Download the sample</a> 
<p>You can think of a fragment as a modular section of an activity, which has its own lifecycle,

<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

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

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

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

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

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

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

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

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

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

included in the platform.</p>

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>

<h2 id="Create">Create a Fragment Class</h2>
@@ -98,7 +107,7 @@ regular {@link android.app.Activity}.</p> 
screen is considered "large" (specified by the <code>large</code> qualifier in the directory

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

name).</p>

name).</p>





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

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

<pre>

<pre>

&lt;LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

&lt;LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

    android:orientation="horizontal"

    android:orientation="horizontal"
@@ -120,11 +129,11 @@ name).</p> 
&lt;/LinearLayout>

&lt;/LinearLayout>

</pre>

</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, read <a href="{@docRoot}training/multiscreen/screensizes.html">Supporting Different

Screen Sizes</a>.</p>

Screen Sizes</a>.</p>





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

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





<pre>

<pre>

import android.os.Bundle;

import android.os.Bundle;
@@ -139,6 +148,12 @@ public class MainActivity extends FragmentActivity { 
}

}

</pre>

</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

<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

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

docs/html/training/basics/fragments/index.jd

+0 −3
Original line number Original line Diff line number Diff line
@@ -57,9 +57,6 @@ devices running versions as old as Android 1.6.</p> 
<h2>Lessons</h2>

<h2>Lessons</h2>

 

 

<dl>

<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>

  <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

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

methods.</dd>

methods.</dd>

docs/html/training/implementing-navigation/index.jd

+3 −3
Original line number Original line Diff line number Diff line
@@ -47,9 +47,9 @@ understand how to provide proper <em>Up</em> and <em>Back</em> navigation.</p> 




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

<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.

<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

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

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

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

to get your project set up.</p>

document.</p>









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

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