CNPPopupController 项目使用教程

1. 项目的目录结构及介绍

CNPPopupController 是一个用于在 iOS 应用中展示自定义弹窗的开源项目。项目的目录结构如下：

CNPPopupController/
├── CNPPopupController.xcodeproj
├── CNPPopupControllerExample/
│   ├── CNPPopupControllerExample.xcodeproj
│   ├── CNPPopupControllerExampleSwift.xcodeproj
│   ├── CNPPopupControllerExampleTests
│   └── ...
├── .gitignore
├── CNPPopupController.podspec
├── LICENSE
└── README.md

• CNPPopupController.xcodeproj: 项目的主工程文件，用于构建 CNPPopupController 本身。
• CNPPopupControllerExample/: 包含示例项目的目录，用于展示如何使用 CNPPopupController。
  • CNPPopupControllerExample.xcodeproj 和 CNPPopupControllerExampleSwift.xcodeproj: 示例项目的工程文件，分别对应 Objective-C 和 Swift 语言版本。
  • CNPPopupControllerExampleTests: 示例项目的测试代码。
• .gitignore: 指定在版本控制中应该忽略的文件和目录。
• CNPPopupController.podspec: CocoaPods 的配置文件，用于将 CNPPopupController 发布为 CocoaPods 包。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的自述文件，包含项目介绍和使用说明。

2. 项目的启动文件介绍

要开始使用 CNPPopupController，你需要先设置示例项目。以下是启动 Objective-C 版本示例项目的步骤：

1. 打开 CNPPopupControllerExample.xcodeproj 文件。
2. 编译并运行示例项目。

Swift 版本的启动步骤类似，只需打开 CNPPopupControllerExampleSwift.xcodeproj 文件即可。

示例项目会展示 CNPPopupController 的基本用法，你可以通过修改示例项目来学习如何在自己的应用中集成和使用 CNPPopupController。

3. 项目的配置文件介绍

CNPPopupController 的配置主要通过其属性和方法来完成。以下是一些主要的配置选项：

• theme: 弹窗主题，可以通过创建 CNPPopupTheme 实例来定制背景颜色、圆角、内边距、样式、展示方式、遮罩类型等。
• dismissesOppositeDirection: 是否在弹出方向相反的方向上消失。
• shouldDismissOnBackgroundTouch: 是否在触摸遮罩背景时关闭弹窗。
• movesAboveKeyboard: 当键盘出现时，是否将弹窗移动到键盘上方。
• contentVerticalPadding: 内容的垂直填充。
• maxPopupWidth: 弹窗的最大宽度。
• animationDuration: 动画持续时间。

要配置 CNPPopupController，你需要创建一个实例，并设置相应的属性，如下所示：

CNPPopupController *popupController = [[CNPPopupController alloc] initWithContents:@[customView]];
popupController.theme = [CNPPopupTheme new]; // 配置主题
popupController.theme.backgroundColor = [UIColor whiteColor]; // 设置背景颜色
popupControllerDismissesOppositeDirection = YES; // 设置弹窗消失方向
// ... 其他配置

[popupController presentPopupControllerAnimated:YES]; // 显示弹窗

在实际应用中，根据需要调整这些配置以实现预期的弹窗效果。