KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

ObjectiveDropbox

★ 31 Open GitHub ↗

The most complete Objective-C SDK for integrating with the Dropbox API v2.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ObjectiveDropbox

[![Version](https://img.shields.io/cocoapods/v/ObjectiveDropbox.svg?style=flat)](http://cocoapods.org/pods/ObjectiveDropbox)
[![License](https://img.shields.io/cocoapods/l/ObjectiveDropbox.svg?style=flat)](http://cocoapods.org/pods/ObjectiveDropbox)
[![Platform](https://img.shields.io/cocoapods/p/ObjectiveDropbox.svg?style=flat)](http://cocoapods.org/pods/ObjectiveDropbox)

The most complete third-party Objective-C SDK for integrating with the Dropbox API v2.

## What is it capable of?
Everything what Dropbox HTTP API v2 is capable of (except Dropbox Business API).

## Requirements
- Xcode 7+
- iOS 8+ (CocoaPods or manual installation)
- iOS 7+ (manual installation only)

## Installation

ObjectiveDropbox is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

```ruby
pod "ObjectiveDropbox"
```

Or you can install it manually by copying source files into your project. In this case you should add WebKit.framework with 'Optional' status to your target.

## Example project

To run the example project, clone the repo, and run 'ObjectiveDropbox.xcworkspace' from the Example directory.

## Usage

**Use the following import:**
```obj-c
#import "DropboxClient.h"
```

**Then create DropboxClient:**
```obj-c
DropboxClient *dropboxClient = [[DropboxClient alloc] initWithAppKey:<DropboxApp key> 
                                redirectURL:<redirectURL> restartAllTasksAfterRelaunch:YES];
```
I recommend to use 'http://localhost' as redirectURL (don't forget to add it in your Dropbox App page).

If you want to use multiple Dropbox accounts simultaneously create each DropboxClient with this initializer:
```obj-c
DropboxClient *dropboxClient = [[DropboxClient alloc] initWithAppKey:<DropboxApp key> 
                                redirectURL:<redirectURL> 
                                restartAllTasksAfterRelaunch:YES 
                                keychainAccount:<account string>];
```

**Get access token before the first request:**
(user will see Dropbox authentication UI on this step)
```obj-c
[dropboxClient getNewTokenWithSuccess:^ { ... } fail:^(NSString * _Nonnull errorSummary) { ... }];
```
Access token will be saved to user's keychain and restored later. You don't have to call that method if your dropboxClient.accessToken != nil.

If you want to change Dropbox user, use this code:
```obj-c
dropboxClient.accessToken = nil;
```
And then call [dropboxClient getNewTokenWithSuccess:fail:] again.

**Use all Dropbox features like this:**
```obj-c
DropboxCommitInfo *commitInfo = [[DropboxCommitInfo alloc] initWithPath:@"/myfile.txt" 
                                mode:[[DropboxWriteMode alloc] initWithOverwrite]];
[dropboxClient.files upload:commitInfo sourceFileUrl:sourceFileURL 
progress:^(int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend) {
    NSLog(@"Upload progress %i%%", (int)(100.0 * totalBytesSent/totalBytesExpectedToSend));
} success:^(DropboxFileMetadata * _Nonnull uploadResult) {
    NSLog(@"File uploaded: %@", uploadResult);
} fail:^(DropboxError * _Nonnull error) {
    NSLog(@"Upload failed with error: %@", error);
}];
```
See DropboxClient.h for all available methods.

Each download/upload method returns a task object. You can cancel, suspend and resume it. Your download/upload tasks will remain active in background (background fetch must be ON in your target's entitlements).

**If you want to be a good iOS citizen add these lines to your AppDelegate implementation:**
```obj-c
- (void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)())completionHandler
{
    NSDictionary *userInfo = @{@"sessionIdentifier": identifier, @"completionHandler": completionHandler};
    [[NSNotificationCenter defaultCenter] postNotificationName:@"ObjectiveDropboxBackgroundSessionUpdated" object:nil userInfo:userInfo];
}
```
## Author

Mikhail Motyzhenkov, m.motyzhenkov@gmail.com

## License

ObjectiveDropbox is available under the MIT license. See the LICENSE file for more info.

ObjectiveDropbox

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README