strava_client

Description:

strava client

gir# strava_flutter
Dart/flutter package to use Strava API v3
Follow the "new" Authentication process
https://developers.strava.com/docs/authentication/
##Warning: This package is under heavy refactoring, there might be breaking changes in the following updates.
API currently supported: #
Authentication #

authorize
deauthorize

Athlete related APIs #

getLoggedInAthlete
updateLoggedInAthlete (scope profile:write)
getLoggedInAthleteActivities (not limited)
getLoggedInAthleteZones
getGearById
getStats

Club related APIs #

getClubById
getClubActivitiesById
getClubMembersById

Race related APIs #

getRunningRaces
getRunningRaceById

Activity related APIs #

createActivity
uploadActivity (includes getUploadById)
Tested on TCX and GPX

To generate TCX you can use the following package
https://pub.dev/packages/rw_tcx
Segments related APIs #

getSegmentById
getLoggedInAthleteStarredSegments
getLeaderboardBySegmentId (not limited)
starSegment

How to install #
Check on pub.dev/packages to see how to install this package
https://pub.dev/packages/strava_flutter#-installing-tab-
Additional steps when running on Android Pie 9.0 (API level 28) #
The webview returned by the auth process may throw net::ERR_CLEARTEXT_NOT_PERMITTED. In this case add android:usersCleartextTraffic="true" to the AndroidManifest.xml like below:
<application
....
android:usesCleartextTraffic="true"
....>
copied to clipboard
How to use it #
1 -Get the client secret in your Strava settings related to your app https://www.strava.com/settings/api with "Authorization Callback Domain" set to "redirect"
2 - Settings of the url scheme for Strava Authentication redirect url
a) For Android
Add the following lines in your AndroidManifest.xml (in android/app/src/)
<!-- To get redirect url when using url_launcher -->
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="stravaflutter" android:host="redirect" />
</intent-filter>
copied to clipboard
Change android:launchMode="singleTop" to android:launchMode="singleInstance"
It is needed to have authentication working with firefox
b) for iOS
Add the following lines in your info.plist (in ios/Flutter/Runner/)
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLName</key>
<string>stravaflutter</string>
<key>CFBundleURLSchemes</key>
<array>
<string>stravaflutter</string>
</array>
</dict>
</array>
copied to clipboard
Also for launching the Native Strava app for Authenticate
<key>LSApplicationQueriesSchemes</key>
<array>
<string>strava</string>
</array>
copied to clipboard
3 - Create a file secret.dart and put in this file:
final String secret = "[Your client secret]";
final String clientId = "[Your appID]";
4 - import 'secret.dart' when you need secret and clientId in Strava API
5 - To see debug info in Strava API, set isInDebug to true in Strava() init
6 - Please check examples.dart for the moment
https://github.com/BirdyF/strava_flutter/blob/master/example/lib/main.dart
https://github.com/BirdyF/strava_flutter/blob/master/example/lib/examples.dart
If you have any problem or need an API not yet implemented please post a new issue
Tested on: #

Android 7, 8.0.0, 9.0, 10
iOS 12.1, 13.2, 13.3.1
NOT working yet on web (Auth problem, not coming back to initial page)

Contributors welcome! #
If you spot a problem/bug or if you consider that the code could be better please post an issue.
I am not planning to implement all the Strava APIs, because I dont need all of them in my dev.
But let me know if you need some APIs that are not in the current list and I will add it.
Alternatively, you can easily implement additional API and I will add it to strava_futter.
Thanks #

Thanks to @Birdyf for developing this package at first place.
Thanks to Joe Birch, I used his code to better understand Oauth process https://github.com/hitherejoe/FlutterOAuth
Javier for https://javiercbk.github.io/json_to_dart/

License: #
strava_flutter is provided under a MIT License. Copyright (c) 2019-2020 Patrick FINKELSTEIN