This is a Swift wrapper for the Strava v3 API.
As this is a passion project, I only work on it when I have time. So, if you are interested in contributing, feel free to submit PRs.
To run the example project, clone the repo, and run pod install
from the Example directory first.
StravaSwift is available through the Swift Package Manager and CocoaPods.
dependencies: [
.package(url: "https://github.com/mpclarkson/StravaSwift.git", from: "1.0.1")
]
To install it, simply add the following line to your Podfile:
pod "StravaSwift", '~> 1.0.1'
The full library documentation is available here.
-
First, you must register your app with Strava and get an OAuth
client id
andclient secret
. -
Initialize the Strava Client as follows, preferably in your
AppDelegate.swift
to ensure it is configured before you call it:
let config = StravaConfig(
clientId: YourStravaClientId,
clientSecret: YourStravaClientSecret,
redirectUri: YourRedirectUrl
)
StravaClient.sharedInstance.initWithConfig(config)
-
Note, by default the OAuth token is only available while the app is running, which means you need to request a new token. You can implement custom token storage and retrieval behaviour by overriding the default token
delegate
in theStravaConfig
initializer which must implement theTokenDelegate
protocol. -
Register your redirect URL scheme in your
info.plist
file. -
The authentication will use the Strava app be default if it is installed on the device. If the user does not have Strava installed, it will fallback on
SFAuthenticationSession
orASWebAuthenticationSession
depending on the iOS version. If your app is linked on or after iOS 9.0, you must addstrava
in you app’sinfo.plist
file. It should be added as an entry fo the array under theLSApplicationQueriesSchemes
key. Failure to do this will result in a crash when callingcanOpenUrl:
.
<key>LSApplicationQueriesSchemes</key>
<array>
<string>strava</string>
</array>
- Implement the following method in your
AppDelegate.swift
to handle the OAuth redirection from Strava:
let strava = StravaClient.sharedInstance
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
return strava.handleAuthorizationRedirect(url)
}
- After authorizing, you can start requesting resources:
strava.authorize() { result in
switch result {
case .success(let token):
//do something for success
case .failure(let error):
//do something for error
}
}
- Requesting resources:
The Router implementation is based on this Alamofire example:
strava.request(Router.athletes(id: 9999999999)) { (athlete: Athlete?) in
//do something with the athlete
}
let params = [
'page' = 2,
'per_page' = 25
]
strava.request(Router.athleteActivities(params: params) { (activities: [Activity]?) in
//do something with the activities
}
- 100% API coverage (about 90% now)
- Documentation
- Tests
- Better example app
Matthew Clarkson, [email protected]
StravaSwift is available under the MIT license. See the LICENSE file for more info.