Uber Rides Android SDK (Different Approach).

Unofficial Android SDK (beta) to support Uber’s deeplinks.

This library allows you to integrate Uber into your Android app.

At a minimum, this SDK is designed to work with Android SDK 16.

##Differences between this and Official SDK

Authentication (In Progress)

To use the Uber API on Android, you have to use the Java SDK.

This is fine, however if you are like me, you don't like oAuth or any of that noise.

This SDK provides a Sign In button which will handle the authentication for you.

IN PROGRESS: Passing that authentication over the Java SDK

Redirect URL

If you just want to do Android and don't want to deal with any serverside things, you can just provide a redirect URL that is a deeplink directed to your app.

ClientId Definition in Manifest

No more passing in the clientId wherever you go.. Just define that in your manifest once and its taken care of from there.

Before you begin

Before using this SDK, register your application on the Uber Developer Site.

Installation

To use the Uber Rides Android SDK, add the compile dependency with the latest version of the Uber SDK.

Gradle

Add the Uber Rides Android SDK to your build.gradle:

dependencies {
    compile 'com.uber.sdk:rides-android:0.1.0'
}

Maven

In the pom.xml file:

<dependency>
    <groupId>com.uber.sdk</groupId>
    <artifactId>rides-android</artifactId>
    <version>0.1.0/version>
</dependency>

How to use

Setup

Add the following information to your AndroidManifest.xml

        <meta-data
            android:name="UberClientId"
            android:value="@string/uber_client_id" />

        //Only for Authentication (not ride ordering)
        <meta-data
            android:name="UberClientSecret"
            android:value="@string/uber_client_secret" />

        //Only for Authentication (not ride ordering)
        <meta-data
            android:name="UberRedirectURI"
            android:value="https://samples.rides.android.sdk.uber.com/sample/" />

Ordering a Ride

Simply add the button to your XML file (or inflate it elsewhere).

This will create a request button with default behavior, with pickup pin set to the user’s current location. The user will need to select a product and input additional information when they are switched over to the Uber application.

<LinearLayout
   xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:uber="http://schemas.android.com/apk/res-auto"
   android:layout_width="match_parent"
   android:layout_height="match_parent">

   <com.uber.sdk.android.rides.RequestButton
   	  android:layout_width="wrap_content"
   	  android:layout_height="wrap_content"
   	  uber:style="black"/>

</LinearLayout>

To use the uber custom attribute be sure to add xmlns:uber="http://schemas.android.com/apk/res-auto" to your root view element.

Adding Parameters

We suggest passing additional parameters to make the Uber experience even more seamless for your users. For example, dropoff location parameters can be used to automatically pass the user’s destination information over to the driver:

RequestButton requestButton = RequestButton(context);
RideParameters rideParams = new RideParameters.Builder()
  .setProductID("abc123-productID")
  .setPickupLocation(37.775304f, -122.417522f, "Uber HQ", "1455 Market Street, San Francisco")
  .setDropoffLocation(37.795079f, -122.4397805f, "Embarcadero", "One Embarcadero Center, San Francisco")
  .build();
requestButton.setRideParameters(rideParams);
layout.addView(requestButton);

With all the necessary parameters set, pressing the button will seamlessly prompt a ride request confirmation screen.

Color Style

The default color has a black background with white text:

<com.uber.sdk.android.rides.RequestButton
   	  android:layout_width="wrap_content"
   	  android:layout_height="wrap_content"
   	  uber:client_id="clientId"/>

For a button with a white background and black text:

<com.uber.sdk.android.rides.RequestButton
   	  android:layout_width="wrap_content"
   	  android:layout_height="wrap_content"
   	  uber:client_id="clientId"
   	  uber:style="white"/>

Logging in for the Java SDK

If you'd like to just use Android for this, you'll probably notice that it's not all that easy to hit the ground running.

To speed up the process on Android, you can use the Signin button as follows:

            android:id="@+id/uber_button_black"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            uber:signin_style="black_badge"/>
            
   	  ```

## Sample Apps


A sample app can be found in the `samples` folder. Alternatively, you can also download a sample from the [releases page](https://github.com/uber/rides-android-sdk/releases/tag/v0.1.0).

Don’t forget to configure the appropriate `res/values/strings.xml` file and add your client ID.

To install the sample app from your IDE, File > New > Import Project and select the extracted folder from the downloaded sample.

## Getting help

Uber developers actively monitor the Uber Tag on StackOverflow. If you need help installing or using the library, you can ask a question there. Make sure to tag your question with `uber-api` and `android`!

For full documentation about our API, visit our Developer Site.

## Contributing

We love contributions. If you’ve found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo. Write a test to show your bug was fixed or the feature works as expected.

## MIT Licensed

VicV/rides-android-sdk