Natura Design System for iOS
用途
由Natura 集团设计系统团队定义的iOS组件库。
技术栈
- Swift 5
- 支持iOS 10到 14
- CocoaPods
- Swift 包管理器
- Fastlane
- Bitrise
- Swiftlint
- Jazzy
注意:对于版本6.2.0
及之前的版本,Git-LFS
也是一个依赖库。
如何安装
CocoaPods
CocoaPods 是用于 Swift 和 Objective-C Cocoa 项目的依赖管理器。您可以使用以下命令安装它:
gem install cocoapods
您也可以检查 Cocoapods 的 安装指南 了解其他选项。
要使用 CocoaPods 将 NatDS 集成到您的 Xcode 项目中,请在您的 Podfile
中指定它
target '<Your Target Name>' do
pod 'NatDS'
end
然后,运行以下命令
pod install
Swift Package Manager
要使用 Swift Package Manager 在您的项目中使用 NatDS,您需要从 Xcode 菜单添加它。按照路径 文件 > Swift 包 > 添加包依赖
,然后提供此存储库的 git 地址:https://github.com/natura-cosmeticos/natds-ios.git
。Xcode 将管理导入。
如何配置
该库根据设计系统品牌主题提供组件,使用组件之前必须选择主题(通常在您的应用启动时进行)。所有可用的主题都是 AvailableTheme
枚举中的选项。
要选择一个主题,使用以下代码配置库:
DesignSystem().configure(with: AvailableTheme)
提示:此步骤是必需的。如果未使用品牌主题配置设计系统,将引发
fatalError
。
如何添加图标
此库没有设计系统图标。从版本 3.0.0
开始,它们存储在图标库 NatDSIcons,也可以与 Cocoapods 一起使用。
要使用图标,请在您的 Podfile
中指定其 pod。
target '<Your Target Name>' do
pod 'NatDSIcons'
end
如果您使用的是小于
3.0.0
的 NatDS 版本,库中有可用的图标。不过,一些较新的图标将不可用。
NatDSIcons 版本
要检查 NatDS Icons 可用的所有版本,您可以查看 变更日志,或从您的终端运行 pod 命令。
pod search NatDSIcons --simple
示例应用
示例应用提供了设计系统组件和词素的视觉和代码实现示例。要运行它,请下载此存储库,按照项目设置安装其依赖关系,然后构建并运行。