NatDS 8.2.3

NatDS 8.2.3

系统团队 - Natura SANatura 设计系统维护。



NatDS 8.2.3

  • 系统团队 - Natura SA

Natura Design System for iOS

Build Status CocoaPods Compatible

用途

Natura 集团设计系统团队定义的iOS组件库。

技术栈

  • Swift 5
  • 支持iOS 1014
  • 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

查看有关如何在代码中使用图标的文档。


示例应用

示例应用提供了设计系统组件和词素的视觉和代码实现示例。要运行它,请下载此存储库,按照项目设置安装其依赖关系,然后构建并运行。

查看如何使用示例应用。


主题、组件和词素

查看如何使用此库。


如何贡献

查看贡献指南。