Latest 0.1.0
Homepage https://github.com/bontoJR/Judex
License MIT
Platforms ios 9.0, osx 10.10, requires ARC
Authors

Intro

Jude is a battery included App Review Manager for iOS and macOS in Swift.

The library is heavily based on and inspired by iRate and appirater, 2 well known Objective-C libraries for App Store rating working for iOS and macOS. Judex aims to be a good alternative 100% written Swift.

Getting Started

Installation

Install Judex is pretty straight forward with Cocoapods:

pod 'Judex'

To manual install, copy the Judex.swift file and Judex.bundle in your project and you are good to go!

Configuration

To configure Judex just use:

Judex.shared.daysUntilPrompt = 10
Judex.shared.usesUntilPrompt = 15
Judex.shared.remindPeriod = 3 // days

If you want to manually check or present the alert, use:

// returns a boolean indicating if conditions are matching
Judex.shared.promptIfRequired()

// force prompting
Judex.shared.promptForRating() 

If you want to use a custom alert library in iOS, you can use the following callback:

public var customPrompt: ((_ viewController: UIViewController) -> Void)? = nil

You can then use the three functions to process the user’s action:

// User rated
self.rate()

// User asked for reminding later (next release)
self.remindLater()

// User declined 
self.decline()

Manual

Judex self configures itself based on the bundle id, in case you need more control, you can force the bundleID name and App Store ID:

Judex.shared.applicationBundleID = "developer.apple.wwdc-Release" //WWDC app

In case you use the same bundle ID for a macOS and iOS app, you can configure the App Store ID directly, to avoid conflicts:

Judex.shared.appStoreId = 284910350 // Yelp for iPhone

Development

Judex uses the [Judex] log prefix, if you want to activate the debug logs, add this to your code:

Judex.shared.verbose = true

License

MIT of course.

Release Notes

Version 0.1.0:

* Initial release

Latest podspec

{
    "name": "Judex",
    "version": "0.1.0",
    "summary": "A battery included App Review Manager for iOS and macOS in Swift",
    "description": "A battery included App Review Manager for iOS and macOS in Swift.n* 100% Swift (3.0)n* Support for iOS and macOSn* Flexiblen* Configurable at Runtimen* Inbludes Default Localizations for more than 30 Languagesn* Simple Installation",
    "homepage": "https://github.com/bontoJR/Judex",
    "social_media_url": "https://twitter.com/bontoJR",
    "authors": {
        "Junior B.": "[email protected]"
    },
    "source": {
        "git": "https://github.com/bontoJR/Judex.git",
        "tag": "0.1.0"
    },
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "source_files": "Judex/*.swift",
    "resources": "Judex/Judex.bundle",
    "platforms": {
        "ios": "9.0",
        "osx": "10.10"
    },
    "requires_arc": true,
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This