✨ Handy helpers for reading values from an applications embedded provision profile.

Embedded provision profiles can answer many questions about where and how an iOS or macOS application is running, like:

• Is this app deployed to the AppStore or distributed internally?
• Which push notification environment is the application signed for?
• What's the Apple developer team ID that was used to sign the app?

... and more!

You can take a look at the provided example project, or simply play with yourself.

import EmbeddedProvision

do {
  if let provision = try EmbeddedProvision.load() {
    print("Your app was signed with \(provision.name).")
  } else {
    print("Your app is likely running in a Simulator right now.")
  }
}
catch EmbeddedProvisionError.decodingError {
  fatalError("Decoding errors should not happen. Please file an issue.")
}
catch {
  fatalError("Generally errors are very unexpected, and so is this: \(error) ")
}

• Quick Start
• Table of Contents
• API
  • Properties
  • Entitlements
• Installation
  • CocoaPods
  • Swift Package Manager
  • Carthage
• FAQ
  • What is an embedded provision profiles?
  • Why is there no provision profile embedded in my app?
  • Does this library support macOS?
• Contributing

You can load your applications embedded provisioning profile by using EmbeddedProvision.load(). This will look for the profile inside your apps bundle under embedded.mobileprovision (on iOS) or Contents/embedded.provisionprofile (on macOS).

Once you have an instance of EmbeddedProvision at hand you have access to the following properties that are more about describing the profile itself:

Apple supports a lot of different entitlements. This library is at the moment only decoding a minimum of them. If you need any other entitlement, please add it and open a PR.

To install MagicBell using CocoaPods, add this entry to your Podfile:

pod 'EmbeddedProvision', '>=1.0.0'

IMPORTANT: Make sure you specify use_frameworks! in your Podfile.

Then, run pod install.

To install the library using Swift Package Manager, just add the dependency as follows to your project:

dependencies: [
    .package(url: "https://github.com/magicbell/embedded-provision", .upToNextMajor(from: "1.0.0"))
]

To install the library using Carthage, add the following dependency to the Carfile :

github "magicbell/embedded-provision" "1.0.0"

Then, run carthage update --use-xcframeworks --platform [iOS|macOS] --no-use-binaries (selecting the desired platform) to resolve dependencies.

Add the EmbeddedProvision.xcframework to your project-linked frameworks, together with the other dependencies resolved by Carthage.

I short, they are Apples way to allow your app to run on their platforms. They are a codesigned definition of where you're app can run, what it can do. But nobody explains it better than Applie itself in TN3125 - Provisioning profile fundamentals.

If the app is not signed to run on a device, there won't be a profile. This typically happens when the app is running in a Simulator.

It should! It wasn't extensively tested though. Please file an issue if you run into any problems.

Contributions of any kind are welcome.