Latest 0.5.0
Homepage https://github.com/dtrenz/BugShaker
License Apache 2.0
Platforms ios 9.0, requires ARC
Frameworks UIKit, MessageUI
Authors

BugShaker

Shake to send a bug report!

CI Status
Version
License
Platform
Swift Version
codecov.io
Sponsored by Detroit Labs

BugShaker allows your users to simply submit bug reports by shaking the device.
When a shake is detected, the current screen state is captured and the user is
prompted to submit a bug report via a mail composer with the screenshot attached.

Android developers: If you are looking for an Android library with similar functionality, check out stkent/bugshaker-android.

Screenshots

Report Prompt
Report Compose View

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

All you have to do to enable bug reporting is import BugShaker in your AppDelegate
and call the configure() method in application:didFinishLaunchingWithOptions,
passing in the array of email recipients and an optional custom subject line:

  import BugShaker

  @UIApplicationMain
  class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
      /**
      *  Configure ShakeReport with an array of email recipients (required)
      *  and an optional custom subject line to use for all bug reports.
      */
      BugShaker.configure(to: ["[email protected]"], subject: "Bug Report")

      return true
    }

  }

NOTE: There is a known issue with using a mail compose view controller in a simulator.
The mail view will either not display at all, or possibly crash the simulator. You will need
to run the example on a device to test out the full report compose view functionality.

Disabling

If you need to disable BugShaker’s shake detection for any reason:

BugShaker.enabled = false

Installation

BugShaker is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod "BugShaker"

Author

Dan Trenz (@dtrenz) c/o Detroit Labs

License

BugShaker is available under the Apache License, Version 2.0. See the LICENSE file for more info.

Latest podspec

{
    "name": "BugShaker",
    "version": "0.5.0",
    "license": {
        "type": "Apache 2.0"
    },
    "homepage": "https://github.com/dtrenz/BugShaker",
    "documentation_url": "http://dtrenz.github.io/BugShaker/",
    "authors": {
        "Dan Trenz": "[email protected]"
    },
    "summary": "Shake to submit a bug report (w/ screenshot) via email.",
    "source": {
        "git": "https://github.com/dtrenz/BugShaker.git",
        "tag": "0.5.0"
    },
    "source_files": "Sources/*.swift",
    "swift_version": "4.2",
    "platforms": {
        "ios": "9.0"
    },
    "frameworks": [
        "UIKit",
        "MessageUI"
    ],
    "requires_arc": true,
    "description": "BugShaker allows your users to simply submit bug reports by shaking the device.nWhen a shake is detected, the current screen state is captured and the user isnprompted to submit a bug report via a mail composer with the screenshot attached.",
    "screenshots": [
        "https://raw.githubusercontent.com/dtrenz/BugShaker/develop/Screenshots/screenshot-1.png",
        "https://raw.githubusercontent.com/dtrenz/BugShaker/develop/Screenshots/screenshot-2.png"
    ],
    "social_media_url": "https://twitter.com/dtrenz"
}

Pin It on Pinterest

Share This