From d797c3caec8ea50373dcd6630f28561b7671a10d Mon Sep 17 00:00:00 2001 From: Scott Main Date: Tue, 30 Jul 2013 16:24:33 -0700 Subject: 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 --- docs/html/_redirects.yaml | 3 ++ docs/html/sitemap.txt | 1 - docs/html/training/basics/fragments/creating.jd | 37 +++++++++++++++------- docs/html/training/basics/fragments/index.jd | 3 -- .../html/training/implementing-navigation/index.jd | 6 ++-- docs/html/training/training_toc.cs | 4 --- 6 files changed, 32 insertions(+), 22 deletions(-) diff --git a/docs/html/_redirects.yaml b/docs/html/_redirects.yaml index 2169c8ed13be..89672d7e8de1 100644 --- a/docs/html/_redirects.yaml +++ b/docs/html/_redirects.yaml @@ -21,6 +21,9 @@ redirects: - 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 diff --git a/docs/html/sitemap.txt b/docs/html/sitemap.txt index 6291a3e2d932..3a416f99ac61 100644 --- a/docs/html/sitemap.txt +++ b/docs/html/sitemap.txt @@ -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/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 diff --git a/docs/html/training/basics/fragments/creating.jd b/docs/html/training/basics/fragments/creating.jd index b5df4e1f7b56..377adfce049a 100644 --- a/docs/html/training/basics/fragments/creating.jd +++ b/docs/html/training/basics/fragments/creating.jd @@ -6,7 +6,7 @@ trainingnavtop=true
- +

This lesson teaches you to

  1. Create a Fragment Class
    2. @@ -19,7 +19,7 @@ trainingnavtop=true

    Try it out

    - +
    Download the sample @@ -32,21 +32,30 @@ class="button">Download the sample

    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.

    +extend the {@link android.support.v4.app.Fragment} class using the Support Library so your app +remains compatible with devices running system versions as low as Android 1.6.

    -

    Note: If you decide for other reasons that the minimum +

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

    +

    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 v4 +library by following the Support Library +Setup document. However, you can also include the action bar in your activities by instead using the +v7 appcompat library, which is compatible with Android 2.1 (API level 7) +and also includes the {@link android.support.v4.app.Fragment} APIs.

    +

    Create a Fragment Class

    -

    To create a fragment, extend the {@link android.support.v4.app.Fragment} class, then override +

    To create a fragment, extend the {@link android.support.v4.app.Fragment} class, then override key lifecycle methods to insert your app logic, similar to the way you would with an {@link android.app.Activity} class.

    @@ -63,7 +72,7 @@ import android.view.ViewGroup; public class ArticleFragment extends Fragment { @Override - public View onCreateView(LayoutInflater inflater, ViewGroup container, + public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { // Inflate the layout for this fragment return inflater.inflate(R.layout.article_view, container, false); @@ -82,7 +91,7 @@ href="{@docRoot}guide/components/fragments.html">Fragments developer guide.< -

    Add a Fragment to an Activity using XML

    +

    Add a Fragment to an Activity using XML

    While fragments are reusable, modular UI components, each instance of a {@link android.support.v4.app.Fragment} class must be associated with a parent {@link @@ -98,7 +107,7 @@ regular {@link android.app.Activity}.

    screen is considered "large" (specified by the large qualifier in the directory name).

    -

    res/layout-large/news_articles.xml:

    +

    res/layout-large/news_articles.xml

     <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="horizontal"
@@ -120,11 +129,11 @@ name).
    
 </LinearLayout>
    -

    Tip: For more information about creating layouts for different +

    Tip: For more about creating layouts for different screen sizes, read Supporting Different Screen Sizes.

    -

    Here's how an activity applies this layout:

    +

    Then apply the layout to your activity:

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

    If you're using the v7 +appcompat library, 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 Adding the Action Bar).

    +

    Note: When you add a fragment to an activity layout by defining the fragment in the layout XML file, you cannot remove the fragment at runtime. If you plan diff --git a/docs/html/training/basics/fragments/index.jd b/docs/html/training/basics/fragments/index.jd index 1b82f2cd5dd0..987decf9a981 100644 --- a/docs/html/training/basics/fragments/index.jd +++ b/docs/html/training/basics/fragments/index.jd @@ -57,9 +57,6 @@ devices running versions as old as Android 1.6.

    Lessons

    -
    Using the Android Support Library
    -
    Learn how to use more recent framework APIs in earlier versions of Android by bundling -the Android Support Library into your app.
    Creating a Fragment
    Learn how to build a fragment and implement basic behaviors within its callback methods.
    diff --git a/docs/html/training/implementing-navigation/index.jd b/docs/html/training/implementing-navigation/index.jd index 5b657164f720..24c98f26a7e1 100644 --- a/docs/html/training/implementing-navigation/index.jd +++ b/docs/html/training/implementing-navigation/index.jd @@ -47,9 +47,9 @@ understand how to provide proper Up and Back navigation.

    Note: Several elements of this class require the Support Library APIs. -If you have not used the Support Library before, follow the lesson about Using the Support Library -to get your project set up.

    +If you have not used the Support Library before, follow the instructions +in the Support Library Setup +document.

    Lessons

    diff --git a/docs/html/training/training_toc.cs b/docs/html/training/training_toc.cs index cb5775288b9b..99d6510c62b3 100644 --- a/docs/html/training/training_toc.cs +++ b/docs/html/training/training_toc.cs @@ -100,10 +100,6 @@ >Building a Dynamic UI with Fragments