Integrate the OneDrive API into your Android application!
Add the maven central repository to your projects build.gradle file then add a compile dependency for com.onedrive.sdk:onedrive-sdk-android:1.0.1
repository {
jcenter()
}
dependency {
// Include the sdk as a dependency
compile('com.onedrive.sdk:onedrive-sdk-android:1.0.1')
// Include the gson dependency
compile 'com.google.code.gson:gson:2.3.1'
// Include supported authentication methods for your application
compile 'com.microsoft.services.msa:msa-auth:0.8.4'
compile 'com.microsoft.aad:adal:1.1.7'
}Register your application by following these steps.
The OneDrive SDK for Android comes with Authenticator objects that have already been initialized for OneDrive with Microsoft accounts and Azure Activity Directory accounts. Replace the current settings with the required settings to start authenticating.
Note that your msa-client-id should look like 0000000000000000 and adal-client-id should look like 00000000-0000-0000-0000-000000000000.
final MSAAuthenticator msaAuthenticator = new MSAAuthenticator() {
@Override
public String getClientId() {
return "<msa-client-id>";
}
@Override
public String[] getScopes() {
return new String[] { "onedrive.appfolder" };
}
}
final ADALAuthenticator adalAuthenticator = new ADALAuthenticator() {
@Override
public String getClientId() {
return "<adal-client-id>";
}
@Override
protected String getRedirectUrl() {
return "https://localhost";
}
}Once you have set the correct application Id and scopes, you must get a OneDriveClient object to make requests against the service. The SDK will store the account information for you, but when a user logs on for the first time, it will invoke UI to get the user's account information.
final IClientConfig oneDriveConfig = new DefaultClientConfig.createWithAuthenticators(
msaAuthenticator,
adalAuthenticator);
final IOneDriveClient oneDriveClient = new OneDriveClient
.Builder()
.fromConfig(oneDriveConfig)
.loginAndBuildClient(getActivity());Once you have an OneDriveClient that is authenticated you can begin making calls against the service. The requests against the service look like our REST API.
To retrieve a user's drive:
oneDriveClient
.getDrive()
.buildRequest()
.get(new ICallback<Drive>() {
@Override
public void success(final Drive result) {
final String msg = "Found Drive " + result.id;
Toast.makeText(getActivity(), msg, Toast.LENGTH_SHORT)
.show();
}
...
// Handle failure case
});To get a user's root folder of their drive:
oneDriveClient
.getDrive()
.getRoot()
.buildRequest()
.get(new ICallback<Item>() {
@Override
public void success(final Item result) {
final String msg = "Found Root " + result.id;
Toast.makeText(getActivity(), msg, Toast.LENGTH_SHORT)
.show();
}
...
// Handle failure case
});For a general overview of how the SDK is designed, see overview.
For a more detailed documentation see:
For known issues, see issues.
The OneDrive SDK is open for contribution. Please read how to contribute to this project here.
The OneDrive SDK for Android library is supported at runtime for Android API revision 15 and greater. To build the sdk you need to install Android API revision 23 or greater.
[Third Party Notices](THIRD PARTY NOTICES)