Dance 安装详解:CocoaPods 与拖拽导入两种方式快速搞定

📅 2026/8/21 13:31:24
Dance 安装详解:CocoaPods 与拖拽导入两种方式快速搞定
Dance 安装详解CocoaPods 与拖拽导入两种方式快速搞定【免费下载链接】DanceA radical elegant animation library for iOS.项目地址: https://gitcode.com/gh_mirrors/dance1/DanceDance 是一款基于 iOS 10UIViewPropertyAnimator打造的 iOS 动画库只需一行view.dance.animate { ... }就能轻松创建、暂停、倒放和拖动动画进度。本文将手把手教你通过CocoaPods 安装和拖拽导入 Dance.swift两种方式快速搞定这个动画库的配置让新手也能在 5 分钟内跑通第一个 iOS 动画。 Dance 是什么为什么值得安装Dance 的核心设计理念是优雅而宽容。它把 iOS 10 新增的UIViewPropertyAnimator封装成极简的链式 API任何UIView及其子类UILabel、UIButton、UITextField等都能直接调用circle.dance.animate(duration: 2.0, curve: .easeInOut) { $0.center self.view.center $0.backgroundColor .blue }.start()与系统自带的UIView.animate相比Dance 的动画可以被随时引用、暂停、倒放、拖动进度甚至中途修改方向。这么强大的能力安装过程却异常简单——你只需要选下面两种方式中的任意一种。✅ 安装前的准备环境要求一览在开始安装之前请先确认你的开发环境满足以下条件项目要求系统版本iOS 10.0 及以上开发语言Swift 3 及以上开发工具Xcode 8 及以上依赖管理CocoaPods仅方法一需要其中系统版本 iOS 10是硬性要求因为 Dance 依赖 iOS 10 引入的UIViewPropertyAnimator。如果你项目的最低部署版本低于 iOS 10记得先在工程的 Build Settings 中修改 Deployment Target。 方法一CocoaPods 安装推荐团队项目使用CocoaPods 是目前 iOS 最主流的依赖管理工具适合需要统一管理第三方库、多成员协作的正式项目。安装 Dance 只需四步。第 1 步检查本机 CocoaPods 环境打开终端输入以下命令确认 CocoaPods 是否已安装pod --version如果提示command not found请先执行sudo gem install cocoapods完成安装。第 2 步在 Podfile 中写入 Dance 依赖进入你的工程根目录创建或编辑Podfile文件填入以下内容platform :ios, 10.0 target 你的工程名 do use_frameworks! pod Dance end保存后你的 Podfile 就配置完成了。第 3 步执行 pod install 安装命令继续在终端中执行pod install命令执行完毕后终端会提示安装成功。请注意从这一刻起你要打开的不再是.xcodeproj工程文件而是新生成的你的工程名.xcworkspace工作空间文件否则将无法识别 Dance 框架。第 4 步import Dance 验证安装打开.xcworkspace后在需要使用动画的文件顶部加上导入语句import Dance编译一次如果没有报错说明 CocoaPods 安装 Dance 已成功。 方法二拖拽导入 Dance.swift推荐快速体验如果你只是想在个人项目里快速体验或者不想引入任何依赖管理工具那直接拖拽源码文件是最快的方式。Dance 的完整实现只封装在一个文件里这让手动集成变得异常轻松。第 1 步获取 Dance.swift 源码使用 git 命令克隆仓库到本地git clone https://gitcode.com/gh_mirrors/dance1/Dance克隆完成后你会在根目录找到核心文件Dance.swift——这就是需要拖入工程的全部源码。第 2 步将 Dance.swift 拖入 Xcode 工程在 Xcode 中打开你的工程把Dance.swift从 Finder 直接拖拽到左侧的 Project Navigator 中。弹出对话框时务必勾选 Copy items if needed拷贝文件到工程目录并确认 Target 选中了你当前的 App然后点击 Finish。第 3 步import Dance 验证安装同样在需要使用动画的 Swift 文件顶部写入import Dance编译通过后拖拽导入方式就大功告成了。项目中的官方示例工程DanceExample/ViewController.swift覆盖了所有 API 的详细用法安装完成后非常值得打开对照学习。⚖️ CocoaPods 与拖拽导入怎么选两种安装方式各有优势下面的对比表帮你快速决策对比维度CocoaPods 安装拖拽导入 Dance.swift安装耗时约 1~2 分钟约 30 秒依赖管理自动集成升级方便手动维护源码团队协作通过 Podfile 统一版本需要手动同步文件适用场景正式项目、多库并存快速体验、个人项目简单来说追求规范与可维护性选 CocoaPods追求极速上手选拖拽导入。由于 Dance 只有一个源文件即使选择了拖拽方式后续想切换回 CocoaPods 也毫无成本。 常见安装问题与解决办法安装过程中如果遇到报错先对照排查下面几种高频问题1.pod: command not found说明 CocoaPods 未安装或环境变量未配置执行sudo gem install cocoapods后重试。2.No such module Dance通常是忘记打开.xcworkspace而是打开了.xcodeproj。关闭 Xcode 重新用工作空间打开再执行一次pod install。3. 编译报 Swift 版本或 API 不兼容错误请确认 Deployment Target 已设为 iOS 10.0 及以上且 Swift 版本满足要求。4. 拖拽后运行报 Cannot find Dance in scope检查Dance.swift是否勾选了当前 Target 的 membership在右侧 File Inspector 中确认并重新编译。 安装完成后30 秒跑通第一个 Dance 动画安装验证通过后把下面这段代码粘贴到你的viewDidLoad中运行即可看到效果let circle UIView(frame: CGRect(x: 100, y: 200, width: 80, height: 80)) circle.backgroundColor .red circle.layer.cornerRadius 40 view.addSubview(circle) circle.dance.animate(duration: 2.0, curve: .easeInOut) { $0.center self.view.center $0.transform CGAffineTransform(scaleX: 1.5, y: 1.5) }.addCompletion { _ in self.view.backgroundColor .green }.start()一个平滑放大并移动到屏幕中央的动画就完成了——这就是 Dance 的魅力创建、链式调用、监听完成一气呵成。现在你已经掌握了 Dance 的全部安装方法。无论是用 CocoaPods 快速集成还是拖拽一个文件即刻开跑都能让你以最低的成本拥抱这套优雅的 iOS 动画库。更多 API 细节可以随时查阅项目根目录的README.md官方文档动手试试吧【免费下载链接】DanceA radical elegant animation library for iOS.项目地址: https://gitcode.com/gh_mirrors/dance1/Dance创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考