Home

Awesome

GitYourFeedback

Platform version Swift Version

A lot of organizations run on GitHub, not just for the code repositories, but also for the heavy use of Issues, the bug tracking/feedback reporting tool. Instead of routing your users to GitHub and expecting them to file issues, this is an option to support it right from inside your iOS application.

Example

To run the example project:

The client will look like:

Screenshot

While the resulting GitHub issue will look like:

Screenshot

Requirements

Dependencies

Installation

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

pod "GitYourFeedback"

Or, if you’re using Carthage, add GitYourFeedback to your Cartfile:

github "gabek/GitYourFeedback"

  1. Generate a Personal Access Token for the GitHub user who will be saving the issues in your repo.

  2. In your project's Info.plist add a key of NSPhotoLibraryUsageDescription with a string explaining that your use of the photo library is for submitting screenshots. This is user-facing so use your own judgement.

  3. Create a FeedbackReportingOptions object and fill in the properties. As simple as:

let feedbackOptions = FeedbackReportingOptions(token: "abc123", user: "repoman", repo: "repoman/myRepository")

Alternatively you can create your own struct that adheres to the FeedbackOptions protocol and use that instead. So you don't have to keep all the intialization values inline.

  1. In your AppDelegate, or some other long-lived controller:
let feedbackReporter = FeedbackReporter(options: feedbackOptions, datasource: self)

You'll need to implement FeedbackReporterDatasource in order to tell the FeedbackReporter where to upload screenshots. The simplest implementation would be something like:

func uploadUrl(_ completionHandler: (String) -> Void) {
    let filename = String(Date().timeIntervalSince1970) + ".jpg"
    let url = "https://www.googleapis.com/upload/storage/v1/b/mybucketname.appspot.com/o?name=\(filename)"
    completionHandler(url)
}

This is also where you could generate, possibly from your backend, a signed URL so the Google Cloud Storage bucket doesn't need to be completely public.

There are other methods you can implement as well, to provide additional information in the issues that get filed.

func additionalData() -> String?
func issueLabels() -> [String]?

Presenting the Feedback interface

The interface will automatically display as a result of a user taking a screenshot. If this is the first time the user has taken a screenshot in your application they will be greeted with an iOS permissions dialog stating they need to grant your app access to the user's Photos in order to use the screenshot. You may want to emphasize that the user should accept this. It uses the copy you added in your Info.plist's NSPhotoLibraryUsageDescription key.

You could also manually fire feedback.display() with an optional specific view controller to present from. With this approach the user will have to select their own screenshot manually if they want to send one.

Demo

Author

Gabe Kangas, gabek@real-ity.com. @gabek

Icon credits: designed by Madebyoliver from Flaticon.

License

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