Swiftpack.co - microsoft/fluentui-apple as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
microsoft/fluentui-apple
UIKit and AppKit controls for building native Microsoft experiences
.package(url: "https://github.com/microsoft/fluentui-apple.git", from: "0.3.5")

Fluent UI Apple

Fluent UI Apple contains native UIKit and AppKit controls aligned with Microsoft's Fluent UI design system.

Build Status Localization Status CocoaPod Publishing Build Status License CocoaPods Compatible Platform

Getting Started

Install and use FluentUI

Requirements

  • iOS 13+ or macOS 10.14+
  • Xcode 12.5+
  • Swift 5.4+

Using Swift Package Manager

To integrate FluentUI using SwiftUI, specify it as a dependency in your Xcode project or Package.swift file:

dependencies: [
    .package(url: "https://github.com/microsoft/fluentui-apple.git", .upToNextMinor(from: "X.X.X")),
],

Using CocoaPods

To get set up with CocoaPods visit their getting started guide.

To integrate FluentUI into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'MicrosoftFluentUI', '~> X.X.X'

Manual installation

  • Download the latest changes from the FluentUI for Apple repository.
  • Move the fluentui-apple folder into your project folder.
  • Move the relevant FluentUI.xcodeproj into your Xcode project depending on which platform you want to support.
  • In Xcode select your project -> your target -> General -> Embedded Binaries -> add libFluentUI.a.

Import and use FluentUI

After the framework has been added you can import the module to use it:

For Swift

import FluentUI

For Objective-C

#import <FluentUI/FluentUI-Swift.h>

Contributing

Post bug reports, feature requests, and questions in Issues.

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

CocoaPods Setup

If you are using Apple Silicon M1 machine then you need to install ffi in addition to CocoaPods. More details about the issue can be found here.

sudo arch -x86_64 gem install ffi

To execute any pod command on M1 machine you need to specify the architecture of the machine explicitly

arch -x86_64 pod lib lint

Developing in the repo

Fluent UI Apple requires all pull requests to come from forks of the repository. Please see Fork a Repo - GitHub Help for more details on how to set up a fork of Microsoft/fluentui-apple, keep it up-to-date, and submit pull requests back to this repository.

Fluent UI Apple doesn't have any external code dependencies, so developing in the repository is as easy as launching the appropriate Xcode project or workspace and building and running a test app.

For more platform-specific information, please see the iOS readme file and the the macOS readme file.

Swift Lint

This project uses SwiftLint to automatically lint our Swift code for common errors. Please install it when developing in this repo by following the SwiftLint Installation Instructions.

Changelog

We use GitHub Releases to manage our releases, including the changelog between every release. You'll find a complete list of additions, fixes, and changes on the Releases page.

License

All files on the FluentUI Apple GitHub repository are subject to the MIT license. Please read the LICENSE file at the root of the project.

Usage of the logos and icons referenced in FluentUI Apple is subject to the terms of the assets license agreement.

GitHub

link
Stars: 532
Last commit: 17 hours ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Release Notes

Version 0.3.5
3 days ago

What's new:

iOS:

  • ActivityIndicator (Vnext): New Vnext control with support for the Design Token System, SwiftUI and UIKit. Replaces the ActivityIndicatorView.
  • Swift Package Manager support: fixes Design Token System resource bundle reference that causes a crash when FluentUI is consumed through SPM
  • IndeterminateProgressBar: Fixes animation issue on iOS 15 where flickering and unwanted faster speed animations were caused by out of sync onAppear and onDisappear events
  • FluentUIHostingController: Fix for the entire library where the safe area insets workaround for UIHostingController was also affecting any other instance of the UIHostingController out of the FluentUI Vnext scope.
  • NavigationBar: Fixes for color and design changes caused by new behaviors of iOS 15.
  • TabBarItemView: Accessibility fix for issue where items on the tab bar were not accessible through keyboard navigation on iPhone.
  • TabBarView: Accessibility fix for issue where the Voice Over support was reading the index position twice on iOS 14.6 and later.

Mac:

  • New FilledTemplateImageView added to make it easy to create icon type images with different fill and border colors.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics