After updating your SDK, you will likely encounter breakages in your code, due to -framework and API changes. You'll need to update your code to match changes in the Android APIs.
+If (and only if) you have written apps in an SDK released previous to +the Android 1.0 SDK, you will need to migrate your applications. After +updating your SDK, you may encounter breakages in your code, due to +framework and API changes. You'll need to update your code to match +changes in the Android APIs.
One way to start is to open your project in Eclipse and see where the ADT -identifies errors in your application.
+identifies errors in your application. You can also look up +specific changes in the Android APIs in the Overview of Changes and +API Diffs Report, both available in the documentation included with the +Android 1.0 SDK package.If you have additional trouble updating your code, visit the Android Developers Group diff --git a/docs/html/sdk/1.0_r2/upgrading.jd b/docs/html/sdk/1.0_r2/upgrading.jd index df9b6579273b0..409e30e8c1959 100644 --- a/docs/html/sdk/1.0_r2/upgrading.jd +++ b/docs/html/sdk/1.0_r2/upgrading.jd @@ -133,11 +133,17 @@ to place 3rd jar files, which are now automatically handled by the Ant script.Migrate your applications -
After updating your SDK, you will likely encounter breakages in your code, due to -framework and API changes. You'll need to update your code to match changes in the Android APIs.
+If (and only if) you have written apps in an SDK released previous to +the Android 1.0 SDK, you will need to migrate your applications. After +updating your SDK, you may encounter breakages in your code, due to +framework and API changes. You'll need to update your code to match +changes in the Android APIs.
One way to start is to open your project in Eclipse and see where the ADT -identifies errors in your application.
+identifies errors in your application. You can also look up +specific changes in the Android APIs in the Overview of Changes and +API Diffs Report, both available in the documentation included with the +Android 1.0 SDK package.If you have additional trouble updating your code, visit the Android Developers Group diff --git a/docs/html/sdk/1.1_r1/upgrading.jd b/docs/html/sdk/1.1_r1/upgrading.jd index 2ad6757c0904d..19095c0be948e 100644 --- a/docs/html/sdk/1.1_r1/upgrading.jd +++ b/docs/html/sdk/1.1_r1/upgrading.jd @@ -131,11 +131,11 @@ framework and API changes. You'll need to update your code to match the latest APIs.
One way to start is to open your project in Eclipse and see where the ADT -identifies errors in your application. From there, you can lookup -specific API changes in the Android 1.0 APIs in the - -Overview of Changes and -API Diffs Report.
+identifies errors in your application. You can also look up +specific changes in the Android APIs in the +Android 1.1 Version +Notes document. +If you have additional trouble updating your code, visit the Android Developers Group diff --git a/docs/html/sdk/1.5_r1/upgrading.jd b/docs/html/sdk/1.5_r1/upgrading.jd index 23cb82c29fa07..63b7a3ce559c4 100644 --- a/docs/html/sdk/1.5_r1/upgrading.jd +++ b/docs/html/sdk/1.5_r1/upgrading.jd @@ -131,11 +131,12 @@ framework and API changes. You'll need to update your code to match the latest APIs.
One way to start is to open your project in Eclipse and see where the ADT -identifies errors in your application. From there, you can lookup -specific API changes in the Android 1.0 APIs in the - -Overview of Changes and -API Diffs Report.
+identifies errors in your application. You can also look up +specific changes in the Android APIs in the + +Android 1.5 Version Notes + +document.If you have additional trouble updating your code, visit the Android Developers Group