diff --git a/README b/README.mdown similarity index 58% rename from README rename to README.mdown index 0f7b097..92cbd5f 100644 --- a/README +++ b/README.mdown @@ -1,71 +1,78 @@ -Live SDK for Android - -version 5.0 - -1. Introduction - -The Live SDK for Android library is intended to help developers to easily -integrate SkyDrive and Hotmail contacts and calendars into their Android apps. - -2. Reference the API - -After you download the Android API source code, you must compile it. You need -to do this only once. After you compile the Android API source code on your -computer, you can reference it from multiple Eclipse Android projects on that -same computer. - -To compile the Android API source code -1. Start Eclipse, if it is not already running. -2. Click File > Import. -3. Expand General, click Existing Projects into Workspace, and then click Next. -4. With the Select root directory option selected, click Browse. -5. Go to and select the src folder within the downloaded Live SDK for Android, and then click OK. -6. In the Projects box, select the LiveSdk check box. -7. With the Copy projects into workspace check box selected, click Finish. - Eclipse adds the LiveSdk project to the Package Explorer pane and then - compiles the Android API source code in the background. -8. You can now reference the compiled Android API source code from your Eclipse - Android projects. - - -To reference the compiled Android API source code in an Eclipse Android -project -1. In Eclipse, display the Package Explorer pane, if it is not already visible. -2. Right-click your project's name, and then click Properties. -3. In the list of project properties, click Android. -4. In the Library area, click Add. -5. Click LiveSdk and then click OK. -6. Click OK. Eclipse sets a reference to the compiled Android API source code - project, and you can now call the Live Connect Android API from your own - Android project. - -Note: Before you run your project, you must add the Internet permission to your - project's manifest, as shown in the following steps. If you don't add the - Internet permission, your app may have problems accessing Live Connect - web services later. -1. With your project open, in the Package Explorer pane, open the AndroidManifest.xml file. -2. In the editor, click the Permissions tab. -3. Click Add. -4. Click Uses Permission, and then click OK. -5. the Name list, click android.permission.INTERNET. -6. Save the AndroidManifest.xml file. - -Notes: -The Java Compiler must be version 1.6 or higher. - -3. Documentation - -Visit: http://dev.live.com and click the "Documentation" link. - -4. Sample project -There is a sample project located in the sample directory. Using eclipse this project can be added -using the File > Import > General > Existing Projects into Workspace wizard. Before the project can be -properly used, the static variable com.microsoft.live.sample.Config.CLIENT_ID (see Config.java) must -be changed to your own client ID. For help on obtaining a client ID, please see -http://go.microsoft.com/fwlink/?LinkId=220871 - -5. Known issues: - -1) Login dialog is destroyed on screen rotation if the Activity is not set to - ignore orientation changes in AndroidManifest.xml. - +Live SDK for Android +==================== + +version 5.0 + +1. Introduction +--------------- + +The Live SDK for Android library is intended to help developers to easily +integrate SkyDrive and Hotmail contacts and calendars into their Android apps. + +2. Reference the API +-------------------- + +After you download the Android API source code, you must compile it. You need +to do this only once. After you compile the Android API source code on your +computer, you can reference it from multiple Eclipse Android projects on that +same computer. + +To compile the Android API source code +* Start Eclipse, if it is not already running. +* Click File > Import. +* Expand General, click Existing Projects into Workspace, and then click Next. +* With the Select root directory option selected, click Browse. +* Go to and select the src folder within the downloaded Live SDK for Android, and then click OK. +* In the Projects box, select the LiveSdk check box. +* With the Copy projects into workspace check box selected, click Finish. + Eclipse adds the LiveSdk project to the Package Explorer pane and then + compiles the Android API source code in the background. +* You can now reference the compiled Android API source code from your Eclipse + Android projects. + + +To reference the compiled Android API source code in an Eclipse Android +project +* In Eclipse, display the Package Explorer pane, if it is not already visible. +* Right-click your project's name, and then click Properties. +* In the list of project properties, click Android. +* In the Library area, click Add. +* Click LiveSdk and then click OK. +* Click OK. Eclipse sets a reference to the compiled Android API source code + project, and you can now call the Live Connect Android API from your own + Android project. + +Note: Before you run your project, you must add the Internet permission to your + project's manifest, as shown in the following steps. If you don't add the + Internet permission, your app may have problems accessing Live Connect + web services later. +* With your project open, in the Package Explorer pane, open the AndroidManifest.xml file. +* In the editor, click the Permissions tab. +* Click Add. +* Click Uses Permission, and then click OK. +* the Name list, click android.permission.INTERNET. +* Save the AndroidManifest.xml file. + +Notes: +The Java Compiler must be version 1.6 or higher. + +3. Documentation +---------------- + +Visit: http://dev.live.com and click the "Documentation" link. + +4. Sample project +----------------- + +There is a sample project located in the sample directory. Using eclipse this project can be added +using the File > Import > General > Existing Projects into Workspace wizard. Before the project can be +properly used, the static variable com.microsoft.live.sample.Config.CLIENT_ID (see Config.java) must +be changed to your own client ID. For help on obtaining a client ID, please see +http://go.microsoft.com/fwlink/?LinkId=220871 + +5. Known issues: +---------------- + +1) Login dialog is destroyed on screen rotation if the Activity is not set to + ignore orientation changes in AndroidManifest.xml. +