Skip to content

Commit 8db858f

Browse files
author
Robert Ly
committed
docs: change compatibility package to support package and update rel notes for r4
Change-Id: I57496090c207fc347adc144a66346b44479570ee
1 parent 1ff3921 commit 8db858f

File tree

2 files changed

+109
-19
lines changed

2 files changed

+109
-19
lines changed

docs/html/sdk/compatibility-library.jd

Lines changed: 105 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
page.title=Compatibility Package
1+
page.title=Support Package
22

33
@jd:body
44

@@ -8,7 +8,7 @@ page.title=Compatibility Package
88
<h2>In this document</h2>
99
<ol>
1010
<li><a href="#Notes">Revisions</a></li>
11-
<li><a href="#Downloading">Downloading the Compatibility Package</a></li>
11+
<li><a href="#Downloading">Downloading the Support Package</a></li>
1212
<li><a href="#SettingUp">Setting Up a Project to Use a Library</a></li>
1313
<li><a href="#Using">Using the v4 Library APIs</a></li>
1414
<li><a href="#Docs">Reference Docs</a></li>
@@ -27,28 +27,118 @@ href="{@docRoot}guide/practices/optimizing-for-3.0.html">Optimizing Apps for And
2727

2828
<p><em>Minimum API level supported:</em> <b>4</b></p>
2929

30-
<p>The Compatibility Package includes static "support libraries" that you can add to your Android
30+
<p>The Support Package includes static "support libraries" that you can add to your Android
3131
application in order to use APIs that are either not available for older platform versions or that
3232
offer "utility" APIs that aren't a part of the framework APIs. The goal is to simplify your
3333
development by offering more APIs that you can bundle with your application so you can
3434
worry less about platform versions.</p>
3535

36-
<p class="note"><strong>Note:</strong> The Compatibility Package includes more than one support
36+
<p class="note"><strong>Note:</strong> The Support Package includes more than one support
3737
library. Each one has a different <em>minimum API level</em>. For example, one library requires API
38-
level 4 or higher, while another requires API level 13 or higher. The minimum version is indicated
38+
level 4 or higher, while another requires API level 13 or higher (v13 is a superset of v4 and includes additional
39+
support classes to work with v13 APIs). The minimum version is indicated
3940
by the directory name, such as {@code v4/} and {@code v13/}.</p>
4041

4142

4243
<h2 id="Notes">Revisions</h2>
4344

4445
<p>The sections below provide notes about successive releases of
45-
the Compatibility Package, as denoted by revision number.</p>
46+
the Support Package, as denoted by revision number.</p>
47+
4648

4749

4850
<div class="toggle-content open">
4951

5052
<p><a href="#" onclick="return toggleContent(this)">
5153
<img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" />
54+
Support Package, revision 4 (October 2011)
55+
</a></p>
56+
57+
<div class="toggle-content-toggleme" style="padding-left:2em">
58+
<dl>
59+
<dt>Changes for v4 support library:</dt>
60+
<dd>
61+
<ul>
62+
<li>Support for Accessiblity APIs:
63+
<ul>
64+
<li>Added <code>AccessibilityDelegateCompat</code> to support
65+
{@link android.view.View.AccessibilityDelegate}.</li>
66+
67+
<li>Added <code>AccessibilityEventCompat</code> to support
68+
{@link android.view.accessibility.AccessibilityEvent}.</li>
69+
70+
<li>Added <code>AccessibilityManagerCompat</code> to support
71+
{@link android.view.accessibility.AccessibilityManager}.</li>
72+
73+
<li>Added <code>AccessibilityNodeInfoCompat</code> to support
74+
{@link android.view.accessibility.AccessibilityNodeInfo}.</li>
75+
76+
<li>Added <code>AccessibilityRecordCompat</code> to support
77+
{@link android.view.accessibility.AccessibilityRecord}.</li>
78+
79+
<li>Added <code>AccessibilityServiceInfoCompat</code> to support
80+
{@link android.accessibilityservice.AccessibilityServiceInfo}.</li>
81+
82+
<li>Added <code>ViewGroupCompat</code>
83+
to support accessibility features in {@link android.view.ViewGroup}.
84+
</li>
85+
86+
<li>Modified <code>ViewCompat</code>
87+
to support accessibility features in {@link android.view.View}.</li>
88+
</ul>
89+
</li>
90+
91+
<li>Added <code>EdgeEffectCompat</code> to
92+
support {@link android.widget.EdgeEffect}.</li>
93+
94+
<li>Added <code>LocalBroadcastManager</code> to allow applications to easily
95+
register for and receive intents within a single application without
96+
broadcasting them globally.</li>
97+
98+
<li>Added support in <code>ViewCompat</code> to check for and set overscroll
99+
modes for {@link android.view.View}s on Android 2.3 and later.</li>
100+
<li>Changes to Fragment APIs:
101+
<ul>
102+
<li>Added new APIs to control the visibility of new menus.</li>
103+
<li>Added custom animation APIs.</li>
104+
<li>Added APIs in <code>FragmentActivity</code> to retain custom,
105+
non-configuration instance data.</li>
106+
<li>Various bug fixes.</li>
107+
</ul>
108+
</li>
109+
<li>Changes to <code>ViewPager</code>:
110+
<ul>
111+
<li>Added support for margins between pages.
112+
An optional {@link android.graphics.drawable.Drawable} can be provided
113+
to fill the margins.</li>
114+
<li>Added support for {@link android.widget.EdgeEffect}.</li>
115+
<li>Added support for keyboard navigation</li>
116+
<li>Added support to control how many pages are kept to either side
117+
of the current page.</li>
118+
<li>Improved touch physics.</li>
119+
</ul>
120+
</li>
121+
122+
<li>Fixed a {@link android.content.Loader} bug that caused issues in
123+
canceling {@link android.os.AsyncTask}s when running on Froyo and older
124+
versions of the platform. The support
125+
code now uses its own version of {@link android.os.AsyncTask} to keep the same
126+
behavior on all platform versions.</li>
127+
128+
</ul>
129+
</dd>
130+
</dl>
131+
</div>
132+
133+
134+
135+
</div>
136+
137+
138+
<div class="toggle-content closed">
139+
140+
<p><a href="#" onclick="return toggleContent(this)">
141+
<img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" />
52142
Compatibility Package, revision 3 (July 2011)
53143
</a></p>
54144

@@ -136,9 +226,9 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w
136226

137227

138228

139-
<h2 id="Downloading">Downloading the Compatibility Package</h2>
229+
<h2 id="Downloading">Downloading the Support Package</h2>
140230

141-
<p>The Compatibility Package is provided as a downloadable package from the Android SDK and AVD
231+
<p>The Support Package is provided as a downloadable package from the Android SDK and AVD
142232
Manager. To install:</p>
143233

144234
<ol>
@@ -147,13 +237,13 @@ Manager. To install:</p>
147237
&gt; <strong>Android SDK and AVD Manager</strong>. Or, launch {@code SDK Manager.exe} from
148238
the {@code &lt;sdk&gt;/} directory (on Windows only) or {@code android} from the {@code
149239
&lt;sdk&gt;/tools/} directory.</p></li>
150-
<li>Expand the Android Repository, check <strong>Android Compatibility package</strong>
240+
<li>Expand the Android Repository, check <strong>Android Support package</strong>
151241
and click <strong>Install selected</strong>.</li>
152242
<li>Proceed to install the package.</li>
153243
</ol>
154244

155245
<p>When done, all files (including source code, samples, and the {@code .jar} files) are saved
156-
into the <code>&lt;sdk&gt;/extras/android/compatibility/</code> directory. This directory contains
246+
into the <code>&lt;sdk&gt;/extras/android/support/</code> directory. This directory contains
157247
each of the different support libraries, such as the library for API level 4 and up and the library
158248
for API level 13 and up, each named with the respective version (such as {@code v4/}).</p>
159249

@@ -167,7 +257,7 @@ project (next to {@code src/}, {@code res/}, etc.)</li>
167257
<li>Locate the JAR file for the library you want to use and copy it into the {@code
168258
libs/} directory.
169259
<p>For example, the library that supports API level 4 and up is located at {@code
170-
&lt;sdk&gt;/extras/android/compatibility/v4/android-support-v4.jar}.</p>
260+
&lt;sdk&gt;/extras/android/support/v4/android-support-v4.jar}.</p>
171261
</li>
172262
<li>Add the JAR to your project build path.
173263
<p>In Eclipse, right-click the JAR file in the Package Explorer, select <strong>Build
@@ -181,7 +271,7 @@ provided APIs are available in the {@code android.support} package (for
181271
example, {@code android.support.v4}).</p>
182272

183273
<p class="note"><strong>Tip:</strong> To see the library APIs in action, take a look at the sample
184-
apps in {@code extras/android/compatibility/&lt;version&gt;/samples/}.</p>
274+
apps in {@code extras/android/support/&lt;version&gt;/samples/}.</p>
185275

186276
<p class="warning"><strong>Warning:</strong> Be certain that you not confuse the standard
187277
{@code android} packages with those in {@code android.support} library. Some code completion tools
@@ -265,7 +355,7 @@ for the library version you're using). In this example, documentation is generat
265355
library:</p>
266356

267357
<pre class="no-pretty-print">
268-
cd &lt;sdk&gt;/extras/android/compatibility/v4/
358+
cd &lt;sdk&gt;/extras/android/support/v4/
269359
mkdir docs
270360
javadoc -sourcepath src/java/ -subpackages android.support.v4 -d docs
271361
</pre>
@@ -275,8 +365,8 @@ javadoc -sourcepath src/java/ -subpackages android.support.v4 -d docs
275365
<h2 id="Samples">Samples</h2>
276366

277367
<p>If you want to see some code that uses the support libraries, samples are included with the
278-
Compatibility Package, inside each support library directory. For example, at {@code
279-
extras/android/compatibility/v4/samples/}.</p>
368+
Support Package, inside each support library directory. For example, at {@code
369+
extras/android/support/v4/samples/}.</p>
280370

281371
<p>Additionally, the <a href="http://code.google.com/p/iosched/">Google I/O App</a> is a complete
282372
application that uses the v4 support library to provide a single APK for both handsets and tablets

docs/html/sdk/sdk_toc.cs

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -150,11 +150,11 @@
150150
</li>
151151
</ul>
152152
<ul>
153-
<li><a href="<?cs var:toroot ?>sdk/tools-notes.html">SDK Tools, r14</a> <span
154-
class="new">new!</span></li>
153+
<li><a href="<?cs var:toroot ?>sdk/tools-notes.html">SDK Tools, r14</a>
154+
<span class="new">new!</span></li>
155155
<li><a href="<?cs var:toroot ?>sdk/win-usb.html">Google USB Driver, r4</a></li>
156-
<li><a href="<?cs var:toroot ?>sdk/compatibility-library.html">Compatibility Package,
157-
r3</a></li>
156+
<li><a href="<?cs var:toroot ?>sdk/compatibility-library.html">Support Package, r4</a>
157+
<span class="new">new!</span></li>
158158
</ul>
159159
</li>
160160
<li>

0 commit comments

Comments
 (0)