acra icon indicating copy to clipboard operation
acra copied to clipboard

Add a note about `ReportSenderException`

Open GregCornis opened this issue 1 year ago • 2 comments

acra-http throws a ReportSenderException if it fails to send the report, so I imagine it's a mechanism to allow for a later retry. ACRA's message is pretty clear: org.acra.sender.ReportSenderException: Policy marked this task as incomplete. ACRA will try to send this report again.

I thought it would be nice to document it. It might need to be rephrased.

GregCornis avatar Jun 25 '24 09:06 GregCornis

Depending on the RetryPolicy, the sentence you added might not be true. Default behaviour is to only retry when all senders failed. Of course most setups will only use one sender and the default policy, in which case your statement is true.

F43nd1r avatar Jun 25 '24 13:06 F43nd1r

How about

You can implement your own ReportSender and configure ACRA to use that instead of or in addition to other senders. Note: Throwing a ReportSenderException from YourCustomSender.send() notifies ACRA of a failed delivery, and might trigger a retry (see RetryPolicy).

GregCornis avatar Jun 25 '24 14:06 GregCornis