https://github.com/mathieujobin/monalisa_client

Small library to authenticate your Flutter up with Monalisa API/SSO
https://github.com/mathieujobin/monalisa_client

Last synced: 11 days ago
JSON representation

Small library to authenticate your Flutter up with Monalisa API/SSO

• Host: GitHub
• URL: https://github.com/mathieujobin/monalisa_client
• Owner: mathieujobin
• License: mit
• Created: 2019-06-05T04:38:41.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-04-28T07:49:35.000Z (over 4 years ago)
• Last Synced: 2024-10-11T22:48:41.024Z (about 1 month ago)
• Language: Dart
• Size: 79.1 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# monalisa_client

Small library to authenticate your Flutter up with Monalisa API/SSO

## Add to your project

in your pubspec.yaml file

```yaml

dependencies:

  flutter:

    sdk: flutter

  monalisa_client:

    git:

      url: https://github.com/mathieujobin/monalisa_client.git

assets:

  - assets/monalisa_config.json

```

## Create and save your app token

Visit https://monalisa.solidcode.bz/app

## Create Config file

```json

{

  "base_url": "https://monalisa.solidcode.bz",

  "environment": "production",

  "client_application_name": "rockpaperscissors",

  "client_application_secret": "1234"

}

```

## Basic usage

```dart

import 'package:monalisa_client/monalisa_client.dart';

final MonalisaClient monalisa_client = MonalisaClient();

  @override

  void initState() {

    super.initState();

    monalisa_client.read_local_config().then((data) {

      return monalisa_client.ensure_user_token();

    }).then((data) {

      setState(() {

        // to access the install-unique user_uuid

        if (monalisa_client.user_uuid == null) {

          throw Exception("user_uuid is missing");

        }

        _user_logged_in = true;

      });

    }).catchError((SocketException) => setStateNoInternet());

  }

```

## Troubleshooting

### Minimum SDK version

Because this tool depends on flutter_secure_storage and flutter apps still allow minSdk 16, you might need to upgrade your build.gradle file for Android

The error looks like this

```

/home/mathieu/projects/cyrus-kl/tasselvr-app/android/app/src/main/AndroidManifest.xml Error:

	uses-sdk:minSdkVersion 16 cannot be smaller than version 18 declared in library [:flutter_secure_storage] /home/mathieu/projects/cyrus-kl/tasselvr-app/build/flutter_secure_storage/intermediates/manifests/full/debug/AndroidManifest.xml as the library might be using APIs not available in 16

	Suggestion: use a compatible library with a minSdk of at most 16,

		or increase this project's minSdk version to at least 18,

		or use tools:overrideLibrary="com.it_nomads.fluttersecurestorage" to force usage (may lead to runtime failures)

```

Edit the `android/app/build.gradle` file, find the `minSdkVersion 16` under `defaultConfig`, and make it 18

## Dart/Flutter package resources

This project is a starting point for a Dart

[package](https://flutter.dev/developing-packages/),

a library module containing code that can be shared easily across

multiple Flutter or Dart projects.

For help getting started with Flutter, view our

[online documentation](https://flutter.dev/docs), which offers tutorials,

samples, guidance on mobile development, and a full API reference.