Swiftpack.co -  LambdaDigamma/swift-license-ui as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
LambdaDigamma/swift-license-ui
A package to display settings bundle licenses in your iOS app
.package(url: "https://github.com/LambdaDigamma/swift-license-ui.git", from: "1.0.0")

Screenshots

LicenseUI

This package parses your Settings.bundle for licenses generated with the LicensePlist package by Masayuki Ono. You can also provide static licenses by passing LicenseItem to the view model or create your own LicenseLoader implementation. Some of the most popular license terms can be retrieved using the License enum.

Installation

Install LicenseUI with Swift Package Manager:

dependencies: [
    .package(name: "LicenseUI", url: "https://github.com/lambdadigamma/swift-license-ui", .upToNextMajor(from: "1.0.0")),
]

Documentation

You can render the default user interface shipped with this package by using the LicenseList and its corresponding view model LicensesViewModel . The license terms are displayed in a LicenseDetailView.

Be aware that the default implementation is based on a SwiftUI List and needs to be embedded in a navigation context.

Rendering a license list from settings bundle

To render licenses in your Settings.bundle generated with the LicensePlist package, you can display the list like that:

LicensesList(viewModel: LicensesViewModel())

Rendering a static license list or custom loader

To render a static list of licenses you can either use the StaticLicenseLoader or the convenience initializer:

LicensesList(viewModel: LicensesViewModel(licenses: licenses))

Or use a custom loader:

LicensesList(viewModel: LicensesViewModel(loader: CustomLicenseLoader()))

Rendering a custom user interface

To render a custom user interface you can still use the LicensesViewModel to power it. The view model publishes the array licenses which you can use in your view. Just make sure to call viewModel.load() at a given time to execute the provided loader.

Using custom license loader

Licenses are being loaded by loaders conforming to the LicenseLoader protocol. Loaders only need to implement a load method which returns an array of LicenseItem. The default StaticLicenseLoader implementation looks like this:

public class StaticLicenseLoader: LicenseLoader {

    public let licenses: [LicenseItem]

    public init(licenses: [LicenseItem] = []) {
        self.licenses = licenses
    }

    public func load() -> [LicenseItem] {
        return licenses
    }

}

Roadmap

  • ☑ Implement Settings.bundle parsing
  • ☑ Implement a static LicenseLoader
  • ☑ Implement rendering license list and license terms
  • ☑ Add the most popular licenses
  • ☐ Support more localizations

Changelog

Please see CHANGELOG.md for more information what has changed recently.

Contributing

Contributions are always welcome!

Credits

License

swift-license-ui is available under the MIT license. See the LICENSE.md file for more info.

GitHub

link
Stars: 1
Last commit: 1 week 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.

Release Notes

LicenseUI 1.0.0
1 week ago

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