CoreDragon 开源项目教程

CoreDragon 开源项目教程

CoreDragon [iOS/deprecated!] Stop using context menus. Drag and drop instead, even between apps! 项目地址: https://gitcode.com/gh_mirrors/co/CoreDragon

项目介绍

CoreDragon 是一个专为 iOS 应用设计的拖放库，旨在替代传统的上下文菜单、模态视图控制器、分享表单等间接操作方式来移动数据。该库灵感来源于 macOS 的拖放API，并且进行了优化以适应iOS环境中的视图控制器体系结构。它不仅支持在单一应用内部的拖放操作，还在现代iPad上实现了跨应用程序（当运行在分屏模式时）的数据移动。CoreDragon最初名为SPDragNDrop，源自Spotify的一次Hackweek实验，后经授权，在开发者Nevyn Bengtsson的维护下，以Apache 2.0许可证发布。

项目快速启动

安装步骤

首先，确保你的开发环境已经配置了CocoaPods。然后，遵循以下步骤来集成CoreDragon到你的项目中：

1. 打开你的项目中的Podfile。
2. 添加以下行到你的Podfile中：

   pod 'CoreDragon'
   

3. 运行pod install命令来安装依赖。
4. 在需要使用拖放功能的地方，导入头文件：

   #import <CoreDragon/CoreDragon.h>
   

基本配置

在你的AppDelegate中启用长按拖动的默认手势：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [[DragonController sharedController] enableLongPressDraggingInWindow:self.window];
    return YES;
}

注册可被拖动的元素及其代理，通常在viewDidLoad方法中完成：

- (void)viewDidLoad {
    [super viewDidLoad];
    [[DragonController sharedController] registerDragSource:yourView delegate:self];
}

// 实现代理方法提供拖动数据
- (void)beginDragOperation:(id<DragonInfo>)drag fromView:(UIView *)draggable {
    [drag.pasteboard setValue:@"示例文本" forPasteboardType:(NSString*)kUTTypePlainText];
}

应用案例和最佳实践

CoreDragon非常适合构建直观的交互界面，比如照片管理应用，用户可以轻松地通过拖放操作来整理图片或创建相册。最佳实践中，确保合理使用自定义视觉效果如高亮和动画，以及充分利用Spring Loading机制提升用户体验，使用户能够预览目标位置的效果。

示例应用

• DragonFrame: 简化的拖放应用，演示如何在不同标签页之间移动图片。
• DragonPhotos: 展示全部功能，包括多对象拖放、文件夹创建与拖放排序，以及与其他应用间的数据传递。

典型生态项目

虽然CoreDragon是独立的库，但其生态并不局限于自身。因为它是基于标准的拖放API构建，理论上可以与任何支持iOS拖放特性的应用或框架结合使用，例如配合MVVM架构的应用，或者在swiftUI项目中通过桥接Objective-C代码融入拖放功能，进一步丰富应用的交互体验。

---

请注意，由于CoreDragon标记为已废弃，推荐在新项目中使用iOS 11及以后版本内置的Drag and Drop API，但在学习老项目迁移或是了解历史实现方案时，此教程仍然具有参考价值。

CoreDragon [iOS/deprecated!] Stop using context menus. Drag and drop instead, even between apps! 项目地址: https://gitcode.com/gh_mirrors/co/CoreDragon