README

摘要

PiOS PIAPIEnvironmentManager POD，用于帮助 iOS 程序员在 iOS 应用中管理 API 环境。轻轻摇晃设备即可轻松切换环境，并且当前环境将保留，即使关闭应用程序也是如此。

要求

此项目兼容 Xcode 6.4+ 和 Swift 2.0，所有早期版本均不受支持。

安装

要安装 PIAPIEnvironmentManager，只需将以下行添加到您的 Podfile 中

pod "PIAPIEnvironmentManager"

用法

PIAPIEnvironmentManager 提供了一个界面，使创建自己的 API 环境并与核心管理器一起使用变得简单。

首先，创建一个实现 PIAPIEnvironmentObject 协议的对象（类或结构体）；此协议定义了将对象视为有效的 PIAPIEnvironment 对象的接口。实现该协议的对象应尽量无状态，以保持与管理系统最大的兼容性。

接下来，通过传递自定义的 PIAPIEnvironmentObject 实现中定义的所有可能环境来创建 PIAPIEnvironmentManager 的实例。就是这样！APIEnvironmentManager 准备使用。

此项目还附带了一些额外的功能。

缓存

PIAPIEnvironmentManager 默认将当前选中的环境缓存在磁盘上并记住它，以便在会话间保留；而您仍然需要在应用程序启动时创建管理器并将其环境传递给它，但 PIAPIEnvironmentManager 设计得足够聪明，可以在加载时自动选择缓存的 环境，而无需手动进行。

默认情况下，PIAPIEnvironmentManager 使用 NSUserDefaults 来存储此信息。

如果您不想使用 NSUserDefaults，那么您很幸运！只需创建一个实现了 PIAPIEnvironmentCacheProvider 协议的对象，并将其通过 initWithEnvironments: cacheProvider: 方法传递给 PIAPIEnvironmentManager。就这样！PIAPIEnvironmentManager 将现在使用您的缓存来存储和检索已存储的信息，使您可以使用任何您想要的存储：NSKeyedArchiver、CoreData、Realm 等。

更改环境

PIAPIEnvironmentManager使得在会话之间管理环境变得容易，而PIAPIEnvironmentViewController则提供了一个简单、默认的界面来管理应用中的环境。只需使用initWithEnvironmentManager:创建一个新的实例，这就完成了！视图控制器现在将允许任何用户以最小的代价更改API环境。

内置手势

虽然您可以轻松创建并显示PIAPIEnvironmentManager，但此框架还包含了一种简单的方法来在任何地方查看环境切换器。只需使用PIInvokeManager setInvokeEvent: forManager:在任何地方设置一个手势来自动显示此用户界面。这种使用是完全可选的，但为管理环境提供了一个快速便捷的界面。

支持的手势

• 摇动
• 两指向左滑动

作者

Julio, [email protected] Chris, [email protected] Max, [email protected] Thibault, [email protected]

许可证

PIAPIEnvironmentManager遵循MIT许可证。有关更多信息，请参阅LICENSE文件。