BulletinBoard项目迁移至V2版本指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00836/article/details/148505468

BulletinBoard项目迁移至V2版本指南

BulletinBoard General-purpose contextual cards for iOS 项目地址: https://gitcode.com/gh_mirrors/bu/BulletinBoard

前言

BulletinBoard是一个优秀的iOS通知面板库，它可以帮助开发者快速构建美观、交互性强的通知界面。近期发布的V2版本带来了诸多改进和新特性，本文将详细介绍如何从V1版本平滑迁移至V2版本。

V2版本主要改进

V2版本于2018年5月28日发布，主要改进包括：

更强大的自定义能力
更优雅的开发者体验
更清晰的API设计
更灵活的界面构建方式

迁移步骤详解

1. 模块导入变更

由于兼容性考虑，模块名称已从BulletinBoard变更为BLTNBoard。

Swift项目修改

// 旧版本导入方式
// import BulletinBoard

// 新版本导入方式
import BLTNBoard

Objective-C项目修改

// 旧版本导入方式
// #import <BulletinBoard/BulletinBoard.h>

// 新版本导入方式
#import <BLTNBoard/BLTNBoard.h>

2. 类名变更

V2版本中，大多数类名都添加了BLTN前缀以提高一致性。下面是新旧类名对照表：

| 旧版本类名 (<=v1.3.0) | 新版本类名 (v2.0.0) | |----------------------|-------------------| | BulletinItem | BLTNItem | | BulletinManager | BLTNItemManager | | PageBulletinItem | BLTNPageItem | | BulletinPadding | BLTNSpacing | | BulletinBackgroundViewStyle | BLTNBackgroundViewStyle | | HighlightButtonWrapper | BLTNHighlightButtonWrapper |

3. 界面工厂重构

BulletinIterfaceFactory类被拆分为两个独立实体：

BLTNItemAppearance - 负责管理项目的外观样式
BLTNInterfaceBuilder - 负责构建界面元素

BLTNActionItem及其子类通过appearance属性提供外观配置。在自定义页面时，可以修改这个对象的属性来调整外观。

4. 展示通知面板

V2版本简化了通知面板的展示流程，不再需要手动调用prepare方法。

旧版本代码：

bulletinManager.prepare()
bulletinManager.presentBulletin(above: self)

新版本代码：

bulletinManager.showBulletin(above: self)

自定义通知项开发指南

V2版本彻底重构了自定义通知项的创建流程。如果你需要创建包含按钮和文本的页面，可以子类化BLTNPageItem并实现以下方法之一来提供需要添加的视图：

makeHeaderViewsWithInterfaceBuilder:
makeViewsUnderTitleWithInterfaceBuilder:
makeViewsUnderImageWithInterfaceBuilder:
makeViewsUnderDescriptionWithInterfaceBuilder:
makeFooterViewsWithInterfaceBuilder:

这些方法允许你在标准控件之外创建所需视图，而无需像旧版本那样重新创建所有控件。

自定义文本输入页面示例

下面是一个创建包含文本输入框的页面示例：

class TextFieldBulletinPage: FeedbackPageBLTNItem {
    var textField: UITextField!

    override func makeViewsUnderDescription(with interfaceBuilder: BLTNInterfaceBuilder) -> [UIView]? {
        textField = interfaceBuilder.makeTextField(
            placeholder: "First and Last Name", 
            returnKey: .done, 
            delegate: self
        )
        return [textField]
    }
}

// 使用示例
let page = TextFieldBulletinPage(title: "Enter your Name")
page.descriptionText = "This will be displayed on your profile page."
page.actionButtonTitle = "Save"