Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jorgefspereira/persona_flutter

Persona Inquiry for Flutter. Integrates the native iOS, Android SDKs.
https://github.com/jorgefspereira/persona_flutter

android dart flutter ios persona persona-inquiry

Last synced: about 2 months ago
JSON representation

Persona Inquiry for Flutter. Integrates the native iOS, Android SDKs.

Host: GitHub
URL: https://github.com/jorgefspereira/persona_flutter
Owner: jorgefspereira
License: mit
Created: 2020-06-28T20:19:00.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-08-25T18:11:54.000Z (4 months ago)
Last Synced: 2024-08-26T19:25:27.839Z (4 months ago)
Topics: android, dart, flutter, ios, persona, persona-inquiry
Language: Dart
Homepage: https://pub.dev/packages/persona_flutter
Size: 472 KB
Stars: 11
Watchers: 2
Forks: 25
Open Issues: 4
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# Persona Inquiry for Flutter

[![pub](https://img.shields.io/pub/v/persona_flutter.svg)](https://pub.dev/packages/persona_flutter)
[![points](https://img.shields.io/pub/points/persona_flutter)](https://pub.dev/packages/persona_flutter)
[![popularity](https://img.shields.io/pub/popularity/persona_flutter)](https://pub.dev/packages/persona_flutter)
[![likes](https://img.shields.io/pub/likes/persona_flutter)](https://pub.dev/packages/persona_flutter)
[![donate](https://img.shields.io/badge/Buy%20me%20a%20beer-orange.svg)](https://www.buymeacoffee.com/jpereira)

Native implementation of the [Persona Inquiry flow](https://docs.withpersona.com/docs) for Flutter.

This plugin integrates the native v2 SDKs:

- [Persona iOS v2 SDK](https://docs.withpersona.com/docs/android-sdk-v2-integration-guide)
- [Persona Android v2 SDK](https://docs.withpersona.com/docs/ios-sdk-v2-integration-guide)

Feel free to leave any feedback [here](https://github.com/jorgefspereira/persona_flutter/issues).

*Important: Persona stopped support for **v1** on December 31, 2022. If you need the older mobile integration, check the version **2.1.5** of this plugin or **v1** branch of this repository.*

## Installation

Add `persona_flutter` as a [dependency in your pubspec.yaml file](https://flutter.io/platform-plugins/).

## iOS

#### Requirements

- iOS 13.0 or later is required.
- Update your `ios/Runner/Info.plist`:

```xml
NSCameraUsageDescription
This app requires access to the camera.
NSPhotoLibraryUsageDescription
This app requires access to the photo library.
```

- **Optionally** if you need support for video, NFC verifications or GPS collections, add to your `ios/Runner/Info.plist`:

```xml
NSMicrophoneUsageDescription
This app requires access to the microphone.
NFCReaderUsageDescription
This app requires access to the NFC.
NSLocationWhenInUseUsageDescription
This app requires access to the Location when in use.
```

Note: Cocoapods 1.9.3 has a bug that prevents builds from selecting the correct architecture. See more details [here.](https://github.com/CocoaPods/CocoaPods/pull/9790) Please downgrade to 1.8.x or upgrade to 1.10.x

#### Privacy

The Persona SDK collects a user’s IDFV for fraud prevention purposes. In App Store Connect > Your App > App Privacy, if you haven’t already add in a “Device Identifier,” and fill out the questionnaire with the following answers:
- Usage: App Functionality (covers fraud prevention)
- Are the device IDs collected from this app linked to the user’s identity? Yes
- Do you or your third-party partners use device IDs for tracking purposes? No

Be sure to also update your privacy manifest according to the features you are making use of from the SDK. See our iOS [Privacy Manifest instructions](https://docs.withpersona.com/docs/ios-privacy-manifest) for more information.

## Android

#### Requirements

- Change the `minSdkVersion` to 21 (or higher) in your `android/app/build.gradle` file.

- Declare the following permissions:

```xml

```

#### Privacy

This SDK collects a user’s [App-Set ID](https://developer.android.com/training/articles/app-set-id) for Fraud Prevention purposes. When publishing to the Play Store, disclose the usage of Device Identifiers as follows:
- Data Types: Device or other IDs
- Collected: Yes
- Shared: No
- Processed Ephemerally: No
- Required or Optional: Required
- Purposes: Fraud Prevention

#### Theming

Using the `styles.xml` of your app, you can set colors, buttons and more to customize the Persona flow to your own style. Just extend the base Persona style `Base.Persona.Inquiry.Theme` and name it `Persona.Inquiry.Theme`.

```xml

```

and in your `InquiryConfiguration` set the theme:

```dart
...
theme: InquiryTheme(source: InquiryThemeSource.client)
...
```

*__Important:__ Client side theming is __deprecated__. Themes can be managed in the Dashboard with Persona's visual editor. See the detailed [tutorial](https://help.withpersona.com/articles/6SIHupp847yaEuVMucKAff/tutorial-configure-a-theme-with-flow-editor/) for more information.*