Merge branch 'release-candidate' into stable
tree: 47bb451df7ed2fcddf858cc57f9ac4f57e9cb26c
  1. .github/
  2. catalog/
  3. components/
  4. contributing/
  5. demos/
  6. docs/
  7. scripts/
  8. snapshot_test_goldens/
  9. .arclint
  10. .arcunit
  11. .clang-format
  12. .clang-format-ci
  13. .codecov.yml
  14. .gitattributes
  15. .gitignore
  16. .gitmodules
  17. .kokoro
  18. .mdc-docsite.yml
  19. .swiftlint.yml
  20. .travis.yml
  21. AUTHORS
  22. BUILD
  23. CHANGELOG.md
  24. CODE_OF_CONDUCT.md
  25. CODEOWNERS
  26. CONTRIBUTING.md
  27. ISSUE_TEMPLATE.md
  28. LICENSE
  29. material_components_ios.bzl
  30. MaterialComponents.podspec
  31. MaterialComponentsBeta.podspec
  32. MaterialComponentsEarlGreyTests.podspec
  33. MaterialComponentsExamples.podspec
  34. MaterialComponentsSnapshotTests.podspec
  35. mdc_hero.png
  36. PULL_REQUEST_TEMPLATE.md
  37. README.md
  38. ROADMAP.md
  39. VERSION
  40. WORKSPACE
README.md

Material Components for iOS

Build Status Code coverage

Material Components for iOS (MDC-iOS) helps developers execute Material Design. Developed by a core team of engineers and UX designers at Google, these components enable a reliable development workflow to build beautiful and functional iOS apps. Learn more about how Material Components for iOS supports design and usability best practices across platforms in the Material Design Platform Adaptation guidelines.

Material Components for iOS are written in Objective-C and support Swift and Interface Builder.

Useful Links

Trying out Material Components

CocoaPods is the easiest way to get started (if you're new to CocoaPods, check out their getting started documentation.)

To install CocoaPods, run the following commands:

sudo gem install cocoapods

Our catalog showcases Material Components. You can use the pod try command from anywhere on your machine to try the components, even if you haven't checked out the repo yet:

pod try MaterialComponents

In case you have already checked out the repo, run the following command:

pod install --project-directory=catalog/

The component implementations can be found in Xcode within Pods > Development Pods > MaterialComponents.

Requirements

  • Xcode 9 or higher
  • Minimum iOS deployment target of 9.0 or higher
  • CocoaPods 1.5 or higher

Attributions

Material Components for iOS uses Material Design icons, copyright Google Inc. and licensed under CC BY 4.0.

Several components use MDFTextAccessibility, copyright Google Inc. and licensed under Apache 2.0 without a NOTICE file.

MDCCatalog uses the Roboto font, copyright 2011 Google Inc. and licensed under Apache 2.0 without a NOTICE file.