企业官网建设流程全解析

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

【免费下载链接】DanceA radical & elegant animation library for iOS.项目地址: https://gitcode.com/gh_mirrors/dance1/Dance

Dance 是一款基于 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+"是硬性要求，因为 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 只有一个源文件，即使选择了拖拽方式，后续想切换回 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