Skip to content

Latest commit

 

History

History
170 lines (149 loc) · 3.49 KB

integration.adoc

File metadata and controls

170 lines (149 loc) · 3.49 KB
Raw

SDK Manual Installation (iOS)

We highly recommend using the automatic buddybuild SDK integration right from the buddybuild dashboard.

However, if you wish to install the buddybuild SDK manually, follow the steps on this page.

Note

Use CocoaPods?

Include the BuddyBuildSDK pod in your Podfile and move on to Step 4

Manual integration steps

  1. Navigate to your repository root directory.

    cd myAwesomeApp

  2. Remove any previous version of the buddybuild SDK.

    rm -rf BuddyBuildSDK.framework*

  3. Download and unpack the buddybuild SDK.

    Download and unpack the BuddyBuildSDK.framework.zip file into your project root directory.

    wget https://s3-us-west-2.amazonaws.com/buddybuild-sdk-builds/master/BuddyBuildSDK.framework.zip
unzip BuddyBuildSDK.framework.zip
rm -f BuddyBuildSDK.framework.zip

  4. Add iOS frameworks

    1. Open your project in Xcode.

    2. Highlight your project in the Project Navigator.

    3. Select your target.

    4. Select the Build Phases tab.

    5. Open Link Binaries With Libraries expander.

    6. Repeat for each of the AssetsLibrary, BuddyBuildSDK, CoreTelephony, CoreText, CoreMedia, AVFoundation, CoreVideo, QuartzCore and SystemConfiguration frameworks:

      1. Click the + button.

      2. Select the required framework name.

      3. Click Add.

      The Project Navigator in Xcode

  5. Initialize the buddybuild SDK.

    1. Find the class that implements the UIApplicationDelegate. The class implementation should look something like this:

      Swift
      class AppDelegate: UIResponder, UIApplicationDelegate {
      Objective-C
      @interface AppDelegate : UIResponder <UIApplicationDelegate>

    2. Add this import to the top of the class implementation’s .m file:

      Swift
      import BuddyBuildSDK
      Objective-C
      #import &lt;BuddyBuildSDK/BuddyBuildSDK.h&gt;

    3. Initialize the BuddyBuildSDK in the class, by adding the following line to the didFinishLaunchingWithOptions method:

      Swift
      BuddyBuildSDK.setup()
      Objective-C
      [BuddyBuildSDK setup];

  6. Run your application in Xcode.

  7. Verify that the SDK is installed and working.

    In the Xcode output pane you should see the following log line, which indicates that the buddybuild SDK has been successfully integrated.

    When running on a physical device
    2015-10-05 15:34:48.693 myAwesomeApp[25126:526527] BuddybuildSDK : Successfully integrated. Feedback tool, crash reporting and other features are disabled for local builds. Please build with https://dashboard.buddybuild.com to enable.
    When running in a simulator
    2015-10-05 15:33:24.562 myAwesomeApp[25126:526527] BuddybuildSDK : Disabled in the simulator

  8. Commit the change and push to your repo.

    git add --all
git commit -m 'Adding buddybuild SDK'
git push

That’s it! Your code push will be picked up by buddybuild. Subsequent builds of your App will now have the SDK integrated!