安装或设置

安装

CocoaPods

CocoaPods 是 Cocoa 项目的依赖管理器。你可以使用以下命令安装它:

$ gem install cocoapods

构建 Alamofire 4.0.0+需要 CocoaPods 1.1.0+。

要使用 CocoaPods 将 Alamofire 集成到你的 Xcode 项目中,请在你的 Podfile 中指定它:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'Alamofire', '~> 4.0'
end

然后,运行以下命令:

$ pod install

迦太基

Carthage 是一个分散的依赖管理器,它构建你的依赖项并为你提供二进制框架。

你可以使用以下命令安装 Carthage with Homebrew

$ brew update
$ brew install carthage

要使用 Carthage 将 Alamofire 集成到你的 Xcode 项目中,请在你的 Cartfile 中指定它:

github "Alamofire/Alamofire" ~> 4.0

运行 carthage update 构建框架并将构建的 Alamofire.framework 拖入 Xcode 项目。

手动

如果你不想使用上述任何一个依赖关系管理器,则可以手动将 Alamofire 集成到你的项目中。

嵌入式框架

  • 将 Terminal,cd 打开到你的顶级项目目录中,并运行以下命令 if 你的项目未初始化为 git 存储库:
$ git init
  • 通过运行以下命令将 Alamofire 添加为 git 子模块
$ git submodule add https://github.com/Alamofire/Alamofire.git
  • 打开新的 Alamofire 文件夹,然后将 Alamofire.xcodeproj 拖到应用程序 Xcode 项目的 Project Navigator 中。

    它应该嵌套在应用程序的蓝色项目图标下面。无论是高于还是低于所有其他 Xcode 组并不重要。

  • 在 Project Navigator 中选择 Alamofire.xcodeproj,并验证部署目标是否与应用程序目标的目标匹配。

  • 接下来,在 Project Navigator 中选择你的应用程序项目(蓝色项目图标)以导航到目标配置窗口,并在侧栏中的 Targets 标题下选择应用程序目标。

  • 在该窗口顶部的标签栏中,打开常规面板。

  • 单击嵌入式二进制文件部分下的+按钮。

  • 你将看到两个不同的 Alamofire.xcodeproj 文件夹,每个文件夹都有两个不同版本的 Alamofire.framework 嵌套在 Products 文件夹中。

    你选择哪个 Products 文件夹并不重要,但无论你选择顶部还是底部 Alamofire.framework 都很重要。

  • 选择适用于 iOS 的顶级 Alamofire.framework 和适用于 OS X 的底部 Alamofire.framework

    你可以通过检查项目的构建日志来验证你选择的那个。Alamofire 的构建目标将列为 Alamofire iOSAlamofire macOSAlamofire tvOSAlamofire watchOS

  • 就是这样!

Alamofire.framework 作为目标依赖项,链接框架和嵌入式框架自动添加到复制文件构建阶段,这是构建模拟器和设备所需的全部内容。