Particle Network Documentation
DashboardGithubDiscordTwitter
Search…
⌃K
Links

Flutter

1.Add the Auth Service SDK to Your Flutter App

Run this command:
With Flutter:
flutter pub add particle_auth
click here to get the demo source code

2.Configure Android project

open ${your flutter project} /android/app/build.gradle
2.1 add project config and update the minSdkVersion to 23
//Modify these configurations
defaultConfig {
// TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
applicationId "com.example.particle_auth_test"
// You can update the following values to match your application needs.
// For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-build-configuration.
minSdkVersion flutter.minSdkVersion
targetSdkVersion flutter.targetSdkVersion
versionCode flutterVersionCode.toInteger()
versionName flutterVersionName
}
​
//After modification：
defaultConfig {
// TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
applicationId "com.example.particle_auth_test"
// You can update the following values to match your application needs.
// For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-build-configuration.
minSdkVersion 23 // required by particle sdk
targetSdkVersion flutter.targetSdkVersion
versionCode flutterVersionCode.toInteger()
versionName flutterVersionName
​
//get from https://dashboard.particle.network/
manifestPlaceholders["PN_PROJECT_ID"] = "772f7499-1d2e-40f4-8e2c-7b6dd47db9de" //your project id
manifestPlaceholders["PN_PROJECT_CLIENT_KEY"] = "ctWeIc2UBA6sYTKJknT9cu9LBikF00fbk1vmQjsV" //your project client key
manifestPlaceholders["PN_APP_ID"] = "01a23ce8-d2e9-4b37-9eab-bf477279e53e" //your app id
}
2.2 update Java Version to 11 and add dataBinding config
//Modify these configurations
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
​
kotlinOptions {
jvmTarget = '1.8'
}
​
//After modification：
compileOptions {
sourceCompatibility JavaVersion.VERSION_11
targetCompatibility JavaVersion.VERSION_11
}
​
kotlinOptions {
jvmTarget = JavaVersion.VERSION_11
}
​
dataBinding {
enabled = true
}
Now,Android configuration is complete!

3.Configure iOS project

Prerequisites

  • Install the following:
    • Xcode 14.1 or later.
  • Make sure that your project meets the following requirements:
    • Your project must target these platform versions or later:
      • iOS 13
3.1 After export iOS project, open Runner.xcworkspace under ios folder.
​
​
3.2 Create a ParticleNetwork-Info.plist into the root of your Xcode project, and make sure the file is checked under Target Membership.
​
​
3.3 Copy the following text into this file:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>PROJECT_UUID</key>
<string>YOUR_PROJECT_UUID</string>
<key>PROJECT_CLIENT_KEY</key>
<string>YOUR_PROJECT_CLIENT_KEY</string>
<key>PROJECT_APP_UUID</key>
<string>YOUR_PROJECT_APP_UUID</string>
</dict>
</plist>
​
3.4 Replace YOUR_PROJECT_UUID, YOUR_PROJECT_CLIENT_KEY, and YOUR_PROJECT_APP_UUID with the new values created in your Dashboard
3.5. Import the ParticleAuthService module in your AppDelegate.swift file.
Swift
import ParticleAuthService
3.6. Add the scheme URL handle in your app's application(_:open:options:) method
Swift
override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
if ParticleAuthService.handleUrl(url) {
return true
} else {
return super.application(app, open: url, options: options)
}
}
3.7. Configure your app scheme URL, select your app from TARGETS, under Info section, click + to add the URL types, and paste your scheme in URL Schemes
Your scheme URL should be "pn" + your project app uuid.
For example, if your project app id is "63bfa427-cf5f-4742-9ff1-e8f5a1b9828f", your scheme URL is "pn63bfa427-cf5f-4742-9ff1-e8f5a1b9828f".
Config scheme url

Initialize the SDK

Before using the SDK, you have to call init(Required)
ParticleAuth.init(SolanaChain.devnet(), env);

Login

List<SupportAuthType> supportAuthType = <SupportAuthType>[];
supportAuthType.add(SupportAuthType.all);
String result =await ParticleAuth.login(LoginType.phone, "", supportAuthType);

Logout

String result = await ParticleAuth.logout();
debugPrint("logout: $result");

Fast logout

String result = await ParticleAuth.fastLogoudar();
debugPrint("logout: $result");

Get address

final address = await ParticleAuth.getAddress();
print("getAddress: $address");

Sign message

String result = await ParticleAuth.signMessage("Hello Particle");
debugPrint("signMessage: $result");

Sign transaction

ChainInfo currChainInfo = SolanaChain.devnet();
String? pubAddress = await ParticleAuth.getAddress();
if (currChainInfo is SolanaChain) {
if (pubAddress == null) return;
final trans = await TransactionMock.mockSolanaTransaction(pubAddress);
String result = await ParticleAuth.signTransaction(trans);
debugPrint("signTransaction: $result");
showToast("signTransaction: $result");
} else {
showToast('only solana chain support!');
}

Sign all transactions

ChainInfo currChainInfo = SolanaChain.devnet();
String? pubAddress = await ParticleAuth.getAddress();
if (currChainInfo is SolanaChain) {
if (pubAddress == null) return;
final trans1 = await TransactionMock.mockSolanaTransaction(pubAddress);
final trans2 = await TransactionMock.mockSolanaTransaction(pubAddress);
List<String> trans = <String>[];
trans.add(trans1);
trans.add(trans2);
String result = await ParticleAuth.signAllTransactions(trans);
debugPrint("signAllTransactions: $result");
showToast("signAllTransactions: $result");
} else {
showToast('only solana chain support!');
}

Sign and send transaction

ChainInfo currChainInfo = SolanaChain.devnet();
String? pubAddress = await ParticleAuth.getAddress();
if (currChainInfo is SolanaChain) {
final trans = await TransactionMock.mockSolanaTransaction(pubAddress);
String result = await ParticleAuth.signAndSendTransaction(trans);
debugPrint("signAndSendTransaction: $result");
showToast("signAndSendTransaction: $result");
} else {
final trans = await TransactionMock.mockEvmTransaction(pubAddress);
String result = await ParticleAuth.signAndSendTransaction(trans);
debugPrint("signAndSendTransaction: $result");
showToast("signAndSendTransaction: $result");
}

Sign typed data

You can get the demo source code from here​
ChainInfo currChainInfo = SolanaChain.devnet();
if (currChainInfo is SolanaChain) {
showToast("only evm chain support!");
return;
}
String typedData = '''[
{
"type":"string",
"name":"Message",
"value":"Hi, Alice!"
},
{
"type":"uint32",
"name":"A nunmber",
"value":"1337"
}
]''';
String result =
await ParticleAuth.signTypedData(typedData, SignTypedDataVersion.v1);
debugPrint("signTypedData: $result");

Set chain info async

bool isSuccess = await ParticleAuth.setChainInfoAsync(EthereumChain.goerli());
print("setChainInfoAsync: $isSuccess");

Set chain info sync

bool isSuccess = await ParticleAuth.setChainInfo(SolanaChain.devnet());
print("setChainInfoSync: $isSuccess");

Get chain info

String result = await ParticleAuth.getChainInfo();
print(result);
String chainName = jsonDecode(result)["chain_name"];
int chainId = jsonDecode(result)["chain_id"];
String chainIdName = jsonDecode(result)["chain_id_name"];

Set Security account config

static void setSecurityAccountConfig() {
final config = SecurityAccountConfig(true);
ParticleAuth.setSecurityAccountConfig(config);
}

Open account and security page

If user is expired, should return error, If user is expired, should return error, otherwise return nothing.
static void openAccountAndSecurity() async {
String result = await ParticleAuth.openAccountAndSecurity();
print(result);
}

Set iOS modal present style

static void setModalPresentStyle() {
ParticleAuth.setModalPresentStyle(IOSModalPresentStyle.fullScreen);
}

Set iOS medium screen

Set iOS medium screen, true is medium screen, false is large screen, default value if false.
Only support iOS 15 or higher.
If you want to set medium screen, don't call setModalPresentStyle with IOSModalPresentStyle.fullScreen
static void setMediumScreen() {
ParticleAuth.setMediumScreen(true);
}

Set language

static void setLanguage() {
const language = Language.ja;
ParticleAuth.setLanguage(language);
}

Set display wallet

static void setDisplayWallet() {
ParticleAuth.setDisplayWallet(true);
}

Open web wallet

static void openWebWallet() {
ParticleAuth.openWebWallet();
}
Previous
Unity
Next
React Native
Last modified 8d ago