docs: add preview sdk docs to provide an api overview and install steps,
enable the 'preview' flag for the docs build
revise sdk side nav for preview
Change-Id: Ifc26cfb1f18e394e96853fd42f0e194d5f8552f3
diff --git a/docs/html/sdk/index.jd b/docs/html/sdk/index.jd
index 8b77303..4153951 100644
--- a/docs/html/sdk/index.jd
+++ b/docs/html/sdk/index.jd
@@ -19,6 +19,7 @@
@jd:body
+<div class="non-preview">
<p>Here's an overview of the steps you must follow to set up the Android SDK:</p>
<ol>
@@ -32,3 +33,4 @@
<p>To get started, download the appropriate package from the table above, then read the guide to <a
href="installing.html">Installing the SDK</a>.</p>
+</div>
diff --git a/docs/html/sdk/preview/features.jd b/docs/html/sdk/preview/features.jd
index 81b4ff6..55d0f8d 100644
--- a/docs/html/sdk/preview/features.jd
+++ b/docs/html/sdk/preview/features.jd
@@ -1,4 +1,185 @@
-sdk.redirect=true
-
+page.title=Introduction to Honeycomb
@jd:body
+<p>Welcome to the Honeycomb preview SDK. Honeycomb is the next major release of the Android
+platform and is optimized for tablet devices. This document provides an introduction to the new
+platform features and APIs available in Honeycomb.</p>
+
+
+<h2>Fragments</h2>
+
+<div class="figure" style="width:400px">
+ <img src="{@docRoot}images/preview_hc/fragments_layout.png" alt="" />
+ <p class="img-caption"><strong>Fragment Layout.</strong> An activity with two
+fragments: one with a list view, on the left, and one that displays selected content on the
+right. This demo is available in the samples package.</p>
+</div>
+
+
+<p>A new framework component that allows you to separate distinct elements of an activity into
+self-contained modules that define their own UI and lifecycle—defining what may be
+considered "sub-activities".</p>
+<ul>
+ <li>Multiple fragments can be combined in a single activity to build a multi-pane UI in which
+each pane manages its own lifecycle and user inputs</li>
+ <li>Fragments are self-contained and can be reused in multiple activities</li>
+ <li>Fragments can be added, removed, replaced and animated inside the activity</li>
+ <li>Fragment can be added to a back stack managed by the activity, preserving the state of
+fragments as they are changed and allowing the user to navigate backward through the different
+states</li>
+ <li>By <a
+href="{@docRoot}guide/topics/resources/providing-resources.html#AlternativeResources">providing
+alternative resources</a>, you can mix and match fragments, based
+on the screen size and orientation</li>
+ <li>Fragments have direct access to their container activity and can contribute items to the
+activity's Options Menu</li>
+</ul>
+
+<p>For more information, see the <a
+href="{@docRoot}guide/topics/fragments/index.html">Fragments</a> developer guide.</p>
+
+
+<h2>Action Bar</h2>
+
+<p>A replacement for the traditional title bar, which provides users quick access to global
+actions and different navigation modes.</p>
+<ul>
+ <li>Provides quick access to items from the Options Menu ("action items") and interactive
+widgets ("action views")</li>
+ <li>Includes the application logo in the left corner, which can perform actions when tapped
+and can be replaced with a custom logo</li>
+ <li>Provides breadcumbs for navigating backward through fragments</li>
+ <li>Offers built in navigation modes, including tabs and a drop-down list</li>
+ <li>Can be customized with themes and custom backgrounds</li>
+ <li>And more</li>
+</ul>
+
+<img src="{@docRoot}images/preview_hc/actionbar.png" alt="" />
+<p class="img-caption"><strong>Action Bar.</strong> An action bar with a custom logo,
+tabs, and Options Menu. This demo is available in the samples package.</p>
+
+<p>For more information, see the <a
+href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer guide.</p>
+
+
+<h2>System Clipboard</h2>
+
+<p>Applications can copy and paste data (beyond mere text) to and from the system-wide
+clipboard.</p>
+
+<ul>
+ <li>Clipped data can be plain text, a URI, or an intent</li>
+ <li>The new {@link android.content.ClipData} class represents a complex data type for the
+clipboard</li>
+ <li>The new {@link android.content.ClipboardManager} class allows apps to add {@link
+android.content.ClipData} to the clipboard (copy) and read {@link
+android.content.ClipData} from the clipboard (paste)</li>
+ <li>The {@link android.content.ContentProvider} class has been extended to generate byte
+streams based on data types added to the clipboard and point to data hosted in a
+content provider</li>
+</ul>
+
+<p>See {@link android.content.ClipData} and {@link android.content.ClipboardManager}
+for more information. You can also see an example implementation of copy/paste in an updated
+version of the NotePad application (available in the samples package).</p>
+
+
+<h2>Drag and Drop</h2>
+
+<p>New APIs to perform drag and drop operations, leveraging the system clipboard APIs to
+transport data.</p>
+
+<ul>
+ <li>Any {@link android.view.View} can be used for a drag and drop event and a thumbnail of that
+view is generated and used during the drag</li>
+ <li>{@link android.view.ViewGroup}s that can receive the object are notified during hover and drop
+events</li>
+ <li>The new {@link android.view.DragEvent} class describes a drag event relating to a view,
+including the item's current coordinates, the type of action (whether the drag has entered the
+view, exited the view, started, dropped, etc.), and provides access to the {@link
+android.content.ClipData} being carried</li>
+ <li>The new {@link android.view.View.OnDragListener} interface defines a callback that views
+can register in order to be notified of drag events being dispatched to the view; view's can
+register a drag listener with {@link android.view.View#setOnDragListener setOnDragListener()}</li>
+</ul>
+
+<p>See {@link android.view.DragEvent} and {@link android.view.View.OnDragListener} for more
+information.</p>
+
+
+<h2>New Animations</h2>
+
+<p>An all new animation framework.</p>
+
+<ul>
+ <li>A flexible animation system that allows you to animate the properties of any object (View,
+Drawable, Fragment, Object, anything)</li>
+</ul>
+
+<p>See the {@link android.animation} package.</p>
+
+
+<h2>Extended App Widgets</h2>
+
+<p>App widgets can now be more interactive and accept finger gestures.</p>
+
+<ul>
+ <li>The complete list of supported widgets for an app widget is now: {@link
+android.widget.AnalogClock}, {@link android.widget.Button}, {@link android.widget.Chronometer},
+{@link android.widget.ImageButton}, {@link android.widget.ImageView}, {@link
+android.widget.ProgressBar}, {@link android.widget.TextView}, {@link
+android.widget.ViewFlipper}, {@link android.widget.AdapterViewFlipper}, {@link
+android.widget.StackView}, {@link android.widget.ListView}, and {@link
+android.widget.GridView}.</li>
+</ul>
+
+
+<h2>Extended Status Bar Notifications</h2>
+
+<p>The {@link android.app.Notification} class has been extended to support more content-rich
+status bar notifications when on xlarge screens.</p>
+
+<ul>
+ <li>New {@link android.app.Notification.Builder} class helps you easily create new {@link
+android.app.Notification} objects</li>
+ <li>Support for a title in the status bar ticker (in addition to the normal ticker text)</li>
+ <li>Support for a large "sender" icon in the notification—a second icon intended for
+social applications to show the contact photo of the person who is the source of the
+notification</li>
+ <li>Support for custom layouts in the status bar ticker</li>
+ <li>Support for buttons in the expanded notification that deliver custom intents
+(such as to control ongoing music in the background)</li>
+</ul>
+
+
+<h2>Plus Android 2.3</h2>
+
+<p>Honeycomb includes all platform changes introduced for Android 2.3.</p>
+
+<p>To take full advantage of Honeycomb, you should also be aware of the new features
+and APIs introduced for Android 2.3. To learn more, read the <a
+href="{@docRoot}sdk/android-2.3.html">Android 2.3 release notes</a>.</p>
+
+<div class="special">
+<p>To set up your preview SDK and start developing apps for Honeycomb, see the <a
+href="{@docRoot}sdk/preview/installing.html">Getting Started</a> guide.</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/html/sdk/preview/installing.jd b/docs/html/sdk/preview/installing.jd
index 1e6b26b..c835c49 100644
--- a/docs/html/sdk/preview/installing.jd
+++ b/docs/html/sdk/preview/installing.jd
@@ -1,5 +1,62 @@
-sdk.redirect=true
-
+page.title=Getting Started with Honeycomb
@jd:body
+<p>First, you need to set up your development environment with the new SDK Tools and preview
+platform:</p>
+<ol>
+ <li>Unpack the SDK Tools r8 package you've received.
+ <p>If you have an existing Android SDK directory, simply replace your existing {@code
+tools/} directory with the one from the new package and add the {@code platform-tools/}
+directory along side it (at the root of the SDK directory).</p></li>
+ <li>Unpack the platform package ({@code android-Froyo}) and place it in your SDK's {@code
+platforms/} directory.</li>
+ <li>If you're using Eclipse, also update your Eclipse plugin using the provided archive file.
+ <ol>
+ <li>Select <strong>Help > Install new software</strong>.</li>
+ <li>Click <strong>Add</strong>.</li>
+ <li>Click <strong>Archive</strong>.</li>
+ <li>Locate and select the archive file. Click <strong>OK</strong>.
+ <p>Developer Tools now appear in the Available Software window and you can proceed
+to install the plugin.</p>
+ </li>
+ </ol>
+ </li>
+</ol>
+
+<p class="note"><strong>Note:</strong> Beginning with SDK Tools r8 (the version you've received),
+the {@code adb} tool is now located in the {@code <sdk>/platform-tools/} directory (instead
+of in {@code <sdk>/tools/}). Be sure to update your {@code PATH} environment variable and any
+build/debugging scripts you have.</p>
+
+
+
+<h2 id="Setup">Set Up Your AVD and Application</h2>
+
+<p>With your SDK now set up, follow these steps to start developing an application for
+Honeycomb.</p>
+
+<ol>
+
+ <li>Create a new AVD targeted to "Android Froyo (Preview)" and with a custom skin resolution of
+1280 x 800.</li>
+
+ <li>Set the build target of your application to "Android Froyo (Preview)".</li>
+ <li>Set your manifest file's {@code <uses-sdk>} element to use {@code
+android:minSdkVersion="Froyo"}. For example:
+<pre>
+<manifest>
+ <uses-sdk android:minSdkVersion="Froyo" />
+ ...
+</manifest>
+</pre>
+<p>"Froyo" is a provisional API Level for the Honeycomb release, used only during the preview
+period. When the APIs are
+finalized and the SDK is released publicly, you must update this with the appropriate API Level
+integer.</p>
+<p class="note"><strong>Note:</strong> By providing your {@code <uses-sdk>} element in the
+manifest file <em>before</em> the {@code <application>} element, your application will
+automatically apply the new Holographic theme.</p>
+</li>
+
+</ol>
diff --git a/docs/html/sdk/sdk_toc.cs b/docs/html/sdk/sdk_toc.cs
index 057d9e0..0b74bd6 100644
--- a/docs/html/sdk/sdk_toc.cs
+++ b/docs/html/sdk/sdk_toc.cs
@@ -37,6 +37,17 @@
</ul>
</li><?cs
/if ?>
+ <?cs
+ if:sdk.preview ?>
+ <li><h2>Android Preview SDK</h2></li>
+ <ul>
+ <li><a href="<?cs var:toroot ?>sdk/preview/features.html">Introduction
+to Honeycomb</a></li>
+ <li><a href="<?cs var:toroot ?>sdk/preview/installing.html">Getting
+Started</a></li>
+ </ul>
+ </li><?cs
+ /if ?>
<li>
<h2>
<span class="en">Downloadable SDK Components</span>