blob: f70ad262a51458cb72248d1484d65dd1c6dc4a8b [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001page.title=Android 1.1 Version Notes
2sdk.version=1.1_r1
3sys.date=February 2009
4@jd:body
5
6<p>
7<em>Date:</em> February 2009<br />
8<em>API Level:</em>&nbsp;<strong>2</strong></p>
9
10
11<p>This document provides version notes for the Android 1.1 system image included in the SDK.
12
13<ul>
14<li><a href="#overview">Overview</a>
15<li><a href="#overview">External Libraries</a>
16<li><a href="#comp">Device Compatibility</a>
17<li><a href="#apps">Built-in Applications</a>
18<li><a href="#locs">UI Localizations</a>
19<li><a href="#resolved-issues">Resolved Issues</a>
20<li><a href="#features">New Features</a>
21<li><a href="#api-changes">API Changes</a>
22</ul></p>
23
24<h2 id="overview">Overview</h2>
25
26<p>The Android 1.1 system image delivered in the SDK is the development
27counterpart to the Android 1.1 production system image, deployable to
28Android-powered handsets starting in February 2009. </p>
29
30<p>The Android 1.1 system image delivers an updated version of the framework
31API. As with the Android 1.0 API, the Android 1.1 API
32is assigned an integer identifier &mdash; <strong>2</strong> &mdash; that is
33stored in the system itself. This identifier, called the "API Level", allows the
34system to correctly determine whether an application is compatible with
35the system, prior to installing the application.</p>
36
37<p>Applications can reference a specific API Level value in their
38manifest files, to indicate the minimum version of the Android system
39required to run the app. To reference a minimum API Level, applications
40can add a <code>minSdkVersion</code> attribute in their manifest files.
41The value of the attribute is an integer corresponding to an API Level
42identifier. Prior to installing an application, the system then checks the value of
43<code>minSdkVersion</code> and allows the install only
44if the referenced integer is less than or equal to the API Level integer stored
45in the system itself. </p>
46
47<p>If you use the Android 1.1 system image to build an application
48compatible with Android-powered devices running the Android 1.1
49platform, please note that you <strong><span
50style="color:red;">must</span></strong> set the the
51<code>android:minSdkVersion</code> attribute in the application's
52manifest to "2", which is the API strictly associated with Android 1.1.
53</p>
54
55<p>Specifically, you specify the <code>android:minSdkVersion</code>
56attribute in a <code>&lt;uses-sdk&gt;</code> element as a child of
57<code>&lt;manifest&gt;</code> in the manifest file. When set, the
58attribute looks like this: </p>
59
60<pre><code>&lt;manifest&gt;
61 ...
62 &lt;uses-sdk minSdkVersion="2" /&gt;
63 ...
64&lt;/manifest&gt;</code>
65</pre>
66
67<p>By setting <code>android:minSdkVersion</code> in this way, you ensure
68that users will only be able to install your application if their
69devices are running the Android 1.1 platform. In turn, this ensures that
70your application will function properly on their devices, especially if
71it uses <a href="#apichange">APIs introduced in Android 1.1</a>. </p>
72
73<p>If your application uses APIs introduced in Android 1.1 but does not
74declare <code>&lt;uses-sdk minSdkVersion="2" /&gt;</code>, then it will
75run properly on Android 1.1 devices but <em>not</em> on Android 1.0
76devices. In the latter case, the application will crash at runtime when
77it tries to use the Android 1.1 APIs.</p>
78
79<p>If your application does not use any new APIs introduced in Android
801.1, you can indicate Android 1.0 compatibility by removing
81<code>minSdkVersion</code> or setting the attribute to "1". However,
82before publishing your application, you must make sure to compile your
83application against the Android 1.0 system image (available in the
84Android 1.0 SDK), to ensure that it builds and functions properly for
85Android 1.0 devices. You should test the application against system
86images corresponding to the API Levels that the application is designed
87to be compatible with.</p>
88
89<p>If you are sure your application is not using Android 1.1 APIs and
90has no need to use them, you might find it easier to keep working in the
91Android 1.0 SDK, rather than migrating to the Android 1.1 SDK and having
92to do additional testing.</p>
93
94
95<h2 id="extlibs">External Libraries</h2>
96
97<p>The system image includes these external libraries, which you can
98access from your application by adding a <a
99href="{@docRoot}guide/topics/manifest/uses-library-element.html">
100&lt;uses-library&gt;</a>.</p>
101 <ul>
102 <li>com.google.android.maps &mdash; gives your
103application access to Google Maps data. Note that, to use Google Maps
104data, a Maps API Key is required.</li>
105 </ul>
106
107<h2 id="comp">Device Compatibility</h2>
108
109<p>The Android 1.1 system image was tested for compatability with the
110Android-powered devices listed below:</p>
111 <ul>
112 <li><a href="http://www.t-mobileg1.com">T-Mobile G1</a></li>
113 </ul>
114
115<h2 id="apps">Built-in Applications</h2>
116
117<p>The system image includes these built-in applications:</p>
118 <ul>
119 <li>Alarm Clock</li>
120 <li>API Demos</li>
121 <li>Browser</li>
122 <li>Calculator</li>
123 <li>Camera</li>
124 <li>Contacts</li>
125 <li>Dev Tools</li>
126 <li>Dialer</li>
127 <li>Email</li>
128 <li>Maps (and StreetView)</li>
129 <li>Messaging</li>
130 <li>Music</li>
131 <li>Pictures</li>
132 <li>Settings</li>
133 </ul>
134
135<h2 id="locs">UI Localizations</h2>
136
137<p>The system image provides localized UI strings for the languages
138listed below.</p>
139 <ul>
140 <li>English, US (en_US)</li>
141 <li>German (de) </li>
142 </ul>
143
144<p>Localized UI strings match the locales that are displayable in
145the emulator, accessible through the device Settings application.</p>
146
147<h2 id="resolved-issues">Resolved Issues</h2>
148<ul>
149<li>AlarmClock alert now plays audio/vibe directly, rather than through
150AlarmManager. AlarmClock alert starts playing audio/vibe in its
151IntentReceiver, rather than on activity start. These changes should
152prevent alarms from being blocked by modal dialogs.</li>
153<li>Fixes to device sleep. </li>
154<li>Single tap no longer opens the in-call dialpad; users now need to
155touch and drag it. </li>
156<li>Fixes a bug causing approximately 1 in 25 outbound messages to
157freeze up the IMAP connection (to a Gmail based server) when transferred
158to the Sent folder.</li>
159<li>Removes automatic account setup entries that were broken or not
160testable. Adds minor fixes to a few of the remaining entries. Makes
161improvements to warning dialogs used for a few special cases. </li>
162<li>Changes default mail checking interval to every 15 minutes (instead
163of defaulting to "never").</li>
164<li>Fixes password-quoting bugs in IMAP, so that users can include
165special characters in passwords (e.g. spaces).</li>
166<li>Fixes various errors in auto and manual account setup </li>
167<li>Improves reporting for various connection errors, making it easier
168for the user to diagnose failed account setups.</li>
169<li>Fixes new-mail notifications for POP3 accounts.</li>
170<li>Ensures proper auto-checking of accounts marked as "never
171check".</li>
172<li>Now displays date and time using user preference (e.g. 24 hr vs.
173AM/PM).</li>
174<li>Now shows cc: in message view.</li>
175<li>Improves recovery from POP3 connection failures.</li>
176<li>POP3 parser rules loosened, so the application can work with
177non-compliant email servers.</li>
178</ul>
179
180<h2 id="features">New Features</h2>
181
182<ul>
183<li>Maps: Adds details and reviews when a user does a search on Maps and
184clicks on a business to view its details.</li>
185<li>Dialer: In-call screen timeout default is now longer when using the
186speakerphone.</li>
187<li>Dialer: Adds a "Show dialpad" / "Hide dialpad" item to the in-call
188menu, to make it easier to discover the DTMF dialpad. </li>
189<li>Adds support for saving attachments from MMS</li>
190<li>Adds support for marquee in layouts.</li>
191</ul>
192
193<h2 id="api-changes">API Changes</h2>
194
195<h3>Overview</strong></h3>
196
197<ul>
198<li>Adds annotations for test systems, no actual (non-test) API
199changes.</li>
200<li>Adds a method to allow a process to easily determine its UID.
201<li>Adds support for marquee in layouts.</li>
202<li>Adds new methods for determining padding in views. Useful if you are
203writing your own
204subclasses of {@link android.view.View View}.</li>
205<li>Adds new permissions that allow an application to broadcast an SMS
206or WAP Push message. </li>
207<li>API cleanup: removes protected constructor from
208SDK-bound system images. </li>
209</ul>
210
211<h3>API Change Details</h3>
212
213<table>
214<tr>
215<th>Module or Feature</th><th>Change Description</th>
216</tr>
217<tr><td rowspan="4">Annotations for test systems</td></tr>
218 <tr><td>Added {@link android.test.suitebuilder.annotation.LargeTest LargeTest} annotation.</td></tr>
219 <tr><td>Added {@link android.test.suitebuilder.annotation.MediumTest MediumTest} annotation.</td></tr>
220 <tr><td>Added {@link android.test.suitebuilder.annotation.SmallTest SmallTest} annotation.</td></tr>
221
222<tr><td rowspan="2">Allow a process to easily know its UID.</td></tr>
223 <tr><td>Added public method {@link android.os.Process#myUid} to class {@link android.os.Process android.os.Process}</td></tr>
224
225<tr><td rowspan="6">Padding in views</td></tr>
226 <tr><td>Added public method {@link android.view.View#getBottomPaddingOffset} to class {@link android.view.View android.view.View}.</td></tr>
227 <tr><td>Added public method {@link android.view.View#getLeftPaddingOffset} to class {@link android.view.View android.view.View}.</td></tr>
228 <tr><td>Added public method {@link android.view.View#getRightPaddingOffset} to class {@link android.view.View android.view.View}.</td></tr>
229 <tr><td>Added public method {@link android.view.View#getTopPaddingOffset} to class {@link android.view.View android.view.View}.</td></tr>
230 <tr><td>Added public method {@link android.view.View#isPaddingOffsetRequired} to class {@link android.view.View android.view.View}.</td></tr>
231
232<tr><td rowspan="3">Marquee support</td></tr>
233 <tr><td>Added public method {@link android.widget.TextView#setMarqueeRepeatLimit} to class {@link android.widget.TextView}</td></tr>
234 <tr><td>Added public field {@link android.R.attr#marqueeRepeatLimit android.R.attr.marqueeRepeatLimit}</td></tr>
235
236<tr><td rowspan="3">New permissions</td></tr>
237 <tr><td>Added public field {@link android.Manifest.permission#BROADCAST_SMS android.Manifest.permission.BROADCAST_SMS}</td></tr>
238 <tr><td>Added public field {@link android.Manifest.permission#BROADCAST_WAP_PUSH android.Manifest.permission.BROADCAST_WAP_PUSH}</td></tr>
239
240<tr><td rowspan="2">API cleanup</td></tr>
241 <tr><td>Removed protected constructor java.net.ServerSocket.ServerSocket(java.net.SocketImpl).</td></tr>
242
243</table>
244
245
246
247
248
249