Doric 1.0.0

Doric 1.0.0

Jay K. 维护。



Doric 1.0.0

  • 作者
  • Jay K.

Doric: Design System Foundation in Swift

Build Status CocoaPods Compatible Carthage compatible Platform

Doric: 设计系统基础

Swift 编写的面向协议、类型安全且可扩展的 iOS 设计系统基础框架。

特性

  • typography
  • iconography
  • 颜色调
  • 动态可缩放字体支持
  • 自动布局
  • 渐变、阴影、边框和其他比例
  • 布局间距
  • 主题
  • UI 调试辅助工具
  • API 文档 < a href="Documentation/Usage.md">使用文档

路线图

没有特定的顺序来实现它。

  • 添加调试工具(标尺等)
  • 扩展框架以创建更多样式
  • 颜色处理实用工具
  • 基于特征的布局 (UITraitCollection)
  • 颜色调的辅助功能
  • Sketch 插件以生成样式

使用指南

需求

  • iOS 11.0+
  • Xcode 10.0+
  • Swift 4.2+

演示

  • 运行演示项目 预览

安装

CocoaPods

CocoaPods 是一个用于 Objective-C、Swift 以及在其他基于 Objective-C 运行时语言上的应用程序级别的依赖管理器,它提供了一套标准格式来管理外部库。有关使用和安装说明,请访问 网站

要使用 CocoaPods 集成 Doric,请在您的 Podfile 中指定它

pod 'Doric', '~> 1.0.0'

Carthage

Carthage 生成您的依赖并提供二进制框架,但您可以完全控制项目结构和设置。Carthage 不会自动修改项目文件或您的构建设置。

。要使用 Carthage 将 Doric 集成到您的 Xcode 项目中,请在您的 Cartfile 中指定它

github "jayeshk/Doric" ~> 1.0.0

手动

如果可以使用以下 git 子模块手动集成项目

嵌入式框架

  • 打开终端,切换到您的顶级项目目录,如果您的项目尚未初始化为git仓库,请运行以下命令:

    $ git init
  • 通过以下命令将Doric添加为git子模块:

    $ git submodule add https://github.com/jayeshk/Doric.git
  • 打开新的Doric文件夹,并将Doric.xcodeproj拖入项目导航器。

    它应该显示在您的应用程序蓝色项目图标之下。它是在所有其他Xcode组之上还是之下无关紧要。

  • 在项目导航器中选择Doric.xcodeproj,并验证部署目标与您的应用程序目标相匹配。

  • 接下来,在项目导航器中选择您的应用程序项目,进入目标配置窗口,并在侧边栏的“targets”标题下选择应用程序目标。

  • 在该窗口的顶部标签栏中,打开“General”面板。

  • 在“Embedded Binaries”部分下点击“+”按钮。

  • 您将在“Products”文件夹中看到嵌套的Doric.framework。选择iOS的Doric.framework。

    您可以通过检查项目构建日志来验证您选择了哪个。Doric的构建目标将被列为Doric。

    Doric框架会自动作为目标依赖项、链接框架和嵌入式框架添加到复制文件构建阶段,这是在模拟器和设备上构建所需的一切。

贡献

Doric欢迎贡献,详见贡献指南。

  • 如果您想贡献,请提交一个pull请求。
  • 如果您发现了bug,请打开一个issue。
  • 如果您需要关于功能的使用帮助或需要讨论最佳实践,请参考使用文档,如果有任何事情需要讨论,请联系我。

常见问题问答

关于Doric的名称?

多利亚式是古希腊和后来罗马建筑中的三种主要风格之一,多利亚式以多利亚式命名。因此,它为您的数字产品提供了支柱。

为什么需要设计系统?

随着设备屏幕变体和环境的增加,创建可扩展的界面设计系统是有必要的。

多利亚式的主要目标是创建一个系统,允许您可以以规模管理iOS的设计。重点是跨应用的一致性、可扩展性和效率。见出色的设计系统

需要实现多利亚式的所有部分吗?

多利亚式提供了各种接口组件以便实现。所有组件均可以独立使用,也可以根据需要组合使用。例如,您的应用程序可以使用排版或色彩调色板。更好的做法是将所有这些组合成一个单一的设计系统。

它还允许您与其他第三方框架结合使用这些组件。例如,间距和布局可以用于其他任何第三方框架。

作为面向协议的框架,您还可以扩展任何部分并自定义它们。多利亚式附带了一些默认实现。参阅使用指南以获取更多信息。

鸣谢

Doric受到了各种设计系统指南和许多stackoverflow帖子的启发。

主要灵感来源原子设计

Brad Frost,《原子设计》的作者:“由众多构成界面的小块组成的完整集合”。


许可证

Doric基于MIT许可证发布。有关详细信息,请参阅LICENSE。