Author: Andreas Linde <[email protected]>

Copyright (c) 2009 Andreas Linde. All rights reserved.
All rights reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

• (Automatically) send crash reports to a developers database
• Let the user decide per crash to (not) send data or always send
• The user has the option to provide additional information in the settings, like email address for contacting the user
• Give the user immediate feedback if the crash is known and will be fixed in the next update, or if the update is already waiting at Apple for approval, or if the update is already available to install

• Admin interface to manage the incoming crash log data
• Script to symbolicate crash logs on the database, needs to be run on a mac with access to the DSYM files
• Automatic grouping of crash files for most likely same kind of crashes
• Maintain crash reports and sort them by using simple patterns. Automatically know how many times a bug has occured and easily filter the new ones in the DB
• Assign bugfix versions for each crash group and define a status for each version, which can be used to provide some feedback for the user like: Bug already fixed, new version with bugfix already available, etc.

• /server/database_schema.sql contains all the default tables
• /server/crash_v200.php is the file that is invoked by the iPhone app
• /server/config.php contains database access information
• /server/test_setup.php simple script that checks if everything required on the server is available
• /server/admin/ contains all administration scripts
• /server/admin/symbolicate.php needs to be copied to a local mac, and the url has to be adjusted to access the scripts on your server

• Copy the server scripts to your web server: All files inside /server except the content of the /server/local directory
• Execute the SQL statements from database_schema.sql in your MySQL database on the web server

• Adjust settings in /server/CONFIG.PHP:

  $server = 'your.server.com'; // database server hostname $loginsql = 'database_username'; // username to access the database $passsql = 'database_password'; // password for the above username $base = 'database_name'; // database name which contains the below listed tables

• Adjust $default_amount_crashes, this defines the amount of crashes listed right away per pattern, if there are more, those are shown after clicking on a link at the end of the shortened list

• Adjust your local timezone in the last line: date_default_timezone_set('Europe/Berlin') (see http://de3.php.net/manual/en/timezones.php)

• If you DO NOT want to limit the server to accept only data for your applications:

  • set $acceptallapps to true

• Otherwise:

  • start the web interface
  • add the bundle identifiers of the permitted apps, e.g. "de.buzzworks.crashreporterdemo" (this is the same bundle identifier string as used in the info.plist of your app!)

• Invoke test_setup.php via the browser to check if everything is setup correctly and Push can be used or not

• If you are upgrading a previous edition, invoke 'migrate.php' first to update the database setup

• NOTICE: Push Notification requires the Server PHP installation to have curl addon installed!
• NOTICE: Push Notifications are implemented using Prowl iPhone app and web service, you need the app and an Prowl API key!
• Adjust settings in /server/CONFIG.PHP:
  • set $push_activated to true
  • if you don't want a push message for every new pattern, set $push_newtype to false
  • adjust $notify_amount_group to the amount of crash occurences of a pattern when a push message should be sent
  • add up to 5 comma separated prowl api keys into $push_prowlids to receive the push messages on the device
  • adjust $notify_default_version, defines if you want to receive pushes for automatically created new versions for your apps
• If push is activated, check the web interface for push settings per app version

• NOTICE: These are the instructions when using Mac OS X 10.6.2

• Copy the files inside of /server/local onto a local directory on your Intel Mac running at least Mac OS X 10.6.2 having the iPhone SDK 3.x installed

• Adjust settings in local/serverconfig.php

  • set $hostname to the server hostname running the server side part, e.g. www.crashreporterdemo.com
  • if the /admin/ directory on the server is access restricted, set the required username into $webuser and password into $webpwd
  • adjust the path to access the scripts (will be appended to $hostname):
    • $downloadtodosurl = '/admin/actionapi.php?action=getsymbolicationtodo'; // the path to the script delivering the todo list
    • $getcrashdataurl = '/admin/actionapi.php?action=getlogcrashid&id='; // the path to the script delivering the crashlog
    • $updatecrashdataurl = '/admin/crash_update.php'; // the path to the script updating the crashlog

• Copy the symbolicatecrash executable into an accessable path, e.g. via cp /Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/symbolicatecrash /usr/local/bin/

• Copy the .app package and .app.dSYM package of each version into any directory of your Mac Best is to add the version number to the directory of each version, so multiple versions of the same app can be symbolicated. Example:

  CrashReporterDemo_1_0/CrashReporterDemo.app
  CrashReporterDemo_1_0/CrashReporterDemo.app.dSYM
  CrashReporterDemoBeta_1_1/CrashReporterDemoBeta.app
  CrashReporterDemoBeta_1_1/CrashReporterDemoBeta.app.dSYM
  

• Test symbolification:

  • Download a crash report into the local directory from above
  • run symbolicatecrash nameofthecrashlogfile .
  • if the output shows function names and line numbers for your code and apples code, everything is fine and ready to go, otherwise there is a problem :(

• If test was successful, try to execute php symbolicate.php This will print some error message which can be ignored

• Open the web interface and check the crashlogs if they are now symbolicated

• If everything went fine, setup a cron job

• IMPORTANT: Don't forget to add new builds with .app and .app.dSYM packages to the directory, so symbolification will be done correctly There is currently no checking if a package is found in the directory before symbolification is started, no matter if it was or not, the result will be uploaded to the server

• Include CrashReportSender.h and CrashReportSender.m into your project

• Include CrashReporter.framework into your project

• Add the Apple framework SystemConfiguration.framework zu your project

• In your appDelegate.h include

  #import "CrashReportSender.h"
  

  and let your appDelegate implement the protocol CrashReportSenderDelegate

• In your appDelegate applicationDidFinishLaunching function include

  [[CrashReportSender sharedCrashReportSender] sendCrashReportToURL:CRASH_REPORTER_URL delegate:self activateFeedback:NO];
  

  where CRASH_REPORTER_URL points to your crash_v200.php URL

• Done.

• When testing the connection and a server side error appears after sending a crash log, the error code is printed in the console. Error code values are listed in CrashReportSender.h

• Include CrashReporterSender.framework into your project

• In your appDelegate.m include

  #import "CrashReportSender.h"
  

• In your appDelegate change the invocation of the main window to the following structure

  // this delegate method is required

  • (void) showMainApplicationWindow { // launch the main app window // remember not to automatically show the main window if using NIBs [window makeFirstResponder: nil]; [window makeKeyAndOrderFront:nil]; }

  • (void)applicationDidFinishLaunching:(NSNotification *)note { // Launch the crash reporter task [[CrashReportSender sharedCrashReportSender] sendCrashReportToURL:CRASH_REPORTER_URL delegate:self companyName:COMPANY_NAME]; }

• Done.

Feel free to add enhancements, fixes, changes and provide them back to the community!

Thanks Andreas Linde http://www.andreaslinde.com/ http://www.buzzworks.de/