FloatingButton 项目教程

FloatingButton 项目教程

FloatingButton Easily customizable floating button menu created with SwiftUI 项目地址: https://gitcode.com/gh_mirrors/fl/FloatingButton

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

FloatingButton 项目的目录结构如下：

FloatingButton/
├── FloatingButtonExample/
│   ├── Sources/
│   │   └── FloatingButton/
│   │       ├── MainButtonView.swift
│   │       ├── SubmenuButtonView.swift
│   │       └── FloatingButton.swift
│   ├── gitignore
│   ├── travis.yml
│   ├── FloatingButton.podspec
│   ├── LICENSE
│   ├── Package.swift
│   └── README.md
└── Example/
    └── Example.xcodeproj

目录结构介绍

• FloatingButtonExample/: 包含项目的示例代码和主要源文件。

  • Sources/FloatingButton/: 包含项目的主要源文件，如 MainButtonView.swift 和 SubmenuButtonView.swift，以及 FloatingButton.swift。
  • gitignore: Git 忽略文件，指定哪些文件和目录不需要被 Git 追踪。
  • travis.yml: Travis CI 配置文件，用于持续集成。
  • FloatingButton.podspec: CocoaPods 配置文件，用于集成到 CocoaPods 项目中。
  • LICENSE: 项目许可证文件，通常为 MIT 许可证。
  • Package.swift: Swift Package Manager 配置文件，用于集成到 SPM 项目中。
  • README.md: 项目说明文件，包含项目的基本信息和使用说明。

• Example/: 包含项目的示例工程文件，如 Example.xcodeproj。

2. 项目的启动文件介绍

项目的启动文件位于 FloatingButtonExample/Sources/FloatingButton/FloatingButton.swift。该文件定义了 FloatingButton 类，用于创建可自定义的浮动按钮菜单。

启动文件内容

import SwiftUI

public struct FloatingButton: View {
    // 主按钮视图
    let mainButtonView: AnyView
    // 子菜单按钮视图
    let buttons: [AnyView]
    // 菜单是否打开的绑定
    @Binding var isOpen: Bool

    public init(mainButtonView: AnyView, buttons: [AnyView], isOpen: Binding<Bool>) {
        self.mainButtonView = mainButtonView
        self.buttons = buttons
        self._isOpen = isOpen
    }

    public var body: some View {
        // 视图主体
    }
}

启动文件介绍

• mainButtonView: 主按钮视图，类型为 AnyView。
• buttons: 子菜单按钮视图数组，类型为 [AnyView]。
• isOpen: 绑定变量，用于控制菜单的打开状态。

3. 项目的配置文件介绍

3.1 FloatingButton.podspec

该文件用于配置 CocoaPods 集成。

Pod::Spec.new do |s|
  s.name             = 'FloatingButton'
  s.version          = '0.1.0'
  s.summary          = 'Easily customizable floating button menu created with SwiftUI.'
  s.description      = <<-DESC
  FloatingButton is a SwiftUI library that allows you to create easily customizable floating button menus.
  DESC
  s.homepage         = 'https://github.com/exyte/FloatingButton'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'Exyte' => 'info@exyte.com' }
  s.source           = { :git => 'https://github.com/exyte/FloatingButton.git', :tag => s.version.to_s }
  s.ios.deployment_target = '14.0'
  s.source_files = 'Sources/FloatingButton/**/*'
  s.swift_version = '5.3'
end

3.2 Package.swift

该文件用于配置 Swift Package Manager 集成。

// swift-tools-version:5.3
import PackageDescription

let package = Package(
    name: "FloatingButton",
    platforms: [
        .iOS(.v14),
        .macOS(.v11),
        .watchOS(.v7)
    ],
    products: [
        .library(
            name: "FloatingButton",
            targets: ["FloatingButton"]),
    ],
    dependencies: [],
    targets: [
        .target(
            name: "FloatingButton",
            dependencies: []),
    ]
)

配置文件介绍

• FloatingButton.podspec: 配置项目的名称、版本、描述、主页、许可证、作者、源代码地址、部署目标、源文件路径和 Swift 版本。
• Package.swift: 配置项目的名称、平台支持、产品、依赖和目标。

通过以上配置文件，开发者可以方便地将 FloatingButton 集成到自己的项目中。

FloatingButton Easily customizable floating button menu created with SwiftUI 项目地址: https://gitcode.com/gh_mirrors/fl/FloatingButton