# BITCrashManagerDelegate Protocol Reference

Conforms to | NSObject
Declared in | BITCrashManagerDelegate.h

## Overview

The `BITCrashManagerDelegate` formal protocol defines methods further configuring the behaviour of `BITCrashManager`.

## Tasks

### Additional meta data

- `– applicationLogForCrashManager:`
- `– userNameForCrashManager:`
- `– userEmailForCrashManager:`

### Alert

- `– crashManagerWillShowSubmitCrashReportAlert:`
- `– crashManagerWillCancelSendingCrashReport:`
- `– crashManagerWillSendCrashReportsAlways:`

### Networking

- `– crashManagerWillSendCrashReport:`
- `– crashManager:didFailWithError:`
- `– crashManagerDidFinishSendingCrashReport:`

## Instance Methods

### applicationLogForCrashManager:

Return any log string based data the crash report being processed should contain

`- (NSString *)applicationLogForCrashManager:(BITCrashManager *)crashManager`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

#### See Also

- `

  - userNameForCrashManager:

  `
- `

  - userEmailForCrashManager:

  `

#### Declared In

`BITCrashManagerDelegate.h`

### crashManager:didFailWithError:

Invoked after sending crash reports failed

`- (void)crashManager:(BITCrashManager *)crashManager didFailWithError:(NSError *)error`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

error

  The error returned from the NSURLConnection call or `kBITCrashErrorDomain` with reason of type `BITCrashErrorReason`.

#### Declared In

`BITCrashManagerDelegate.h`

### crashManagerDidFinishSendingCrashReport:

Invoked after sending crash reports succeeded

`- (void)crashManagerDidFinishSendingCrashReport:(BITCrashManager *)crashManager`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

#### Declared In

`BITCrashManagerDelegate.h`

### crashManagerWillCancelSendingCrashReport:

Invoked after the user did choose NOT to send a crash in the alert

`- (void)crashManagerWillCancelSendingCrashReport:(BITCrashManager *)crashManager`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

#### Declared In

`BITCrashManagerDelegate.h`

### crashManagerWillSendCrashReport:

Invoked right before sending crash reports will start

`- (void)crashManagerWillSendCrashReport:(BITCrashManager *)crashManager`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

#### Declared In

`BITCrashManagerDelegate.h`

### crashManagerWillSendCrashReportsAlways:

Invoked after the user did choose to send crashes always in the alert

`- (void)crashManagerWillSendCrashReportsAlways:(BITCrashManager *)crashManager`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

#### Declared In

`BITCrashManagerDelegate.h`

### crashManagerWillShowSubmitCrashReportAlert:

Invoked before the user is asked to send a crash report, so you can do additional actions. E.g. to make sure not to ask the user for an app rating :)

`- (void)crashManagerWillShowSubmitCrashReportAlert:(BITCrashManager *)crashManager`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

#### Declared In

`BITCrashManagerDelegate.h`

### userEmailForCrashManager:

Return the users email address that should be send along each crash report (Deprecated: Please use `BITHockeyManagerDelegate userEmailForHockeyManager:componentManager:` instead)

`- (NSString *)userEmailForCrashManager:(BITCrashManager *)crashManager`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

#### Discussion

Warning: When returning a non nil value, crash reports are not anonymous any more and the alerts will not show the “anonymous” word!

#### See Also

- `

  - applicationLogForCrashManager:

  `
- `

  - userNameForCrashManager:

  `

#### Declared In

`BITCrashManagerDelegate.h`

### userNameForCrashManager:

Return the user name or userid that should be send along each crash report (Deprecated: Please use `BITHockeyManagerDelegate userNameForHockeyManager:componentManager:` instead)

`- (NSString *)userNameForCrashManager:(BITCrashManager *)crashManager`

#### Parameters

crashManager

  The `BITCrashManager` instance invoking this delegate

#### Discussion

Warning: When returning a non nil value, crash reports are not anonymous any more and the alerts will not show the “anonymous” word!

#### See Also

- `

  - applicationLogForCrashManager:

  `
- `

  - userEmailForCrashManager:

  `

#### Declared In

`BITCrashManagerDelegate.h`