Adding the FullStory Framework Manually

FullStory for Mobile Apps is available as an add-on for FullStory Business and Enterprise plans. As a result, this add-on is not available on FullStory Free or the FullStory Business trial. Please contact your Account Executive or reach out to our Support team here to learn more.

About this article

This article provides setup steps for adding the Fullstory dylib to your Xcode project directly. 

Manual Installation: adding the FullStory framework

Follow these steps to directly integrate the FullStory framework with your app.

  • Download & Extract FullStory
  • Add FullStory.xcframework in your app’s embedded frameworks
    • In the project navigator, select your app’s project
    • In the editor panel, select your app’s target
    • Choose the General tab
    • Under Frameworks, Libraries, and Embedded Content, click the + button
    • Under Add Other, choose Add Files…
    • Navigate to where you extracted FullStory and select FullStory.xcframework.  Click Open
    • In the Embed column, make sure that “Embed & Sign” is selected for FullStory.xcframework
  • Add a build phase for FullStory’s asset uploader
    • In the project navigator, select your app’s project
    • In the editor panel, select your app’s target
    • Choose the Build Phases tab
    • Choose Editor > Add Build Phase > Add Run Script Build Phase
    • On the new “Run Script” phase, double-click on the “Run Script” label and rename to “Run FullStory Asset Uploader”
    • If it’s not already, re-order the build phase so it’s the last step
    • Click the disclosure triangle next to the build phase to expand it
    • Replace the body of the script with the following line, replacing “path/to/FullStory” with the appropriate path:
      path/to/FullStory/tools/FullStoryCommandLine \
      "${CONFIGURATION_BUILD_DIR}/${WRAPPER_NAME}"

Next Steps

After you’ve completed this setup, return to Getting Started with iOS Recording to configure FullStory, review advanced features, and more.

Need to get in touch with us?

The FullStory Team awaits your every question.

Contact us