This open source Java library allows you to integrate ACS into your Android application. Except as otherwise noted, the ACS Android SDK is licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html)

The SDK is lightweight and has no external dependencies. Getting started is easy.

1. Pull the repository from GitHub:

   git clone git@github.com:appcelerator/acs-android-sdk.git

2. If you have not already done so, follow the (http://developer.android.com/sdk/index.html)[Android SDK Getting Started Guide]. You will need the device emulator and debugging tools.

3. The ACS Android SDK works fine in any Android development environment. To build in Eclipse:

• Create a new project for the ACS SDK in your Eclipse workspace.
• Select File -> New -> Project, choose Android Project (inside the Android folder), and then click Next.
• Select "Create project from existing source".
• Select the acs subdirectory from within the git repository. You should see the project properties populated (you might want to change the project name to something like "FacebookSDK").
• Click Finish to continue.

The ACS SDK is now configured and ready to go.

This library includes two sample applications to guide you in development.

• demo: A simple demo app that demonstrates places map view, user signup, login and facebook login and user checkins.

• Create the sample application in your workspace:

2. Select File -> New -> Project, choose Android Project, and then click Next.
3. Select "Create project from existing source".
4. Choose demo. You should see the project properties populated.
5. Click Finish to continue.

• Build the project: from the Project menu, select "Build Project".

• Run the application: from the Run menu, select "Run Configurations...". Under Android Application, you can create a new run configuration: give it a name and select the simple Example project; use the default activity Launch Action. See http://developer.android.com/guide/developing/eclipse-adt.html#RunConfig for more details.

The easiest way to get started is to copy/hack up the sample applications (that's what they are there for). However, if you want to just integrate the Facebook SDK with an existing application (or create a new one from scratch), then you should:

• Add a dependency on the ACS Android SDK library on your application:

  1. Select File -> Properties. Open the Android section within the Properties dialog.
  2. In the bottom Library section, click Add... and select the ACS SDK project.
  3. Any issues? Check Android documentation

• Ensure that your application has network access (android.permission.INTERNET) in the Android manifest:

This project is open source and provided under the Apache Public License (version 2). Please make sure you see the LICENSE file included in this distribution for more details on the license.

(C) Copyright 2012-2014, Appcelerator Inc. All Rights Reserved.