teamsnap-SDK-iOS

TeamSnap iOS SDK For information on the TeamSnap API, and to get client tokens for your application check out developer.teamsnap.com.

Installing as a Framework

Drag the framework into your frameworks group, and copy files. make sure it appears under your {target_name}->Build Phases->Link Binary With Libraries (happens automatically) AND {target_name}->General->Embedded Binaries (Does not happen automatically)

Installation with CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries in your projects. See the Get Started section for more details.

Podfile

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '10.0'

target 'Teamsnap' do
pod 'TeamSnapSDK', :git => 'git@github.com:teamsnap/teamsnap-SDK-iOS.git', :branch => 'master'
end

If you are using Swift, be sure to add use_frameworks! and set your target to iOS 8+:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '10.0'
use_frameworks!

target 'Teamsnap' do
pod 'TeamSnapSDK', :git => 'git@github.com:teamsnap/teamsnap-SDK-iOS.git', :branch => 'master'
end

Now run pod install

Setup

In order to use the TeamSnapSDK, you will need to obtain a client ID and client secret for your specific application. You can create new applications and obtain these from auth.teamsnap.com.

Before using the TeamSnapSDK, you need to configure TSDKTeamSnap with your new credentials:

Objective-C

[[TSDKTeamSnap sharedInstance] setClientId:myClientID];
[[TSDKTeamSnap sharedInstance] setClientSecret:myClientSecret];

Swift

TSDKTeamSnap.sharedInstance.clientId = myClientID
TSDKTeamSnap.sharedInstance.clientSecret = myClientSecret

Usage

To use:

Objective-C

#import <TeamSnapSDK/TeamSnapSDK.h>

Swift

import TeamSnapSDK

Sample Code:

From a viewController

SFSafariViewController *safariViewController = [[TSDKTeamSnap sharedInstance] presentLoginInViewController:self animated:YES clientId:@"XXXXXXXXXXXXXXXXXX" scope:@"read+write" redirectURL:@"customURL://" completion:^{
    NSLog(@"VC Presented");
}];

in your applicationDelegate:

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options {
    if ([[TSDKTeamSnap sharedInstance] processLoginCallback:url completion:^(bool success, NSString *message) {
        if (success) {
            NSLog(@"Logged in %@", [[[TSDKTeamSnap sharedInstance] teamSnapUser] firstName]);
        } else {
            NSLog(@"Login Failed");
        }
    }]) {
        return YES;
    } else {
        NSLog(@"Not Processed");
        return NO;
    }
}

in your info.plist: Add a URL type with a URL scheme that matches your callback URL from Above

	<key>CFBundleURLTypes</key>
	<array>
		<dict>
			<key>CFBundleURLName</key>
			<string>com.example.playerlineup</string>
			<key>CFBundleURLSchemes</key>
			<array>
				<string>customURL</string>
			</array>
		</dict>
	</array>

Errors -

dyld: Library not loaded: @rpath/TeamSnapSDK.framework/TeamSnapSDK
Referenced from: /Users/jason/Library/Developer/CoreSimulator/Devices/CFB23620-9332-47B8-A806-C87C6647E87A/data/Containers/Bundle/Application/93B2FD30-F7BD-42DB-BCEC-C9F2D21B6CEE/scoreboad.app/scoreboad
Reason: image not found

You forgot to embed the binary: target->General->Embedded Binaries (Does not happen automatically)

Building iOS TeamSnapSDK

Build for simulator. The universal binary will be located somewhere like:

~/Library/Developer/Xcode/DerivedData/TeamSnapSDK-bpyoduzxeamidfebntrjxkbbwxwq/Build/Products/Debug-universal/TeamSnapSDK.framework

That is what should be distributed/linked

tvOS - TeamSnapSDKTV

Build for the tvOS simulator. The universal binary will be located somewhere like:

~/Library/Developer/Xcode/DerivedData/TeamSnapSDKTV-bpyoduzxeamidfebntrjxkbbwxwq/Build/Products/Debug-TVuniversal/TeamSnapSDKTV.framework