iOS 10 Debugging: Push Notifications Not Registering

iOS 10 and Xcode 8 introduced a number of changes to iOS push notifications. This document describes one issue that may arise because of changes to the aps-environment entitlement.

#aps-environment entitlement

If you upgrade to iOS 10 and Xcode 8 and push notifications don't work, check to see if there are errors from didFailToRegisterForRemoteNotificationsWithError. If you get the following error on iOS 10 but not iOS 9, you will need to enable push entitlements locally:

fail to register with error Error Domain=NSCocoaErrorDomain Code=3000 "no valid 'aps-environment' entitlement string found for application" UserInfo={NSLocalizedDescription=no valid 'aps-environment' entitlement string found for application}

With Xcode 8, the entitlements are set from your local entitlements file, rather than from the provisioning profile you created on the Apple Developer Portal. The entitlements will now need to be added to your Xcode build under Capabilities, in addition to in your provisioning profile.