https://github.com/skywinder/GaugeKit

Kit for building custom gauges + easy reproducible Apple's style ring gauges.
https://github.com/skywinder/GaugeKit

carthage cocoapods gauge gauge-plugin gaugekit gauges graphics ios-sdk swift

Last synced: 4 months ago
JSON representation

Kit for building custom gauges + easy reproducible Apple's style ring gauges.

• Host: GitHub
• URL: https://github.com/skywinder/GaugeKit
• Owner: skywinder
• License: mit
• Created: 2015-06-19T09:59:47.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2022-04-10T17:09:05.000Z (about 3 years ago)
• Last Synced: 2024-10-29T17:51:08.220Z (6 months ago)
• Topics: carthage, cocoapods, gauge, gauge-plugin, gaugekit, gauges, graphics, ios-sdk, swift
• Language: Swift
• Homepage: https://www.cocoacontrols.com/controls/gaugekit
• Size: 9.1 MB
• Stars: 1,025
• Watchers: 35
• Forks: 100
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-swift - GaugeKit - Customizable gauges. Easy reproduce Apple's style gauges. (Libs / UI)
• awesome-swift - GaugeKit - Customizable gauges. Easy reproduce Apple's style gauges. (UI)
• awesome-cocoa - GaugeKit
• awesome-swift - GaugeKit - Customizable gauges. Easy reproduce Apple's style gauges. (Libs / UI)
• awesome-ios-star - GaugeKit - Customizable gauges. Easy reproduce Apple's style gauges. (UI / Font)
• fucking-awesome-swift - GaugeKit - Customizable gauges. Easy reproduce Apple's style gauges. (Libs / UI)
• awesome-swift-cn - GaugeKit - Customizable gauges. Easy reproduce Apple's style gauges. (Libs / UI)
• Awesome-Mobile-UI - GaugeKit
• awesome-ios - GaugeKit - Customizable gauges. Easy reproduce Apple's style gauges. (UI / Font)
• awesome-swift - GaugeKit - Kit for building custom gauges + easy reproducible Apple's style ring gauges. ` 📝 a year ago ` (UI [🔝](#readme))

README

        
[![Version](https://img.shields.io/cocoapods/v/GaugeKit.svg?style=flat)](http://cocoapods.org/pods/GaugeKit)

[![Build Status](https://travis-ci.org/skywinder/GaugeKit.svg)](https://travis-ci.org/skywinder/GaugeKit)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

![language](https://img.shields.io/badge/Language-%20Swift%20-orange.svg)

[![License](https://img.shields.io/cocoapods/l/GaugeKit.svg?style=flat)](http://cocoapods.org/pods/GaugeKit)

[![Platform](https://img.shields.io/cocoapods/p/GaugeKit.svg?style=flat)](http://cocoapods.org/pods/GaugeKit)



# GaugeKit

##Kit for building custom gauges + easy reproducible Apple's style ring gauges.



->



## Example Usage

Open `GaugeKit.xcworkspace` and change the scheme to 'Example' and run Example project.

## Installation

### CocoaPods

[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects.

GaugeKit is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

```ruby

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '8.0'

use_frameworks!

pod "GaugeKit"

```

### Carthage

To integrate GaugeKit into your Xcode project using Carthage, specify it in your `Cartfile`:

```ogdl

github "skywinder/GaugeKit" >= 0.2

```

#### Embedded Framework

Add GaugeKit as a [submodule](http://git-scm.com/docs/git-submodule) by opening the Terminal, `cd`-ing into your top-level project directory, and entering the following command:

```bash

$ git submodule add https://github.com/skywinder/GaugeKit.git

```

### Manually

If you prefer not to use either of the aforementioned dependency managers, you can simply add swift files into your project manually.

## Features :sparkles:

- Flexible and high-customizible gauges

- Auto-resized views

- Support `@IBInspectable` & `@IBDesignable`

- Written with vanilla `Swift` flavor :baby_chick:

## Usage :rainbow:

- Put on storyboard `UIView`, and set them class `Gauge` and module `GaugeKit`:

![GaugeKit](https://raw.githubusercontent.com/skywinder/GaugeKit/master/Images/IB_class.png)

- Select type of gauge (property `type` in class or `gaugeTypeInt` for changes directly in Interface builder)

       - case `Circle`

       - case `Left`

       - case `Right`

       - case `Line`

##Example:

![GaugeKit](https://raw.githubusercontent.com/skywinder/GaugeKit/master/Images/GaugeKit_sreenshot.png)

![GaugeKit](https://raw.githubusercontent.com/skywinder/GaugeKit/master/Images/SWGauge_example.gif)

###IB Example:

![GaugeKit](https://raw.githubusercontent.com/skywinder/GaugeKit/master/Images/ib_example_1.gif)

## Requirements

- iOS SDK **7.0** or **later** (iOS SDK **8.0** if you use it as a Framework)

- **Swift 1.2** and **Xcode 6.3** or later

- **Swift 2.x.x** is also supported!

## Communication :speaker:

Bug reports, feature requests, patches, well-wishes are always welcome!

- If you need help, [open an issue](https://github.com/skywinder/GaugeKit/issues/new).

- If you found a bug, [open an issue](https://github.com/skywinder/GaugeKit/issues/new).

- If you have a feature request, [open an issue](https://github.com/skywinder/GaugeKit/issues/new).

- If you want to contribute, see [Contributing](https://github.com/skywinder/GaugeKit#contributing-octocat) section.

## Contributing :octocat:

I'd love to see your ideas for improving this library.

The best way to contribute is by submitting a pull request.

## Contributors

### Code Contributors

This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].























## License

GaugeKit is available under the MIT license. See the LICENSE file for more info.