/crittercism

Crash reporting for your RubyMotion app.

Primary LanguageRubyMIT LicenseMIT

Crittercism

Crittercism is the easiest way (that I've found) to add crash reporting to a RubyMotion application. This gem provides an even easier way to integrate the Crittercism SDK into your project.

Currently, this gem only supports iOS projects.

Installation

Add this line to your application's Gemfile:

gem 'crittercism'

And then execute:

$ bundle && rake pod:install

Usage

  1. Register for a Crittercism account.
  2. Register your app in Crittercism.
  3. Find your App ID and API Key on the App Settings page.

In your Rakefile, specify your Crittercism App ID and API Key:

Motion::Project::App.setup do |app|
  # ...
  app.crittercism_app_id = "YOUR_APP_ID"
  app.crittercism_api_key = "YOUR_API_KEY"
  # ...
end

Next, enable Crittercism within your app_delegate.rb:

class AppDelegate
  def application(app, didFinishLaunchingWithOptions: options)
    Crittercism.enableWithAppID("YOUR_APP_ID")
    # ...
  end
end

Refer to the Crittercism docs for information on how to use Crittercism's other features.

Uploading dSYM

This gem automatically uploads your dSYM file to Crittercism on every build. To disable dSYM upload on simulator builds, add this configuration to your Rakefile:

app.crittercism_disable_on_simulator_builds = true

If you want to manually upload your app's dSYM to Crittercism for symbolication, you can use the following Rake task:

$ rake crittercism:upload_dsym

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/andrewhavens/crittercism.

License

The gem is available as open source under the terms of the MIT License.