mastodon_oauth2
Last updated:
0 purchases
Description:
mastodon oauth2
The Optimized and Easiest Way to Integrate OAuth 2.0 with Mastodon API in Flutter π―
1. Guide π
1.1. Getting Started β‘
1.1.1. Install Library
1.1.2. Import
1.1.3. Setup
1.1.3.1. Android
1.1.3.2. iOS
1.1.3.3. Web
1.1.4. Implementation
1.2. Contribution π
1.3. Contributors β¨
1.4. Support β€οΈ
1.5. License π
1.6. More Information π§
1. Guide π #
This library provides the easiest way to authenticate with OAuth 2.0 for Mastodon API in Flutter apps.
Show some β€οΈ and star the repo to support the project.
1.1. Getting Started β‘ #
1.1.1. Install Library #
flutter pub add mastodon_oauth2
copied to clipboard
1.1.2. Import #
import 'package:mastodon_oauth2/mastodon_oauth2.dart';
copied to clipboard
1.1.3. Setup #
1.1.3.1. Android
On Android you must first set the minSdkVersion in the build.gradle file:
defaultConfig {
...
minSdkVersion 18
...
copied to clipboard
Then, to test with this library, let's set org.example.oauth://callback/ as a callback URI in your developer page.
You can see developer page of mastodon in the link like below.
https://mastodon.instance/settings/applications
And then, specify your redirect uri like below.
Also it's necessary to add the following definitions to AndroidManifest.xml.
<activity android:name="com.linusu.flutter_web_auth_2.CallbackActivity" android:exported="true">
<intent-filter android:label="flutter_web_auth_2">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="org.example.oauth" android:host="callback" />
</intent-filter>
</activity>
copied to clipboard
Finally you need to set this redirect url for MastodonOAuth2Client.
final oauth2 = MastodonOAuth2Client(
// Specify mastodon instance like "mastodon.social"
instance: 'MASTODON_INSTANCE'
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET',
redirectUri: 'org.example.oauth://callback/',
customUriScheme: 'org.example.oauth',
);
copied to clipboard
You can see details here.
1.1.3.2. iOS
On iOS you need to set the platform in the ios/Podfile file:
platform :ios, '11.0'
copied to clipboard
The usage of MastodonOAuth2Client is the same as for Android above.
1.1.3.3. Web
For Web, the implementation method for using this package is the same as for Android and iOS above, but it's necessary to separately create HTML for the destination to be redirected to after authentication.
First, you will need to create the following HTML directly under your web folder in preparation for OAuth authentication in your web browser. Then, let's save this HTML file with the name auth.html.
<!DOCTYPE html>
<title>Authentication complete</title>
<p>
Authentication is complete. If this does not happen automatically, please
close the window.
<script>
window.opener.postMessage(window.location.href, window.location.origin);
window.close();
</script>
</p>
copied to clipboard
And now your web folder should look like this.
And then, unlike Android and iOS, the redirect URL should refer to this created auth.html. So, now let's set it to http://localhost:5555/auth.html for example.
Finally, you need to set this redirect url for MastodonOAuth2Client.
final oauth2 = MastodonOAuth2Client(
// Specify mastodon instance like "mastodon.social"
instance: 'MASTODON_INSTANCE'
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET',
redirectUri: 'http://localhost:5555/auth.html',
customUriScheme: 'http://localhost:5555/auth.html',
);
copied to clipboard
1.1.4. Implementation #
Now all that's left is to launch the following example Flutter app and press the button to start the authentication process with OAuth 2.0!
After pressing the Authorize button, a redirect will be performed and you will see that you have obtained your bearer token.
import 'package:flutter/material.dart';
import 'package:mastodon_oauth2/mastodon_oauth2.dart';
void main() {
runApp(const MaterialApp(home: Example()));
}
class Example extends StatefulWidget {
const Example({Key? key}) : super(key: key);
@override
State<Example> createState() => _ExampleState();
}
class _ExampleState extends State<Example> {
String? _accessToken;
String? _refreshToken;
@override
Widget build(BuildContext context) => Scaffold(
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
crossAxisAlignment: CrossAxisAlignment.center,
children: [
Text('Access Token: $_accessToken'),
ElevatedButton(
onPressed: () async {
final oauth2 = MastodonOAuth2Client(
// Specify mastodon instance like "mastodon.social"
instance: 'MASTODON_INSTANCE'
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET',
// Replace redirect url as you need.
redirectUri: 'org.example.oauth://callback/',
customUriScheme: 'org.example.oauth',
);
final response = await oauth2.executeAuthCodeFlow(
scopes: [
Scope.read,
Scope.write,
],
);
super.setState(() {
_accessToken = response.accessToken;
});
},
child: const Text('Push!'),
)
],
),
),
);
}
copied to clipboard
1.2. Contribution π #
If you would like to contribute to mastodon-oauth2, please create an issue or create a Pull Request.
There are many ways to contribute to the OSS. For example, the following subjects can be considered:
There are scopes that are not implemented.
Documentation is outdated or incomplete.
Have a better way or idea to achieve the functionality.
etc...
You can see more details from resources below:
Contributor Covenant Code of Conduct
Contribution Guidelines
Style Guide
Or you can create a discussion if you like.
Feel free to join this development, diverse opinions make software better!
1.3. Contributors β¨ #
Thanks goes to these wonderful people (emoji key):
Shinya Kato / ε θ€ ηδΉπ» π π¨ π‘ π§ β οΈ β
Mark O'Sullivanπ€
Abraham Williamsπ» π β οΈ
YeongJunπ π€
This project follows the all-contributors specification. Contributions of any kind welcome!
1.4. Support β€οΈ #
The simplest way to show us your support is by giving the project a star at GitHub and Pub.dev.
You can also support this project by becoming a sponsor on GitHub:
1.5. License π #
All resources of mastodon_oauth2 is provided under the BSD-3 license.
Copyright 2022 Kato Shinya. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided the conditions.
copied to clipboard
Note
License notices in the source are strictly validated based on .github/header-checker-lint.yml. Please check header-checker-lint.yml for the permitted standards.
1.6. More Information π§ #
mastodon_oauth2 was designed and implemented by Kato Shinya (@myConsciousness).
Creator Profile
License
API Document
Release Note
Bug Report
License:
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
Files In This Product:
Customer Reviews
There are no reviews.
