Latest 0.4.4
Homepage https://github.com/wingu-GmbH/wingu-ios-sdk-essentials
License Apache-2.0
Platforms ios 9.0
Frameworks UIKit, Foundation, CoreLocation
Authors ,

Version
License
Platform

wingu sdk essentials is an iOS SDK for managing triggers configured at wingu. It will range beacons and find geofences already with content attached.

wingu essentials is delivered to you in pre-compiled form .framework. It’s written in Swift 4.1

Table of Contents

  1. Installation
  2. Requirements
  3. Quick start guide
  4. Documentation
  5. License

Installation

Cocoapods

wingu-ios-sdk-essentials is available through CocoaPods. To install
it, add the following line to your Podfile:

pod 'wingu-ios-sdk-essentials'

Carthage

Carthage is a simple, decentralized dependency manager for Cocoa.

no-build option

Add this dependency to your Cartfile

github "wingu-GmbH/wingu-ios-sdk-essentials"

Please Note this is pre-compiled .framework, so there is only need to fetch it using Carthage not build. Use --no-build option in carthage command (ex: carthage update --platform iOS --no-build)

Direct link

Version of library can be downloaded using binary option in Cartfile. Add this line to Cartfile:

binary "https://raw.githubusercontent.com/wingu-GmbH/wingu-ios-sdk-essentials/master/wingu-ios-sdk-essentials.json"

Manual Installation

Copy winguSDKEssential.framework file from this repository to your project.

Requirments

There is a location permission needed to run an app and work with wingu channels. Add this keys into your Info.plist file:

NSLocationAlwaysAndWhenInUseUsageDescription
NSLocationWhenInUseUsageDescription

Quick start guide

This guide shows you how get triggers callbacks with default configuration. You can always have some custom parameters in scanners. For all available configuration please check our full documentation. Depends on a use case you may need winguLocations in only one model or in whole app.

We recommend create a one instance of winguLocations:

lazy var winguLocations: WinguLocations = {
    let winguLocations: WinguLocations = WinguLocations.shared
    winguLocations.delegate = self
    return winguLocations
}()

Your class should conform to protocol WinguLocationsDelegate and there you will receive all delegate callbacks from wingu triggers

extension YourClass: WinguLocationsDelegate { }

WinguLocationsDelegate requires only one method implemented to get triggers, but you can check full documentation. This required callback is:

func winguChannels(_ channels: [Channel]) {
    // your code here
}

Channel is default class for all wingu triggers. This method will return available list of channels in range and will also get called whenever some trigger are out of range or scanner found a new one.

You can start ranging beacons by calling

winguLocations.start()

See example project to learn more.

Documentation

Documentation is available here or through your IDE.

License

wingu-ios-sdk-essentials is available under the Apache-2.0 license. See the LICENSE file for more info.

Latest podspec

{
    "name": "wingu-ios-sdk-essentials",
    "version": "0.4.4",
    "summary": "Essentials part of wingu iOS SDK",
    "description": "Essentials part of wingu iOS SDK. Visit www.wingu.de to know more.",
    "homepage": "https://github.com/wingu-GmbH/wingu-ios-sdk-essentials",
    "license": {
        "type": "Apache-2.0",
        "file": "LICENSE"
    },
    "authors": {
        "Jakub Mazur": "[email protected]",
        "Mateusz Staruchowicz": "[email protected]"
    },
    "source": {
        "git": "https://github.com/wingu-GmbH/wingu-ios-sdk-essentials.git",
        "tag": "0.4.4"
    },
    "social_media_url": "https://twitter.com/wingude",
    "frameworks": [
        "UIKit",
        "Foundation",
        "CoreLocation"
    ],
    "platforms": {
        "ios": "9.0"
    },
    "source_files": "winguSDKEssential.framework/Headers/*",
    "vendored_frameworks": "winguSDKEssential.framework"
}

Pin It on Pinterest

Share This