Q: Terra IOS background delivery is not syncing

ProposedCatfish1 month ago

Hi there. I was able to successfully implement Terra's background delivery for iOS in swift: I added the line Terra.setUpBackgroundDelivery() to the AppDelegate file as indicated on the API reference. It seems that background delivery only fires when the app is open. Tested on iOS version 17.3 and TerraiOS version 1.6. How can I troubleshoot this issue??

terra

Alexadmin1 month ago

Hey there

Have you completed the following steps:

  1. Add the Background Modes capability and enable Background Processing and Background fetch. This can be done by opening your .xcodeproj file in XCode, navigating to Signing & Capabilities and pressing + Capability
  2. Add the HealthKit capability and enable Background delivery
  3. Add the terra Background task identifier: navigate to your .xcodeproj > Info and create/edit the list Permitted background task scheduler identifiers and add the element co.tryterra.data.post.request
  4. In the same tab, the key Privacy - Health Share Usage Description should be created with the value being a description of your use case (which must be > 2 words)

ProposedCatfish1 month ago

Hey, thanks for the response, but all those steps have been completed. I also updated the background modes capability to have background fetch enabled but still nothing. What else can I do. Just to provide more detail, the setup works until the app is closed on my phone - even after several hours no events come through.


terra

Alexadmin1 month ago

On your mobile device, have you enabled background app refresh. This can be done by navigating to Settings > General > Background App refresh and ensuring Background App refresh is on and scrolling to your app to check that it is enabled for you. Also, background sync is disabled when the user's device is on Low power mode


ProposedCatfish1 month ago

Hey again. That seems to have fixed it. Background app refresh was not enabled for my app. Is there any way to get around the low power mode issue?


terra

Alexadmin1 month ago

Unfortunately, the Low power mode restriction is enforced by iOS and affects all apps that require background refresh