MLStarRating
Swift项目的星星评分
需求
- iOS 10.0+ / tvOS 9.0+
- Xcode 9.0+
安装
依赖管理器
CocoaPods
CocoaPods是一个 cocoa 项目的依赖管理器。您可以使用以下命令安装它
$ gem install cocoapods
要使用CocoaPods将MLStarRating集成到Xcode项目中,请在Podfile中指定它
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!
pod 'MLStarRating', '~> 1.0.3'
然后,运行以下命令
$ pod install
Carthage
Carthage是一个集中式依赖管理器,它自动将框架添加到您的Cocoa应用中。
您可以使用以下命令使用Homebrew安装Carthage
$ brew update
$ brew install carthage
要使用Carthage将MLStarRating集成到Xcode项目中,请在Cartfile中指定它
github "micheltlutz/MLStarRating" ~> 1.0.3
Swift包管理器
要将MLStarRating作为Swift包管理器包使用,只需在Package.swift文件中添加以下内容。
// swift-tools-version:4.2
import PackageDescription
let package = Package(
name: "HelloMLStarRating",
dependencies: [
.package(url: "https://github.com/micheltlutz/MLStarRating.git", .upToNextMajor(from: "1.0.3"))
],
targets: [
.target(name: "HelloMLStarRating", dependencies: ["MLStarRating"])
]
)
手动
如果您不希望使用上述任何依赖管理器,可以手动将 MLStarRating 集成到您的项目中。
GIT 子模块
- 打开终端,
cd
到您的顶级项目目录,并运行以下命令(如果您的项目未初始化为 Git 仓库)
$ git init
- 使用以下命令将 MLStarRating 添加为 Git 子模块
$ git submodule add https://github.com/micheltlutz/MLStarRating.git
$ git submodule update --init --recursive
- 打开新的
MLStarRating
文件夹,并将MLStarRating.xcodeproj
拖入您应用 Xcode 项目的 Project Navigator 中。
它应该嵌套在您应用的蓝色项目图标下方。无论是位于所有其他 Xcode 组之上还是之下都无关紧要。
- 在 Project Navigator 中选择
MLStarRating.xcodeproj
并验证部署目标与您的应用程序目标一致。 - 接下来,在 Project Navigator(蓝色项目图标)中选择您的应用程序项目以导航到目标配置窗口,并在侧边栏的“Targets”标题下选择应用程序目标。
- 在该窗口顶部的选项卡栏中,打开“General”面板。
- 单击“Embedded Binaries”部分下的
+
按钮。 - 您将看到两个不同的
MLStarRating.xcodeproj
文件夹,每个文件夹内部都嵌套着两个不同版本的MLStarRating.framework
,位于 Products 文件夹内。
您可以选择任何一个 Products 文件夹。
-
选择
MLStarRating.framework
。 -
就是这样!
MLStarRating.framework
自动添加为目标依赖项、链接框架和嵌入框架的复制文件构建阶段,这是您在模拟器和设备上构建所需的所有内容。
嵌入的二进制文件
- 从 https://github.com/micheltlutz/MLStarRating/releases 下载最新版本
- 接下来,在 Project Navigator(蓝色项目图标)中选择您的应用程序项目以导航到目标配置窗口,并在侧边栏的“Targets”标题下选择应用程序目标。
- 在该窗口顶部的选项卡栏中,打开“General”面板。
- 单击“Embedded Binaries”部分下的
+
按钮。 - 添加下载的
MLStarRating.framework
。 - 就是这样!
使用方法
您需要在您的 Assets 中包含两个命名文件的照片
- emptyStar
- fullStar
import MLStarRating
let mlStarRating = MLStarRating()
mlStarRating.didChangeStar = { starCount in
print("Star selected: \(starCount)")
}
能否更改图像名称
let mlStarRating = MLStarRating()
mlStarRating.emptyStarImageName = "string name image"
mlStarRating.fullStarImageName = "string name image"
mlStarRating.setupStars() // to change configuration buttons
程序化更改选中星号
let mlStarRating = MLStarRating()
mlStarRating.selectedStar = 4
贡献
欢迎提交问题和Pull Request!
文档
请参阅文档
MLLineChart 文档(80% 已记载)
待办事项
- 100% 已记载
作者
Michel Anderson Lutz Teixeira @michel_lutz
贡献
许可协议
MLStarRating 在 MIT 许可下发布。详情见 LICENSE。