How do I install SplitViewDragAndDrop in my iOS project?

You can install it via CocoaPods by adding 'pod SplitViewDragAndDrop' to your Podfile, or manually copy the folder. Remember to configure the group identifier in your app delegate as shown in the README.

SplitViewDragAndDrop vs Apple's native drag and drop API?

SplitViewDragAndDrop simplifies inter-app drag and drop specifically for split view mode, reducing boilerplate, while Apple's native API is more general-purpose but requires more code for similar inter-app functionality in multitasking.

Can I use SplitViewDragAndDrop for drag and drop within the same app?

No, it's designed exclusively for inter-app communication in split view mode, so it won't handle intra-app drag and drop, which is better served by iOS's built-in UIDragInteraction APIs.

How to handle custom data like JSON with SplitViewDragAndDrop?

Convert your custom data to a Data object using encoders like JSONEncoder, then pass it as dataToTransfer in the handleDrag method, as the library supports arbitrary Data types for flexibility.

What are the limitations of SplitViewDragAndDrop for iOS 14 and later?

While it works on iOS 9 and later, the library's focus on split view might not leverage newer iOS drag and drop features, and Swift 3 compatibility could cause compilation issues in modern Xcode projects.

How to debug if SplitViewDragAndDrop isn't transferring data?

First, ensure both apps share the same app group identifier and are running in split view mode. Check the data conversion and validation closures, as errors often stem from misconfigured app groups or invalid Data objects.

Open-Awesome

SplitViewDragAndDrop

MITSwift0.1

A Swift library for implementing drag and drop between iOS apps in split view mode.

GitHub

331 stars21 forks0 contributors

What is SplitViewDragAndDrop?

SplitViewDragAndDrop is a Swift library for iOS that enables drag and drop functionality between apps when they are running in split view mode. It solves the problem of passing data like images or documents between separate iOS applications seamlessly, leveraging iOS 9's multitasking features. The library handles the underlying communication and UI interactions required for inter-app drag and drop.

Target Audience

iOS developers building apps that need to share data with other apps in a multitasking environment, particularly those targeting iPad users who frequently use split view.

Value Proposition

Developers choose SplitViewDragAndDrop because it provides a straightforward, high-level API for implementing a complex iOS feature, reducing the boilerplate code needed for inter-app communication and drag and drop validation.

Overview

Drag and drop between your apps in split view mode on iOS 9

Use Cases

Best For

Adding drag and drop between two of your own iOS apps in split view
Transferring images or documents from one app to another on iPad
Implementing custom data sharing workflows in multitasking environments
Enhancing productivity apps with seamless inter-app interactions
Building iOS apps that leverage split view for collaborative workflows
Creating app suites that share data via drag and drop

Not Ideal For

Apps targeting iOS versions before 9 or not utilizing split view mode
Developers needing drag and drop functionality within a single app or across all iOS multitasking modes
Projects unwilling or unable to set up shared app group identifiers for inter-app communication

Pros & Cons

Pros

Easy Configuration

The library provides a declarative API with simple methods like handleDrag and addDropObserver, making setup quick as shown in the README's code snippets.

Flexible Data Support

It allows transferring arbitrary Data objects, such as images or PDFs, enabling custom data types without restrictions, as specified in the setup instructions.

Visual Feedback Automation

Automatic snapshot creation for the dragged view ensures users have clear visual cues during the drag operation, enhancing the UI experience without extra code.

Cons

Niche iOS Dependency

It only works in iOS split view mode, limiting its use to specific multitasking scenarios and excluding other drag and drop contexts, which reduces general applicability.

App Group Requirement

Setting up shared app group identifiers is mandatory for communication, adding an extra configuration step that can be a hurdle for developers unfamiliar with iOS app sandboxing.

Outdated Swift Support

The README indicates compatibility with Swift 3, which is obsolete; modern iOS projects may require significant updates or face integration issues with newer Swift versions.

Frequently Asked Questions

Related Projects

FDFullscreenPopGesture

A UINavigationController's category to enable fullscreen pop gesture with iOS7+ system style.

Stars5,893

Forks1,143

Last commit4 years ago

DBPathRecognizer

Gesture recognizer tool [Swift / iOS]

Stars1,181

Forks92

Last commit3 years ago

Tactile

A better way to handle gestures on iOS

Stars713

Forks38

Last commit6 years ago

Sensitive

Special way to work with gestures in iOS

Stars545

Forks31

Last commit2 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub