AutoResolveHelper

Helper to auto resolveTasks that may throw ResolvableApiException to request UI being shown before returning the result.

By calling resolveTask(Task, Activity, int)with your task, this helper will make sure that it shows any UI if necessary and at the end will return the result back to your activity's Activity.onActivityResult(int, int, Intent).

This is useful for handling Google Play Services APIs that may have to show UI to the user before returning their results back. Note that only APIs whose results implement the AutoResolvableResult are compatible with this helper.

Below is an example of an hypotheticalloadFooAPI that returns a FooResultbut that may require the user to consent to sharing the resultData in FooResultthe first time before returning it to you.

public static class SampleActivity extends Activity {
private static final int REQUEST_CODE_FOO = 1234;

@Override
public onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
if (savedInstanceState == null) {
// Loading Foo
FooClient fooClient = Foo.getFooClient(...);
Task fooTask = fooClient.loadFoo();
// Asking AutoResolveHelper to take care of resolving
// any ResolvableApiExceptions, showing UI if necessary
// and just piping FooResult to onActivityResult.
AutoResolveHelper.resolveTask(fooTask, this, REQUEST_CODE_FOO);
}
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent resultData) {
switch (requestCode) {
case REQUEST_CODE_FOO:
if (resultCode == Activity.RESULT_OK) {
FooResult fooResult = FooResult.getFromIntent(resultData);
// Result loaded, use it...
} else if (resultCode == Activity.RESULT_CANCELLED) {
// user cancelled...
} else if (resultCode == AutoResolveHelper.RESULT_ERROR) {
// there was an error, handle it or ignore...
int errorCode = AutoResolvableHelper.getStatusFromIntent(resultData);
// handle the error, log,...
}
break;
default:
super.onActivityResult(requestCode, resultCode, resultData);
}
}
}

Notes from the example above:
• You will receive a response back withrequestCodematching the one you originally passed in the call to resolveTask(Task, Activity, int).
• You will receiveresultCodeequal toActivity.RESULT_OK when the call has been successful and you should be able to retrieve the actual result object from theresultDataparam. By convention result classes that can be used with this helper should have agetFromIntent(Intent)method that you can use to retrieve the result object.
• You will receiveresultCodeequal toActivity.RESULT_CANCELED when the user has cancelled the UI that this helper has shown.
• You will receiveresultCodeequal toRESULT_ERROR when an error occurs resolving the result of the givenTask.In that case, you may call getStatusFromIntent(Intent)passingresultDataparam to get the Statuswith the details about the error.