Adding the framework

When using the APIs provided by App Shielding, the header files and library must be available during compilation.

When the Shielding Tool runs in a build phase of Xcode (see Integration into Xcode), it needs some knowledge about how Xcode processes the ShieldSDK framework. Both of these things are most easily achieved by adding the ShieldSDK framework to the project.

The instructions in this topic describe the process for Xcode 14.2. For other versions of Xcode, the steps can be different.

1. In the project navigator, select the project with which you want to use App Shielding.

2. In the editor view, select the target with which you want to use App Shielding.

3. Select the General tab.

4. Drag and drop ShieldSDK.xcframework from the App Shielding package into the Frameworks, Libraries and Embedded Content item.

5. Verify that Embed&Sign is selected in the drop-down list for ShieldSDK.xcframework.

6. If you are using Integration into Xcode, make sure the Embed Frameworks phase is listed before the Run Script phase that runs the Shielding Tool. (This is in the Build Phases tab, rather than the General tab. The phases can be reordered by dragging them.)

   If you add the ShieldSDK.xcframework bundle to your project, you must run the Shielding Tool on the app before distributing it. Otherwise, validation will fail with aMinimumOSVersion error. This is an intentional safeguard against accidentally distributing an unprotected app.